Questa guida e il video allegato ti accompagneranno nel collegamento di un telaio di codifica abilitato per AI a Roblox Studio tramite MCP, in modo che il tuo agente possa leggere, scrivere e effettuare playtest per tuo conto.
Alla fine, avrai una cartella di progetto che si sincronizza con Studio tramite Script Sync (una funzione che ti consente di utilizzare il tuo editor per scrivere codice), una connessione MCP che permette al tuo agente di controllare direttamente Studio, e un repository Git pronto per lo sviluppo.
Passo 1: Installa i prerequisiti
Avrai bisogno dei seguenti componenti prima di iniziare:
- Un editor di testo abilitato per AI - Le opzioni più popolari sono Visual Studio Code e Cursor. Cursor ha il suo assistente AI integrato, mentre VS Code necessita di un'estensione come Claude Code. Entrambi funzionano bene qui, quindi utilizza quello che preferisci.
- Roblox Studio - Scaricalo da create.roblox.com.
- Git - Installalo da git-scm.com.
Passo 2: Accedi a tutto
- Il tuo editor di testo:
- VS Code — L'accesso varia a seconda dell'estensione. Per Claude Code, fai clic sull'icona Claude nella barra delle attività, accedi con il tuo account Anthropic e conferma che il pannello della chat si apra. Altri fornitori sono simili.
- Cursor — Apri Cursor, accedi con il tuo account Cursor e conferma che il pannello della chat si apra. Puoi utilizzare qualsiasi modello preferisci.
- Roblox Studio — Apri Studio, accedi con il tuo account Roblox e conferma di poter creare un nuovo luogo.
Passo 3: Scarica il repository di avvio
Il repository di avvio ti fornisce il layout della cartella e un file .gitignore in modo che Git registri solo le parti del tuo progetto che contano. La maggior parte della configurazione manuale è già stata eseguita per te.
- Scarica il repository di avvio e decomprimilo. Contiene già una cartella chiamata WaveSurvival.
- Nel tuo editor, scegli File → Apri cartella e seleziona WaveSurvival. Dovresti vedere tre cartelle all'interno:
- ServerScriptService/ contiene script server, come logica di gioco, IA nemica e gestione delle onde.
- ReplicatedStorage/ contiene moduli condivisi che sia il server che il client possono utilizzare.
- StarterPlayerScripts/ contiene script client che vengono eseguiti per ogni giocatore.
I file .gitkeep all'interno di ciascuna cartella sono segnaposto affinché Git tracci le cartelle mentre sono ancora vuote.
Passo 4: Crea un progetto vuoto in Roblox Studio
- Apri Roblox Studio e fai clic su Nuova Esperienza.
- Scegli File → Salva in file, naviga nella tua cartella WaveSurvival e salva il luogo come WaveSurvival.rbxlx. Il file .gitignore del repository di avvio esclude già i file .rbxlx da Git.
- Tieni aperto Studio. Avrai bisogno di esso per Script Sync e MCP.
Passo 5: Abilita la beta di Script Sync
Script Sync è una funzione beta, quindi devi attivarla prima di poterla utilizzare.
Studio si aggiorna frequentemente. Se non vedi Script Sync nell'elenco, installa la versione più recente di Studio e riprova.
- In Studio, scegli File → Funzioni beta.
- Trova Script Sync, abilitalo e fai clic su Salva.
- Riavvia Studio quando richiesto.
Passo 6: Collega Script Sync
Colleghi Script Sync una sola volta per progetto collegando ciascun servizio di Studio alla sua cartella corrispondente sul disco.
- Nell'Explorer, fai clic con il tasto destro su ServerScriptService.
- Scegli Script Sync → Sincronizza con, quindi cerca la tua cartella WaveSurvival.
- Ripeti per ReplicatedStorage e StarterPlayerScripts.
Seleziona la cartella di livello superiore WaveSurvival, non le cartelle al suo interno. Poiché le cartelle hanno già i nomi corretti, Script Sync abbina automaticamente ciascun servizio a quello giusto.
Qualsiasi file .luau che crei in quelle cartelle appare ora come script in Studio automaticamente.
Passo 7: Verifica Script Sync
Nel pannello della chat del tuo editor, chiedi al tuo agente:
Crea uno script di prova in ServerScriptService/Test.server.luau che stampi 'Hello from Script Sync!' nell'output.
In Studio, controlla l'Explorer. Dovresti vedere Test apparire sotto ServerScriptService. Eseguirai un controllo più approfondito, guidato dall'agente, dopo che MCP sarà collegato.
Passo 8: Abilita la connessione MCP
Il server MCP di Studio consente al tuo agente AI di interagire direttamente con Studio, leggendo l'albero di gioco, creando oggetti, eseguendo script e controllando l'output. Copre tutto ciò che Script Sync non può raggiungere, come StarterGui e StarterPack.
- In Studio, apri la finestra Assistente utilizzando il pulsante Assistente in alto a destra.
- Fai clic su ⋯ → Gestisci server MCP.
- Conferma che MCP sia abilitato.
- Sotto Connessione rapida, abilita Cursor o Visual Studio Code.
Se hai installato il tuo editor mentre Studio era aperto, potrebbe essere necessario riavviare Studio, il tuo editor o entrambi per stabilire la connessione. Per ulteriori dettagli, vedi Collegati al server MCP di Roblox Studio.
Passo 9: Verifica la connessione MCP
Chiedi al tuo agente:
Usa il MCP di Roblox per leggere l'attuale albero di gioco in Roblox Studio. Elenca cosa c'è in Workspace.
Potrebbe essere necessario approvare il comando o aggiungere lo strumento MCP a un elenco di autorizzazione. Per un modello fresco di Baseplate, la risposta descrive la Camera predefinita, Terrain, Baseplate e SpawnLocation e conferma che non ci sono altri contenuti ancora.
Passo 10: Esegui un controllo end-to-end
Chiedi al tuo agente di verificare l'intero setup in una sola volta:
Usa la connessione MCP di Roblox per verificare che Script Sync funzioni correttamente. Apporta alcune modifiche a Test.server.luau, aggiungi nuovi script nelle altre due cartelle e verifica l'output di ciascuno. Esegui game:GetService("InstanceFileSyncService"):GetStatus(instance) in ciascuno script per verificare lo stato della sincronizzazione. Quando hai finito, elimina tutti e tre gli script.
Guarda in Studio e vedrai l'agente avviare un playtest per confermare l'output.
Passo 11: Esegui il commit su Git
Ora hai una configurazione pulita e funzionante, il che rende questo un buon momento per eseguire il commit. Dal tuo terminale:
Passi successivi
Il tuo progetto è ora sincronizzato con Studio, il tuo agente AI può comunicare direttamente e hai un repository Git per tenere traccia delle modifiche e dei progressi.
Da qui, puoi utilizzare il file WAVE_SURVIVAL.md dal progetto di avvio come contesto per il tuo agente per costruire un gioco di sopravvivenza alle onde. Segui il video di accompagnamento per costruire il gioco un fase testata alla volta.