Construa com um suporte de codificação

Este guia e o vídeo acompanhante o conduzem na conexão de um suporte de codificação habilitado para IA ao Roblox Studio via MCP, para que seu agente possa ler, escrever e testar em seu nome.

Ao final, você terá uma pasta de projeto que se sincroniza com o Studio através do Script Sync (um recurso que permite usar seu próprio editor para escrever código), uma conexão MCP que permite que seu agente controle o Studio diretamente, e um repositório Git pronto para desenvolvimento.

Etapa 1: Instale os pré-requisitos

Você precisará dos seguintes componentes antes de começar:

1. Um editor de texto habilitado para IA - As opções mais populares são Visual Studio Code e Cursor. O Cursor tem seu assistente de IA embutido, enquanto o VS Code precisa de uma extensão como Claude Code. Ambos funcionam bem aqui, então use o que preferir.
2. Roblox Studio - Baixe em create.roblox.com.
3. Git - Instale em git-scm.com.

   • No Windows, você pode usar WinGet: winget install --id Git.Git -e --source winget.
   • No macOS, você pode usar Homebrew: brew install git.

Etapa 2: Faça login em tudo

1. Seu editor de texto:

   • VS Code — O login varia de acordo com a extensão. Para Claude Code, clique no ícone Claude na barra de atividades, faça login com sua conta Anthropic e confirme que o painel de chat se abre. Outros provedores são semelhantes.
   • Cursor — Abra o Cursor, faça login com sua conta Cursor e confirme que o painel de chat se abre. Você pode usar qualquer modelo que preferir.
2. Roblox Studio — Abra o Studio, faça login com sua conta Roblox e confirme que você pode criar um novo lugar.

Etapa 3: Baixe o repositório inicial

O repositório inicial fornece a estrutura de pastas e um arquivo .gitignore para que o Git apenas comite as partes do seu projeto que importam. A maior parte da configuração manual já está feita para você.

1. Baixe o repositório inicial e descompacte-o. Ele já contém uma pasta chamada WaveSurvival.
2. No seu editor, escolha Arquivo → Abrir Pasta e selecione WaveSurvival. Você deve ver três pastas dentro:

   • ServerScriptService/ contém scripts do servidor, como lógica do jogo, IA de inimigos e gerenciamento de ondas.
   • ReplicatedStorage/ contém módulos compartilhados que tanto o servidor quanto o cliente podem usar.
   • StarterPlayerScripts/ contém scripts do cliente que são executados para cada jogador.

Os arquivos .gitkeep dentro de cada pasta são marcadores para que o Git rastreie as pastas enquanto ainda estão vazias.

Etapa 4: Crie um projeto em branco no Roblox Studio

1. Abra o Roblox Studio e clique em Nova Experiência.
2. Escolha Arquivo → Salvar em Arquivo, navegue até sua pasta WaveSurvival e salve o lugar como WaveSurvival.rbxlx. O .gitignore do repositório inicial já exclui arquivos .rbxlx do Git.
3. Mantenha o Studio aberto. Você precisará dele para o Script Sync e MCP.

Etapa 5: Ative a versão beta do Script Sync

O Script Sync é um recurso beta, então você precisa ativá-lo antes de usá-lo.

1. No Studio, escolha Arquivo → Recursos Beta.
2. Encontre Script Sync, ative-o e clique em Salvar.
3. Reinicie o Studio quando solicitado.

Etapa 6: Conecte o Script Sync

Você conecta o Script Sync uma vez por projeto, vinculando cada serviço do Studio à sua pasta correspondente no disco.

1. No Explorer, clique com o botão direito em ServerScriptService.
2. Escolha Script Sync → Sincronizar para, e então navegue até sua pasta WaveSurvival.
3. Repita para ReplicatedStorage e StarterPlayerScripts.

Qualquer arquivo .luau que você criar nessas pastas agora aparecerá como scripts no Studio automaticamente.

Etapa 7: Verifique o Script Sync

No painel de chat do seu editor, solicite ao seu agente:

No Studio, verifique o Explorer. Você deve ver Test aparecer sob ServerScriptService. Você fará uma verificação mais profunda, dirigida pelo agente, após a conexão do MCP.

Etapa 8: Ative a conexão MCP

O servidor MCP do Studio permite que seu agente de IA interaja diretamente com o Studio, lendo a árvore do jogo, criando objetos, executando scripts e verificando a saída. Ele cobre qualquer coisa que o Script Sync não pode alcançar, como StarterGui e StarterPack.

1. No Studio, abra a janela do Assistente usando o botão Assistente no canto superior direito.
2. Clique em ⋯ → Gerenciar Servidores MCP.
3. Confirme que o MCP está ativado.
4. Em Conexão rápida, ative o Cursor ou o Visual Studio Code.

Se você instalou seu editor enquanto o Studio estava aberto, pode ser necessário reiniciar o Studio, seu editor ou ambos para estabelecer a conexão. Para mais detalhes, veja Conectar ao servidor MCP do Roblox Studio.

Etapa 9: Verifique a conexão MCP

Solicite ao seu agente:

Você pode precisar aprovar o comando ou adicionar a ferramenta MCP a uma lista de permissões. Para um modelo Baseplate novo, a resposta descreve a Camera, Terrain, Baseplate e SpawnLocation padrão e confirma que ainda não há outro conteúdo.

Etapa 10: Execute uma verificação de ponta a ponta

Solicite ao seu agente que verifique toda a configuração de uma vez:

Observe no Studio e você verá o agente iniciar um teste de jogo para confirmar a saída.

Etapa 11: Faça o commit no Git

Agora você tem uma configuração limpa e funcional, o que torna este um bom momento para fazer o commit. Do seu terminal:

git add .
git commit -m "Script sync conectado e MCP verificado"

Próximos passos

Seu projeto agora está sincronizado com o Studio, seu agente de IA pode se comunicar diretamente com ele, e você tem um repositório Git para rastrear alterações e progresso.

A partir daqui, você pode usar o arquivo WAVE_SURVIVAL.md do projeto inicial como contexto para seu agente construir um jogo de sobrevivência de ondas. Siga junto com o vídeo acompanhante para construir o jogo uma fase testada de cada vez.