Esta guía y el video adjunto te guían a través de la conexión de un arnés de programación habilitado para IA a Roblox Studio a través de MCP, para que tu agente pueda leer, escribir y probar el juego en tu nombre.
Al final, tendrás una carpeta de proyecto que se sincroniza con Studio a través de Script Sync (una función que te permite usar tu propio editor para escribir código), una conexión MCP que permite a tu agente controlar Studio directamente, y un repositorio de Git listo para el desarrollo.
Paso 1: Instalar los requisitos previos
Necesitarás los siguientes componentes antes de comenzar:
- Un editor de texto habilitado para IA - Las opciones más populares son Visual Studio Code y Cursor. Cursor tiene su asistente de IA incorporado, mientras que VS Code necesita una extensión como Claude Code. Ambos funcionan bien aquí, así que usa el que prefieras.
- Roblox Studio - Descárgalo de create.roblox.com.
- Git - Instálalo desde git-scm.com.
Paso 2: Inicia sesión en todo
- Tu editor de texto:
- VS Code — Iniciar sesión varía según la extensión. Para Claude Code, haz clic en el icono de Claude en la barra de actividad, inicia sesión con tu cuenta de Anthropic y confirma que se abre el panel de chat. Otros proveedores son similares.
- Cursor — Abre Cursor, inicia sesión con tu cuenta de Cursor y confirma que se abre el panel de chat. Puedes usar cualquier modelo que prefieras.
- Roblox Studio — Abre Studio, accede con tu cuenta de Roblox y confirma que puedes crear un nuevo lugar.
Paso 3: Descargar el repositorio de inicio
El repositorio de inicio te proporciona el diseño de carpetas y un archivo .gitignore para que Git solo comite las partes de tu proyecto que importan. La mayor parte de la configuración manual está hecha para ti.
- Descarga el repositorio de inicio y descomprímelo. Ya contiene una carpeta llamada WaveSurvival.
- En tu editor, elige Archivo → Abrir Carpeta y selecciona WaveSurvival. Deberías ver tres carpetas dentro:
- ServerScriptService/ contiene scripts del servidor, como lógica de juego, IA de enemigos y gestión de oleadas.
- ReplicatedStorage/ contiene módulos compartidos que tanto el servidor como el cliente pueden usar.
- StarterPlayerScripts/ contiene scripts del cliente que se ejecutan para cada jugador.
Los archivos .gitkeep dentro de cada carpeta son marcadores de posición para que Git rastree las carpetas mientras aún están vacías.
Paso 4: Crear un proyecto en blanco en Roblox Studio
- Abre Roblox Studio y haz clic en Nueva Experiencia.
- Elige Archivo → Guardar en archivo, navega a tu carpeta WaveSurvival y guarda el lugar como WaveSurvival.rbxlx. El archivo .gitignore del repositorio de inicio ya excluye los archivos .rbxlx de Git.
- Mantén Studio abierto. Lo necesitarás para Script Sync y MCP.
Paso 5: Habilitar la beta de Script Sync
Script Sync es una función beta, así que necesitas activarla antes de poder usarla.
Studio se actualiza con frecuencia. Si no ves Script Sync en la lista, instala la última versión de Studio y vuelve a intentarlo.
- En Studio, elige Archivo → Características beta.
- Busca Script Sync, actívalo y haz clic en Guardar.
- Reinicia Studio cuando se te indique.
Paso 6: Conectar Script Sync
Conectas Script Sync una vez por proyecto vinculando cada servicio de Studio a su carpeta correspondiente en el disco.
- En el Explorador, haz clic derecho en ServerScriptService.
- Elige Script Sync → Sincronizar a, luego navega a tu carpeta WaveSurvival.
- Repite para ReplicatedStorage y StarterPlayerScripts.
Selecciona la carpeta de nivel superior WaveSurvival, no las carpetas dentro de ella. Dado que las carpetas ya tienen los nombres correctos, Script Sync empareja automáticamente cada servicio con el correcto.
Cualquier archivo .luau que crees en esas carpetas aparecerá automáticamente como scripts en Studio.
Paso 7: Verificar Script Sync
En el panel de chat de tu editor, solicita a tu agente:
Crea un script de prueba en ServerScriptService/Test.server.luau que imprima '¡Hola desde Script Sync!' en la salida.
En Studio, revisa el Explorador. Deberías ver Test aparecer debajo de ServerScriptService. Realizarás una verificación más profunda, controlada por el agente, una vez que se conecte MCP.
Paso 8: Habilitar la conexión MCP
El servidor MCP de Studio permite que tu agente de IA interactúe directamente con Studio, leyendo el árbol del juego, creando objetos, ejecutando scripts y verificando salidas. Cubre todo lo que Script Sync no puede alcanzar, como StarterGui y StarterPack.
- En Studio, abre la ventana de Asistente usando el botón Asistente en la parte superior derecha.
- Haz clic en ⋯ → Administrar servidores MCP.
- Confirma que MCP está habilitado.
- En Conexión rápida, habilita Cursor o Visual Studio Code.
Si instalaste tu editor mientras Studio estaba abierto, es posible que necesites reiniciar Studio, tu editor o ambos para establecer la conexión. Para más detalles, consulta Conectarse al servidor MCP de Roblox Studio.
Paso 9: Verificar la conexión MCP
Solicita a tu agente:
Utiliza el MCP de Roblox para leer el árbol de juego actual en Roblox Studio. Enumera lo que hay en Workspace.
Es posible que necesites aprobar el comando o añadir la herramienta MCP a una lista blanca. Para una plantilla Baseplate nueva, la respuesta describe la Camera, Terrain, Baseplate, y SpawnLocation por defecto y confirma que no hay otro contenido todavía.
Paso 10: Realizar una verificación de extremo a extremo
Solicita a tu agente que verifique toda la configuración de una vez:
Utiliza la conexión MCP de Roblox para verificar que Script Sync esté funcionando correctamente. Haz algunos cambios en Test.server.luau, añade nuevos scripts en las otras dos carpetas y verifica la salida de cada uno. Ejecuta game:GetService("InstanceFileSyncService"):GetStatus(instance) en cada script para verificar el estado de la sincronización. Cuando termines, elimina los tres scripts.
Observa en Studio y verás que el agente comienza una prueba de juego para confirmar la salida.
Paso 11: Confirmar en Git
Ahora tienes una configuración limpia y funcional, lo que hace que este sea un buen momento para comprometerse. Desde tu terminal:
Próximos pasos
Tu proyecto ahora está sincronizado con Studio, tu agente de IA puede comunicarse directamente con él, y tienes un repositorio de Git para seguir los cambios y avances.
A partir de aquí, puedes usar el archivo WAVE_SURVIVAL.md del proyecto de inicio como contexto para que tu agente construya un juego de supervivencia de oleadas. Sigue el video complementario para construir el juego una fase de prueba a la vez.