Character Controller Library: prueba habilidades sin rehacer todo el movimiento

Beta anunciada el 10 de septiembre de 2026 · Investigación: 22 de octubre de 2026 (UTC). Fuentes: [anuncio oficial](https://devforum.roblox.com/t/studio-beta-expanding-the-character-controller-library-new-default-abilities-custom-abilities-api/4863739) y [documentación de CCL](https://create.roblox.com/docs/characters/character-controller-library). Redacción asistida por IA.

Respuesta rápida

La Character Controller Library (CCL) convierte acciones como correr, saltar, trepar y nadar en habilidades configurables. También permite registrar habilidades propias —por ejemplo dash, apuntar, bloquear o agacharse— con condiciones, entradas y callbacks. Sigue siendo una beta opcional: pruébala en una copia antes de sustituir el movimiento de un juego publicado.

Cómo activar la prueba

1. En Studio abre File → Beta Features y activa AvatarAbilities Character Controller Library.
2. Reinicia Studio si lo solicita.
3. Abre Avatar → Avatar Settings.
4. En Movement, cambia la sección Abilities a Character Controller Library.
5. Ejecuta un playtest con teclado, mando y controles táctiles que admita tu experiencia.

Qué puedes configurar

Cada habilidad predeterminada aparece como una configuración accesible durante la ejecución. Puedes cambiar atributos o controladores físicos y decidir qué capacidades siguen habilitadas. Para una acción personalizada, la API separa su identidad, la entrada que la inicia, las condiciones del mundo que la mantienen y los callbacks que aplican o retiran el efecto.

Un límite importante

No desactives Running salvo que realmente quieras impedir el desplazamiento por el suelo. Roblox también recomienda mantener Getting Up activo cuando Falling Down está habilitado; de lo contrario, un personaje puede caer sin recuperar la postura.

Cómo probar una habilidad propia

Empieza con una acción pequeña, como dash. Regístrala desde el servidor, asigna una entrada y una condición clara —por ejemplo estar en el suelo—, aplica el impulso al iniciar y añade un tiempo de enfriamiento. La documentación indica que los callbacks pueden ejecutarse en la simulación predicha del cliente y en el servidor autoritativo, así que su comportamiento debe ser determinista.

Errores comunes

No uses una tecla concreta como identidad lógica: CCL trabaja con acciones y slots de entrada que luego se vinculan a teclado, mando o tacto. Tampoco coloques la entrada dentro de RunsWhile; ese campo describe condiciones del mundo. En acciones Hold o Toggle, el modo de entrada controla cuándo terminan.

Comprobación

La prueba pasa cuando las habilidades predeterminadas conservan el movimiento esperado, la acción propia aparece en los dispositivos admitidos y cliente y servidor producen el mismo resultado. Conserva una versión anterior del controlador para volver atrás si la beta cambia.

Checklist: copia de prueba → beta activada → Avatar Settings → habilidades básicas comprobadas → acción pequeña registrada → teclado/mando/táctil revisados → comportamiento cliente-servidor comparado.