Documentação do RoCode

O que é o RoCode

O RoCode (RoCode.app) é um agente de IA para Roblox Studio. Você descreve um recurso em um chat na web em rocode.app. Um plugin gratuito do RoCode, da Creator Store do Roblox, executa os passos do agente no jogo que você tem aberto: lê os objetos e scripts de que um passo precisa, escreve o Luau, cria ou edita Scripts, LocalScripts, ModuleScripts e outras instâncias e compila os scripts dentro do Studio antes de terminar.

DeepSeek V4 Flash, GLM 5.3 Flash, Claude Sonnet 5.5, Claude Opus 5.5 e GPT-6 Astra são modelos de terceiros que o RoCode roda pela OpenRouter com as próprias instruções e ferramentas do Studio. O RoCode não tem modelos próprios.

Requisitos

Não precisa: de app de computador, linha de comando, arquivos de configuração, servidor MCP nem da sua senha do Roblox. O RoCode nunca pede a sua senha do Roblox.

Instalar o plugin e conectar ao chat

Passo a passo

1. Crie uma conta grátis. Entre em rocode.app com código por e-mail, Google, Roblox ou Discord.
2. Instale o plugin. Abra o plugin do RoCode na Creator Store e instale. Plugins instalados aparecem na aba Plugins do Studio. No gerenciador de plugins do Studio, o RoCode aparece como RoCode AI.
3. Permita o acesso. Quando o Studio pedir, permita requisições HTTP para relay.rocode.app e o Script Injection (injeção de scripts). Sem o Script Injection, o RoCode não cria nem edita scripts.
4. Abra um jogo no Roblox Studio: um jogo em que você está trabalhando ou uma Baseplate nova.
5. Abra o chat. Abra rocode.app/chat em um navegador de computador. Se o Studio estiver conectado à mesma conta do Roblox com que você entrou ou que vinculou no RoCode, ele se conecta sozinho (plugin 3.9.13 ou mais recente). Se o chat mostrar Connect Studio, clique.
6. Ou use um código de pareamento. Se o Studio não se conectar sozinho, o painel do RoCode mostra um código de 8 caracteres; se você não o vir, clique em Use a pairing code. No card Connect to Roblox Studio do chat, digite o código e aperte Connect.
7. Confirme no Studio. Depois do código, o painel do RoCode mostra uma linha de confirmação com a sua conta. Aperte Connect (ou Allow) ali. Ele espera até 2 minutos e depois mostra um código novo.

Como funciona o código de pareamento

Uma configuração do Studio é opcional e continua com você: Enable Studio Access to API Services. Você precisa dela para testar o salvamento com data stores no Studio, e o RoCode não pode mudá-la. No Studio, abra File > Experience Settings > Security, ative e clique em Save. O jogo precisa estar publicado antes. O Studio passa a usar os mesmos data stores do jogo ao vivo, por isso a Roblox recomenda ativar isso só em uma cópia de teste separada.

Detalhes sobre as opções de login e as permissões: opções de login e permissões do Studio (em inglês).

Sua primeira execução

O chat não envia mensagens enquanto nenhum Studio estiver conectado: o botão de enviar fica desligado, e ao passar o mouse aparece Connect the plugin first. Com o Studio conectado, descreva uma alteração.

Escreva um bom primeiro prompt

• Um recurso por vez. Funciona melhor do que um jogo inteiro em uma mensagem.
• Diga o que deve acontecer, em palavras simples. Você não precisa de nomes de classes nem saber onde os scripts ficam.
• Aponte o que importa. Digite / na caixa de mensagem para anexar o caminho exato de um objeto do Studio, como o script que você quer mudar. Com o botão + você também pode anexar até 12 arquivos de texto (20.000 caracteres no total) e até 4 imagens por mensagem, em qualquer modelo.
• Só uma pergunta? Troque para o modo Ask e nada no seu jogo muda.
• Ou dite. O botão do microfone grava o seu prompt; a transcrição cai na caixa de mensagem para você editar e enviar.

Um prompt de exemplo escrito por nós. Os nomes das ferramentas são reais, mas o que uma execução faz depende do seu jogo.

Onde o RoCode coloca as coisas

Enquanto ele trabalha

