> For the complete documentation index, see [llms.txt](https://docs.allout.game/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.allout.game/all-out-docs/docs-es/viniendo-de-otras-herramientas/roblox.md).

# Roblox

Si has creado juegos en Roblox, hay algunas diferencias clave que necesitarás conocer para empezar en All Out.

Si vienes de Roblox Studio + Lua, esta página te ayudará a trasladar tu modelo mental a All Out + CSL (el lenguaje de scripting de All Out).

### Las grandes diferencias (de un vistazo)

* **Entidades + componentes (no instancias + servicios)**: los mundos se construyen a partir de entidades en la [Jerarquía](https://docs.allout.game/all-out-docs/docs-es/usar-el-editor/hierarchy.md), y el comportamiento proviene de añadir componentes (integrados o programados).
* **El multijugador está «integrado»**: CSL está diseñado para que la mayor parte del código de gameplay pueda escribirse como si fuera para un solo jugador mientras el motor sincroniza el estado relevante.
* **El flujo de trabajo del editor se parece más a la «edición de escenas»**: colocas entidades, ajustas sus componentes en el [Inspector](https://docs.allout.game/all-out-docs/docs-es/usar-el-editor/inspector.md), y reutilizas grupos mediante [Prefabs](https://docs.allout.game/all-out-docs/docs-es/usar-el-editor/prefabs.md).
* **CSL tiene tipado estático**: se parecerá más a Go/Odin que a Lua. (Ver [Primeros pasos con CSL](https://docs.allout.game/all-out-docs/docs-es/programacion/syntax.md).)
* **Las transformaciones de gameplay son 2D**: la posición y la escala usan `v2`, la rotación es un ángulo en grados y las capas de sprites controlan el orden de dibujo.

***

### Chuleta de Roblox → All Out

| Concepto de Roblox                        | Concepto de All Out / CSL                  | Notas                                                                                                                                                                                                                                                           |
| ----------------------------------------- | ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Roblox Studio**                         | **Editor de All Out**                      | Lo inicias desde el Creator Portal (ver [Iniciar el editor](https://docs.allout.game/all-out-docs/docs-es/primeros-pasos/first-game.md)).                                                                                                                       |
| **Place / Experience**                    | **Proyecto de juego de All Out**           | La carpeta local de tu proyecto incluye un `scripts` directorio para archivos `.csl` .                                                                                                                                                                          |
| **Explorer / Workspace**                  | **Jerarquía**                              | La jerarquía muestra todas las entidades del mundo/escena actual.                                                                                                                                                                                               |
| **Instancia / Modelo / Part**             | **Entidad**                                | La organización «tipo carpeta» se hace anidando entidades (ver «Folders» en [Jerarquía](https://docs.allout.game/all-out-docs/docs-es/usar-el-editor/hierarchy.md)).                                                                                            |
| **Ventana de propiedades**                | **Inspector**                              | Donde editas los campos de entidades/componentes y añades componentes.                                                                                                                                                                                          |
| **Atributos**                             | **Campos serializados de componentes**     | Expón campos al editor con `@ao_serialize` (ejemplo abajo).                                                                                                                                                                                                     |
| **CFrame / Vector3**                      | **Transformación de entidad 2D**           | La posición y la escala son `v2`; la rotación es un ángulo en grados.                                                                                                                                                                                           |
| **Clone()**                               | **`Scene.instantiate`**                    | Carga un `Prefab_Asset`, luego instáncialo en la escena.                                                                                                                                                                                                        |
| **Reutilización de modelos**              | **Prefabs**                                | Las instancias vinculadas conservan las propiedades raíz, pero los campos de los componentes no son anulaciones independientes (ver [Prefabs](https://docs.allout.game/all-out-docs/docs-es/usar-el-editor/prefabs.md)).                                        |
| **ProximityPrompt / ClickDetector**       | **Componente Interactable**                | Añade un componente derivado de `Interactable`e implementa `can_use`/`on_interact` (ver [Interactivos](https://docs.allout.game/all-out-docs/docs-es/conceptos-centrales-del-motor/interactables.md)).                                                          |
| **Touched / Region3 / GetPartsInPart**    | **Triggers / consultas de rango**          | Usa callbacks de trigger para el comportamiento de entrada/salida y `Scene.get_all_components_in_range` para detección amplia (ver [Navmesh y colisión](https://docs.allout.game/all-out-docs/docs-es/conceptos-centrales-del-motor/navmesh-and-collision.md)). |
| **Tools / habilidades / botones móviles** | **Habilidades**                            | UI de botones integrada, apta para móvil y PC, + patrones de tiempo de reutilización (ver [Habilidades](https://docs.allout.game/all-out-docs/docs-es/conceptos-centrales-del-motor/abilities.md)).                                                             |
| **DataStoreService**                      | **Sistemas de guardado + JSON + economía** | Ver [Sistema de guardado](https://docs.allout.game/all-out-docs/docs-es/datos-y-persistencia/save.md) y [Serialización JSON](https://docs.allout.game/all-out-docs/docs-es/datos-y-persistencia/json.md).                                                       |
| **ScreenGui / GuiObjects**                | **Sistema de UI de All Out**               | Ver [Fundamentos de la UI](https://docs.allout.game/all-out-docs/docs-es/ui/fundamentals.md).                                                                                                                                                                   |

***

### Tu primera hora (ruta recomendada)

1. Sigue el recorrido de «recolección de manzanas» en [Construir un juego básico](https://docs.allout.game/all-out-docs/docs-es/primeros-pasos/testing-and-publishing.md).
2. Repasa lo básico de CSL en [Primeros pasos con CSL](https://docs.allout.game/all-out-docs/docs-es/programacion/syntax.md) (especialmente `ao_start`, `ao_update`, y la creación de componentes).
3. Aprende a adjuntar tus nuevos componentes a objetos del mundo mediante el [Inspector](https://docs.allout.game/all-out-docs/docs-es/usar-el-editor/inspector.md).

***

### Modelo mental de scripting (Lua → CSL)

En Roblox a menudo escribes un `Script`/`LocalScript` que encuentra objetos (`Workspace.Foo.Bar`) y conecta eventos. En All Out, normalmente:

* Escribe **clases de componentes** en CSL (comportamiento).
* Adjúntalas a entidades en el editor (o crea entidades y añade componentes en tiempo de ejecución).
* Guarda valores ajustables en el componente con **`@ao_serialize`** (para que puedas ajustarlos por entidad en el inspector).

Aquí hay un pequeño ejemplo que se siente como «un Script anidado debajo de un objeto», pero expresado como un componente CSL:

```go
import "core:ao"

// Adjunta este componente a una entidad en el editor.
Coin_Pickup :: class : Interactable {
    @ao_serialize coins: s64;
    used: bool;

    ao_start :: method() {
        this.set_listener(this);
        this.set_text("Recolectar");
        radius = 1.25;
        required_hold_time = 0.0;
    }

    can_use :: method(player: Player) -> bool {
        return !used;
    }

    on_interact :: method(player: Player) {
        if used return;
        used = true;

        Economy.deposit_currency(player, "Coins", coins);
        entity.destroy();
    }
}
```

Registra la moneda `Coins` durante la configuración de la escena antes de depositarla. Los procedimientos globales del ciclo de vida, como `ao_start` y `ao_update` se ejecutan en cada simulación de escena; no son solo del servidor. Ver [Ciclo de vida de juego/marco](https://docs.allout.game/all-out-docs/docs-es/programacion/game-frame-lifecycle.md).

***

### Interacciones que reconocerás (y cómo se traducen)

#### ProximityPrompt → Interactable

Si usabas `ProximityPrompt.Triggered` en Roblox, el equivalente más cercano es un componente derivado de `Interactable`. Empieza aquí:

* [Interactivos](https://docs.allout.game/all-out-docs/docs-es/conceptos-centrales-del-motor/interactables.md)

#### «Touched» de recolección / zonas de trigger

BasePart.Touched `de Roblox` es un patrón muy común para recolecciones, zonas de daño y puntos de control. En All Out, añade un collider habilitado, establece `is_trigger`, y asigna `on_trigger_start`, `on_trigger_stay`, o `on_trigger_end`. El otro collider se pasa al callback. No se requiere un `Movement_Agent` .

Usa `Scene.get_all_components_in_range` cuando necesites detección amplia o una comprobación de distancia. La colisión sólida no proporciona un `Touched` general al estilo Roblox.

Ver [Navmesh y colisión](https://docs.allout.game/all-out-docs/docs-es/conceptos-centrales-del-motor/navmesh-and-collision.md).

***

### Acciones del jugador (Tools / teclas / controles móviles)

Si estás acostumbrado a scripts de «tool» de Roblox o a sistemas de entrada + enfriamiento hechos a mano, usa **Habilidades** en su lugar. Están diseñados para funcionar bien tanto en móvil como en PC con una UI coherente.

* [Habilidades](https://docs.allout.game/all-out-docs/docs-es/conceptos-centrales-del-motor/abilities.md)

***

### Guardado de datos (DataStoreService → sistema de guardado)

Para persistencia (monedas, desbloqueos, progreso, cosméticos), empieza con:

* [Sistema de guardado](https://docs.allout.game/all-out-docs/docs-es/datos-y-persistencia/save.md)
* [Serialización JSON](https://docs.allout.game/all-out-docs/docs-es/datos-y-persistencia/json.md)
* [Economía](https://docs.allout.game/all-out-docs/docs-es/datos-y-persistencia/economy.md)
* [Productos/datos entre juegos](https://docs.allout.game/all-out-docs/docs-es/datos-y-persistencia/cross-game-products-data.md)

***

### UI (ScreenGui → UI de All Out)

La UI de Roblox a menudo empieza con `ScreenGui` y `Frame/TextButton` jerarquías. En All Out, comienza aquí:

* [Fundamentos de la UI](https://docs.allout.game/all-out-docs/docs-es/ui/fundamentals.md)
* [Inicio rápido de UIDoc](https://docs.allout.game/all-out-docs/docs-es/ui/uidoc-quick-start.md)

Dibuja la UI del jugador desde el `ao_late_update` dentro de `is_local_or_server()`.

***

### Trampas comunes al portar para desarrolladores de Roblox

* **No existe un árbol de «workspace services»**: no busques `ReplicatedStorage`/`ServerScriptService` equivalentes; usa la jerarquía del editor + la carpeta de tu proyecto. `scripts` carpeta.
* **No protejas la jugabilidad con `Game.is_server()`**: la jugabilidad normal se ejecuta en el cliente que predice y en el servidor autoritativo.
* **Los campos de componentes de los prefabs no son anulaciones independientes**: desvincula la instancia o crea otro prefab cuando las copias necesiten valores de componentes diferentes.
* **Piensa en componentes en lugar de etiquetas**: donde usarías etiquetas de CollectionService, a menudo añadirás en su lugar un componente marcador/de comportamiento.
* **Recuerda que la escena es 2D**: usa capas del renderizador en lugar de una transformación Z.

***

### A dónde ir después

* Crea tu primer juego: [Construir un juego básico](https://docs.allout.game/all-out-docs/docs-es/primeros-pasos/testing-and-publishing.md)
* Aprende lo básico del editor: [Introducción/Vista de escena](https://docs.allout.game/all-out-docs/docs-es/usar-el-editor/introduction-scene-view.md)
* Aprende lo básico de scripting: [Primeros pasos con CSL](https://docs.allout.game/all-out-docs/docs-es/programacion/syntax.md)
* Aprende los bloques básicos de construcción del gameplay: [Interactivos](https://docs.allout.game/all-out-docs/docs-es/conceptos-centrales-del-motor/interactables.md), [Inventario](https://docs.allout.game/all-out-docs/docs-es/conceptos-centrales-del-motor/inventory.md), [Habilidades](https://docs.allout.game/all-out-docs/docs-es/conceptos-centrales-del-motor/abilities.md)
