Como criar um jogo no Roblox com IA e Thrixel

Antes de começar, é necessário ter o Roblox Studio instalado e uma conta no Roblox.

1. Instalar o Rojo com o VS Code

1. Instale o Visual Studio Code (VS Code).
2. Instale a extensão Rojo - Roblox Studio Sync para o VS Code.
3. No VS Code, aceda a File > Open Folder e abra uma pasta vazia para o jogo.
4. Pressione Ctrl + Shift + P (Cmd + Shift + P no Mac) para abrir a paleta de comandos. Digite “Rojo” e selecione Rojo: Open Menu.
5. Se o menu indicar que o Rojo não está instalado, clique em Install Rojo now.
6. Clique em Install Roblox Studio Plugin. Se o Studio estiver aberto, reinicie-o. O Rojo deverá aparecer no separador Plugins do Studio.

2. Adicionar a skill Build World

Iniciar sessão

Inicie sessão no Thrixel antes de instalar a skill. O comando é igual para todos os agentes e requer o uv. Se o uv não estiver instalado, execute num terminal o comando correspondente ao seu sistema operativo:

curl -LsSf https://astral.sh/uv/install.sh | sh

irm https://astral.sh/uv/install.ps1 | iex

Execute o comando de início de sessão abaixo. Quando a página abrir no navegador, clique em Approve para associar a sua conta do Thrixel.

uvx thrixel-mcp@latest login

Instalar o Build World

Escolha o seu agente de programação abaixo. O Build World precisa tanto da skill, que fornece as instruções, como do servidor MCP do Thrixel, que fornece as ferramentas para gerar recursos.

claude plugin marketplace add thrixel/build-world
claude plugin install thrixel@thrixel

codex plugin marketplace add thrixel/build-world
codex plugin add thrixel@thrixel

{
  "mcpServers": {
    "thrixel": {
      "type": "stdio",
      "command": "uvx",
      "args": ["thrixel-mcp@latest"]
    }
  }
}

git clone https://github.com/thrixel/build-world ~/.thrixel/build-world
mkdir -p ~/.cursor/skills
ln -s ~/.thrixel/build-world/skills/build-world ~/.cursor/skills/build-world

git clone https://github.com/thrixel/build-world "$HOME\.thrixel\build-world"
New-Item -ItemType Directory -Force "$HOME\.cursor\skills" | Out-Null
New-Item -ItemType Junction -Path "$HOME\.cursor\skills\build-world" -Target "$HOME\.thrixel\build-world\skills\build-world"

gemini mcp add -s user --trust thrixel uvx -- thrixel-mcp@latest
gemini skills install https://github.com/thrixel/build-world --path skills/build-world

O guia de configuração do Build World também aborda instalações manuais, atualizações e instalações existentes.

3. Configurar o Roblox Studio

Ative o servidor MCP do Studio para que o agente possa executar código no Studio e captar imagens do jogo.

1. Abra o Roblox Studio e crie uma nova Baseplate. Isso cria um lugar, o ficheiro do Roblox que contém o mundo do jogo.
2. Clique no ícone Assistant, no canto superior direito da janela.
3. No painel do Assistant, abra … > Settings > Manage MCP Servers. Ative Enable Studio as MCP server. Um indicador verde confirma que ele está em execução.

4. Criar uma chave de API do Roblox

O Rojo não sincroniza ficheiros de modelos 3D. O agente usa uma chave de API do Roblox para carregar os modelos separadamente.

1. Aceda a a sua página de credenciais no Creator Hub e clique em Create API Key.
2. Em Access Permissions, adicione o sistema de API Assets. Escolha a sua conta como proprietária e ative Read e Write.
3. Em Accepted IP Addresses, adicione 0.0.0.0/0 ou desative as restrições de IP. Se o campo ficar vazio, os carregamentos não poderão ser concluídos.
4. Como esta chave permite o acesso a partir de qualquer endereço IP, defina um prazo de validade curto, como 30 dias.
5. Clique em Save e copie a chave. A chave é apresentada apenas uma vez.
6. Guarde a chave num ficheiro chamado roblox_api_key.txt na pasta do jogo. Não inclua este ficheiro no Git.

5. Iniciar o servidor

Iniciar o servidor pelo VS Code

1. No VS Code, abra a paleta de comandos com Ctrl + Shift + P (Cmd + Shift + P no Mac). Digite “Rojo” e selecione Rojo: Open Menu.
2. Se a pasta não tiver um projeto do Rojo, clique em Create one now. O Rojo adiciona default.project.json e as pastas iniciais do jogo.
3. Em Projects in this workspace, clique no nome do projeto ao lado do ícone de reprodução.

