Construa com um suporte de programação

Este guia e o vídeo acompanhante mostram como conectar um suporte de programação habilitado para IA ao Roblox Studio via MCP, para que seu agente possa ler, escrever e testar jogos em seu nome.

Ao final, você terá uma pasta de projeto que 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 diretamente o Studio, 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 possui seu assistente de IA embutido, enquanto o VS Code requer uma extensão como Claude Code. Ambos funcionam bem aqui, então use o que você 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 conforme a extensão. Para Claude Code, clique no ícone Claude na barra de atividades, faça login com sua conta da Anthropic e confirme que o painel de chat está aberto. Outros provedores são semelhantes.
   • Cursor — Abra o Cursor, faça login com sua conta do Cursor e confirme que o painel de chat está aberto. Você pode usar qualquer modelo que preferir.
2. Roblox Studio — Abra o Studio, faça login com sua conta Roblox e confirme que consegue criar um novo lugar.

Etapa 3: Baixe o repositório inicial

O repositório inicial fornece o layout da pasta e um arquivo .gitignore para que o Git comite apenas as partes do seu projeto que importam. A maior parte da configuração manual já está pronta 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 rodam 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 arquivo .gitignore do repositório inicial já exclui arquivos .rbxlx do Git.
3. Mantenha o Studio aberto. Você precisará dele para o Script Sync e o 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, ligando 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, peça ao seu agente:

No Studio, verifique o Explorer. Você deve ver Test aparecer sob ServerScriptService. Você fará uma verificação mais profunda, controlada 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 possa 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. Na seção Conexão rápida, ative o Cursor ou o Visual Studio Code.

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

Etapa 9: Verifique a conexão MCP

Peça ao seu agente:

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

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

Peça ao seu agente para verificar toda a configuração de uma vez:

Observe no Studio e você verá o agente começar um playtest 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. No seu terminal:

git add .
git commit -m "Sincronização de script conectada e MCP verificado"

Próximas etapas

Seu projeto agora está sincronizado com o Studio, seu agente IA pode se comunicar diretamente com ele, e você tem um repositório Git para rastrear mudanças 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. Acompanhe o vídeo acompanhante para construir o jogo uma fase testada de cada vez.