• Um registro passo a passo. O chat lista cada passo pelo nome da ferramenta. Cada leitura e cada exclusão aparece com o caminho.
• Quanto tempo leva. Depende da tarefa, do tamanho do jogo e do modelo. Uma execução pode durar até 80 turnos do modelo ou 5 horas. O chat mostra os créditos que a execução está usando.
• O próximo prompt pode esperar na fila. Você pode ter até 3 execuções ao mesmo tempo.
• Parar e continuar. Você pode parar quando quiser. Se uma execução parar no meio, as alterações feitas até ali ficam, e Continue retoma de onde parou. Quando uma execução falha por um problema do nosso lado, os créditos voltam automaticamente.

Modos Build e Ask

Toda mensagem roda em um de dois modos, escolhidos no chip de modo da barra embaixo da caixa de mensagem. A escolha fica salva naquele navegador, então confira o chip antes de enviar uma alteração.

O Ask ainda precisa de um Studio conectado, porque lê o seu jogo. Quando o Ask sugerir uma correção, troque o chip para Build e peça a alteração. Mais detalhes em Build and Ask modes (em inglês).

Créditos e planos, em resumo

Um crédito mede o custo de processamento de uma execução. Modelos mais fortes e execuções mais longas usam mais. Nas taxas atuais, uma tarefa avançada usa cerca de 4 créditos e uma tarefa padrão (DeepSeek V4 Flash) cerca de 0,4. Isso dá ao Pro cerca de 35 tarefas avançadas por mês ou 375 padrão, ao Studio cerca de 80 ou 800 e ao Ultra cerca de 125 ou 1.250. Tarefas longas usam mais. No modelo grátis, 1 crédito basta para uma ou duas tarefas pequenas.

• Todos os planos têm as 27 ferramentas. Os planos pagos adicionam mais modelos, sua própria chave da OpenRouter e nenhum limite diário, e também recebem 2 créditos grátis por dia no DeepSeek V4 Flash.
• Os créditos grátis não pedem entrar no Discord do RoCode, e pagar também não.
• Os créditos do plano não acumulam. Pacotes de créditos vão de 50 créditos por US$ 4,99 até 1.200 créditos por US$ 99,99, em qualquer plano, e nunca expiram.
• A Paddle faz o checkout como revendedora oficial (merchant of record). O RoCode não guarda dados de cartão. Cancele pela página da sua conta.
• Reembolso integral em até 14 dias após qualquer pagamento, incluindo renovações e pacotes de créditos, por qualquer motivo. Peça em paddle.net ou respondendo ao recibo da Paddle.

Tudo sobre quando os créditos renovam, pacotes e reembolsos: quando os créditos renovam, pacotes de créditos, reembolsos e a página de preços (em inglês).

Verificações, testes e desfazer

• Check Script. Depois de criar ou editar um script, o agente é instruído a compilá-lo com o compilador do Luau dentro do Studio. Ele pega erros de compilação e alguns padrões arriscados, como wait() no lugar de task.wait(), não erros de lógica. Se a verificação falhar, a execução volta para correção; depois de duas tentativas ela pode terminar e diz o que ainda falha.
• O teste curto. Com o plugin 3.9 ou mais recente, uma execução no modo Build pode apertar Play por até 30 segundos, coletar os erros e avisos do servidor e do cliente e parar o teste, no máximo duas vezes por execução mais uma para conferir a própria correção. O agente decide quando testar, então nem toda construção ganha um teste.
• O personagem de teste. Com o plugin 3.9.11 ou mais recente, um personagem de teste anda, pula e pisa em partes; com o 3.9.15 ou mais recente, também aperta teclas, clica em botões da tela e digita. Depois ele confere se as coisas aconteceram e informa cada verificação como aprovada ou reprovada. Ele só confere o que o agente escolheu testar e não sabe dizer se o jogo é divertido.
• A checagem visual. Com o plugin 3.9.14 ou mais recente, uma execução no modo Build que construiu algo visível tira capturas de tela no modo de edição, no máximo uma vez por execução, e um modelo de IA aponta problemas claros, como partes flutuando ou afundadas no chão, para o agente corrigir.
• Desfazer, lote por lote. O RoCode cria um ponto de desfazer no Studio antes e depois de cada lote, então Ctrl+Z (⌘Z no Mac) volta um lote por vez enquanto o Studio está aberto. Uma execução costuma ter vários lotes. O botão Revert do chat só volta a conversa, não o Studio.
• Exclusões. O RoCode só apaga algo que ele mesmo criou no mesmo chat, que você pediu para remover ou cuja exclusão você confirmou. Com o plugin 3.8.5 ou mais recente, o objeto vai para uma pasta RoCodeTrash no ServerStorage, que guarda o que foi apagado nas 30 execuções mais recentes (até 25.000 objetos).

