Esta guía y el video adjunto te guían a través de la conexión de un arnés de codificació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: Instala 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 integrado, 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 ícono 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, inicia sesión con tu cuenta de Roblox y confirma que puedes crear un nuevo lugar.
Paso 3: Descarga el repositorio inicial
El repositorio inicial te proporciona la estructura de carpetas y un archivo .gitignore para que Git solo registre las partes de tu proyecto que importan. La mayor parte de la configuración manual ya está hecha para ti.
- Descarga el repositorio inicial 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 del 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: Crea 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 .gitignore del repositorio inicial ya excluye los archivos .rbxlx de Git.
- Mantén Studio abierto. Lo necesitarás para Script Sync y MCP.
Paso 5: Habilita la beta de Script Sync
Script Sync es una función beta, así que necesitas activarla antes de poder usarla.
Studio se actualiza a menudo. Si no ves Script Sync en la lista, instala la última versión de Studio y vuelve a intentarlo.
- En Studio, elige Archivo → Funciones Beta.
- Busca Script Sync, actívalo y haz clic en Guardar.
- Reinicia Studio cuando se te pida.
Paso 6: Conecta 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 ahora aparecerá automáticamente como scripts en Studio.
Paso 7: Verifica 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, verifica el Explorador. Deberías ver que Test aparece bajo ServerScriptService. Realizarás una verificación más profunda, impulsada por el agente, después de que MCP esté conectado.
Paso 8: Habilita 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 la salida. Cubre cualquier cosa que Script Sync no pueda alcanzar, como StarterGui y StarterPack.
- En Studio, abre la ventana del Asistente usando el botón Asistente en la parte superior derecha.
- Haz clic en ⋯ → Administrar Servidores MCP.
- Confirma que MCP está habilitado.
- Bajo 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 Conectar al servidor MCP de Roblox Studio.
Paso 9: Verifica la conexión MCP
Solicita a tu agente:
Usa el MCP de Roblox para leer el árbol del juego actual en Roblox Studio. Enumera lo que hay en Workspace.
Es posible que necesites aprobar el comando o agregar la herramienta MCP a una lista de permitidos. Para una plantilla Baseplate nueva, la respuesta describe la Cámara, Terreno, Baseplate y SpawnLocation predeterminados y confirma que aún no hay otro contenido.
Paso 10: Realiza una verificación de extremo a extremo
Solicita a tu agente que verifique toda la configuración a la vez:
Usa la conexión MCP de Roblox para verificar que Script Sync esté funcionando correctamente. Realiza algunos cambios en Test.server.luau, agrega 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 sincronización. Cuando termines, elimina los tres scripts.
Mira en Studio y verás que el agente comienza una prueba de juego para confirmar la salida.
Paso 11: Realiza un commit en Git
Ahora tienes una configuración limpia y funcional, lo que hace que este sea un buen momento para hacer un commit. Desde tu terminal:
git add .
git commit -m "Sincronización de scripts conectada y MCP verificado"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 rastrear cambios y progreso.
A partir de aquí, puedes usar el archivo WAVE_SURVIVAL.md del proyecto inicial como contexto para que tu agente construya un juego de supervivencia de oleadas. Sigue el video complementario para construir el juego una fase probada a la vez.