Um pop-up no canto inferior direito do VS Code confirma que o servidor está à escuta em localhost, na porta 34872. Para parar o servidor, abra o menu do Rojo e clique no projeto novamente. O ícone de reprodução muda para um ícone de parada enquanto o servidor está ativo.

Ligar o Roblox Studio ao servidor

1. Volte ao lugar Baseplate no Roblox Studio.
2. Abra o separador Plugins e clique em Rojo.
3. Mantenha o endereço como localhost e a porta como 34872, a menos que o servidor tenha indicado outra porta.
4. Clique em Connect.
5. Em “Sync changes for project”, reveja as alterações que o Rojo fará no lugar e clique em Accept.

A janela do Rojo agora mostra o nome do projeto, o endereço do servidor e um botão Disconnect. O Studio está ligado e pronto para receber alterações.

Se o Studio não conseguir se ligar, abra http://localhost:34872/ num navegador. Uma página de status do Rojo confirma que o servidor está em execução.

6. Criar o jogo

Thrixel Cubes

O Thrixel cobra Cubes para gerar recursos 3D. O total depende das operações usadas e da quantidade de recursos do jogo. Algumas operações têm custo fixo, enquanto outras são medidas e cobradas após a execução. Criar um jogo completo também pode consumir uma grande parte dos limites do plano do agente de programação. Verifique o seu saldo antes de começar um projeto grande e consulte o site do Thrixel para ver os preços atuais.

Executar o Build World

1. Abra o agente de programação na pasta que contém o projeto do Rojo.
2. Comece uma mensagem com o comando do Build World para o seu agente:

   Agente	Comando
   Claude Code	/thrixel:build-world
   Codex	$build-world
   Cursor	/build-world
   Gemini CLI	/build-world

3. Descreva o jogo após o comando. Inclua “Roblox” para que a skill use a motor correto.
4. Mencione que o Rojo já está em execução e indique a porta, para que o agente não inicie um segundo servidor.

No Codex, digite $build e selecione build-world no seletor de skills antes de adicionar a descrição do jogo.

/thrixel:build-world crie um jogo de obstáculos no Roblox em ilhas flutuantes. O Rojo e o respetivo plugin do Studio já estão configurados, e o Rojo disponibiliza esta pasta na porta 34872, por isso não inicie outro servidor.

Aceitar alterações no Roblox Studio

A ligação inicial do Rojo é a etapa de aprovação. Depois de ligado, o Rojo sincroniza as alterações assim que o agente as guarda no disco.

• Ao ligar: O Rojo lista as diferenças entre os ficheiros e o lugar. Clique em Accept para aplicá-las ou em Abort para cancelar a ligação. Se não houver diferenças, ele estabelece a ligação sem perguntar.
• Enquanto o agente trabalha: Os scripts novos e alterados aparecem automaticamente no Studio. Se o Studio tiver sido fechado ou desligado, clique novamente em Connect quando o agente pedir. O agente não consegue voltar a ligar o Rojo por si só.
• Para inspecionar as alterações: Clique no horário da última alteração na janela do Rojo para abrir View changes. A lista mostra as alterações aplicadas e sinaliza as que falharam. As alterações do Rojo também aparecem no histórico de desfazer do Studio.

Para rever um conjunto de alterações antes de sincronizar, abra Settings na janela do Rojo e defina Confirmation Behavior como Always. Clique em Disconnect, deixe o agente terminar e depois clique em Connect para rever as alterações em conjunto. Esta revisão ocorre ao estabelecer a ligação. As alterações guardadas durante uma ligação ativa continuam a ser sincronizadas automaticamente.

Duas coisas precisam de atenção manual:

• Guarde as importações. O Rojo sincroniza scripts e instâncias. O agente carrega os modelos 3D separadamente e os insere em ReplicatedStorage.Assets, por isso esses modelos não ficam guardados nos ficheiros do projeto. Use File > Save no Studio para mantê-los.
• Edite os scripts sincronizados nos ficheiros do projeto. A sincronização bidirecional do Rojo está desativada por predefinição. As alterações a estes scripts no Studio não chegam aos ficheiros e podem ser substituídas.

7. Publicar o jogo

Use File > Publish to Roblox no Studio quando o jogo estiver pronto para partilhar.