Se você achar um problema jogando: aperte Play, reproduza o problema e diga ao RoCode o que quebrou. Ele lê o Output do seu último teste com Check Output, lê o script em volta da linha do erro e corrige. Jogue de novo para confirmar.

Segurança: o que o RoCode alcança

O RoCode nunca pede a sua senha do Roblox e nunca envia o arquivo do seu jogo. O plugin devolve os resultados dos passos que uma execução pede, o que pode incluir o texto completo de scripts, mais a posição da câmera e até 8 objetos selecionados no início de uma execução, as capturas da checagem visual (plugin 3.9.14 ou mais recente) e o nome e o id do jogo ao conectar. A conexão de rede do próprio plugin vai só para o servidor do RoCode em relay.rocode.app, por uma conexão criptografada.

• Sem publicar nem gastar. O plugin não tem código para publicar ou salvar o seu jogo, enviar assets ou gastar Robux.
• Uma janela do Studio. Só uma janela do Studio fica conectada à sua conta por vez.
• Modo só de leitura. O Ask só usa 10 ferramentas de leitura, e o servidor do RoCode recusa qualquer ferramenta que mudaria o seu jogo antes que ela chegue ao Studio.
• Sem senha do RoCode. Você entra com código por e-mail, Google, Discord ou Roblox. Se você adicionar a sua própria chave da OpenRouter, ela é criptografada com AES-256-GCM antes de ser guardada.
• Pagamento. Você paga no checkout da própria Paddle, então digita o cartão na Paddle, não em um formulário do RoCode.

O RoCode é operado por um empresário individual no Reino Unido, com o nome comercial RoCode (veja os termos, em inglês); e-mail support@rocode.app. O que fica guardado e quem processa cada pedido está em Safety e Privacy and security (em inglês).

Limites: o que o RoCode não faz hoje

• Julgar se o seu jogo é divertido, ou jogar por você fora dos próprios testes curtos.
• Tirar capturas de tela enquanto o jogo roda. A checagem visual só fotografa o que uma execução Build construiu, no modo de edição. Você pode anexar suas próprias capturas em qualquer modelo.
• Esculpir ou pintar terreno à mão. Ele pode criar Terrain para você (colinas, montanhas, lagos, rios, ilhas e praias) com um script gerado; o retoque à mão fica com você.
• Gerar malhas (meshes), texturas ou animações do zero. Em vez disso, o Insert Model coloca modelos que já existem na Creator Store: os que encontra com as suas palavras, ou um modelo, decal ou malha pelo ID do asset ou link que você der.
• Publicar ou salvar o seu jogo, ou mudar as configurações da experiência no site do Roblox.
• Construir um jogo pronto e equilibrado a partir de uma frase.
• Funcionar no celular.

Ele também não tem ferramentas para game passes, produtos do desenvolvedor, envio de assets ou ativar os serviços de API. Em um jogo grande, o Search Scripts cobre até 300 scripts a partir de onde começa: se ele não achar o script certo, cite a pasta ou o script na mensagem, ou anexe com /. A tabela completa de limites está em Limits (em inglês), e as 27 ferramentas em The 27 tools (em inglês).

Problemas comuns e soluções

Todos os casos estão em Troubleshooting (em inglês). Se o seu não estiver lá, pergunte no Discord do RoCode, onde o suporte acontece.

Perguntas frequentes

Fontes e leitura extra

• Plugin do RoCode na Creator Store do Roblox. o plugin que esta página descreve
• Documentação completa do RoCode (em inglês). as 27 ferramentas, limites, privacidade e todos os problemas comuns
• Preços (em inglês). todos os planos, pacotes de créditos e reembolsos
• Roblox Creator Docs: Data stores (em inglês). ativar o acesso do Studio aos serviços de API, e por que usar uma cópia de teste