Esta página aún no está traducida: se muestra la versión en inglés.
The Operator Plane
Lo que deliberadamente no está en el SDK. El ciclo de vida de proyectos y entornos, el deploy y la reversión, la facturación, la administración de organizaciones y usuarios y el enrutamiento entre clústeres le corresponden al panel de administración, a la CLI y a la interfaz MCP, no al código del juego. La única excepción deliberada es Esquema como código: el esquema es una interfaz para desarrolladores, así que está en el SDK.
Un modelo, dos planos
| El plano del SDK | El plano de operador | |
|---|---|---|
| Se accede desde | el código del juego | el panel de control, la CLI, MCP |
| Contiene | salas · entidades · jugadores · comercio · tablas de clasificación | proyectos y entornos · deploy y reversión · facturación · administración de organizaciones y usuarios · enrutamiento entre clústeres |
| Se trabaja con | declaraciones, hooks, eventos, operaciones | las pantallas propias del panel |
Los dos comparten un modelo: la declaración que subes es la misma que muestra el panel. Lo que no cruza la línea es la autoridad: el código del juego no puede desplegar, facturar ni mover un tenant.
Cada interfaz del SDK (cada módulo y los presets declarados sobre entidades) tiene su contraparte en el plano de operador (operator plane), dentro del panel de control. Ahí las mismas declaraciones se ven y se editan desde el otro lado:
| Interfaz del SDK | Lo que ve el operador |
|---|---|
| Esquema como código / Data & Subscriptions | entidades, migraciones, el explorador de registros, vistas guardadas, importación y exportación |
| Entity | máquinas de estados, inspección por instancia |
| Entity Presets | tablas de botín, definiciones de habilidades, estadísticas y proyectiles, presets de objetos del mundo, todo ajustable en vivo |
| Access & Roles | la cuadrícula de roles: roles × operaciones, filtros de filas, máscaras de columnas |
| Extensibility | cadenas de escenarios con sus reemplazos, el orden resuelto, trazas de invocación |
| Rooms | la flota: salas, salud del tick, ubicación, estado de retiro de servicio (drain) |
| Matchmaking | colas, tickets en curso, curvas de relajación de criterios |
| Catalog & Commerce | catálogo, programación de la tienda, recibos, reembolsos |
| Leaderboards | ciclos, corrección de registros (auditada), frecuencia de envíos |
| Auth & Players | proveedores, sesiones, baneos, el escenario de autenticación |
| Files & UGC | assets, colas de revisión de UGC, cuotas |
| Analytics | tableros, reenviadores de eventos, retraso de ingesta |
| Map | mapas y conjuntos de obstáculos, instancias en vivo |
| Visibility / Collision / Locomotion / Prediction & Lag Comp | ajuste por sala: reglas, pares de respuesta, ventanas, costo del paquete por actor |
| Groups / Messaging | explorador de grupos, plantillas, filtros de moderación, programaciones |
| Bots | perfiles, cuotas de relleno, endpoints de los cerebros |
| Inventory / Profile | existencias y transferencias, vistas y conjuntos de entidades propias |
La regla de diseño. Cada capacidad del SDK tiene su interfaz en el panel, para que live-ops pueda verla, y cada interfaz del panel se apoya en una capacidad del SDK. Los módulos traen las dos mitades juntas, y una declaración escrita en cualquiera de los dos lugares es el mismo modelo en ambos.
El viaje de una declaración: schema-author la escribe, playserv push la lleva, panel la muestra para operator y el reajuste llega a salas que ya están en ejecución.
Acceso para agentes
Todo lo que muestra el panel también está al alcance de las herramientas: la plataforma expone una interfaz MCP (la misma API que usa el panel), así que los agentes de IA y los scripts operan proyectos (configuración inicial, esquema, registros, jugadores, deploys) bajo el mismo modelo de acceso que cualquier otro actor.