Roblox MCP
Conecte agentes de codificação de IA a uma sessão ativa do Roblox Studio.
Documentação
WEPPY Roblox AI Toolkit — Desenvolvimento de Jogos com IA para Roblox Studio
WEPPY Roblox AI Toolkit é um produto de desenvolvimento com IA para Roblox Studio. Ele inclui o WEPPY MCP Server para conexões de aplicativos de IA e o WEPPY Roblox Studio Plugin para controle ao vivo do Studio. Claude Code, Codex e Antigravity também podem instalar o opcional WEPPY AI Agent Plugin para configuração nativa do cliente e orientação de fluxo de trabalho.
Trabalho multi-Place no Studio · Assets gerados para Roblox · Sincronização bidirecional · Playtest automatizado · UI Studio
English | 한국어 | 日本語 | Español | Português | Bahasa Indonesia | Deutsch
Por que o WEPPY Roblox AI Toolkit?
Agentes de codificação com IA como Claude, Codex e Gemini são poderosos, mas não conseguem ver ou modificar nada dentro do Roblox Studio. O DataModel, scripts, terreno e iluminação são invisíveis para ferramentas externas. Sem uma ponte, a IA só pode gerar trechos de código que você precisa colar manualmente.
O WEPPY MCP Server conecta agentes de IA ao WEPPY Roblox Studio Plugin. A IA cria e modifica diretamente instâncias, scripts, propriedades, terreno e muito mais dentro do Studio, e as alterações são refletidas imediatamente no Studio e no painel para que você veja exatamente o que mudou.
O WEPPY também é feito para experiências Roblox divididas em vários Places. Abra até cinco janelas do Studio para Lobby, Game, Shop, Tutorial ou outros Places e diga ao agente qual Studio ID usar. Uma única solicitação pode atualizar vários Places sem reexplicar o contexto ou copiar alterações manualmente.
Para assets, um agente pode criar ou preparar uma imagem, salvá-la na Asset Library, enviá-la pelo Roblox Open Cloud e aplicar o URI do asset retornado a um Place. O resultado é um caminho mais curto entre "crie este ícone/decal" e "ele está visível no Studio".
Sem copiar e colar código ou IDs de assets. A IA faz o trabalho, você revisa os resultados.
Instalação Rápida
Comece pela página de instalação web. Ela mostra o script de uma linha recomendado para sua plataforma primeiro.
Instalação Recomendada de Uma Linha
Na página de instalação, copie o script de uma linha e execute-o no Terminal ou no PowerShell.
macOS / Linux
curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
Windows (PowerShell)
irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
Em seguida, reabra seu aplicativo de IA e reinicie o Roblox Studio.
O registro automático do WEPPY MCP Server suporta Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI e Antigravity / Antigravity IDE / Antigravity CLI.
Para Claude Code, o instalador também instala o WEPPY AI Agent Plugin. Para Codex, ele adiciona o marketplace de plugins e depois pede que você instale o WEPPY AI Agent Plugin pelo Plugin Directory. Para Antigravity, o plugin de agente de IA é instalado somente quando o Antigravity CLI e o agy plugin estão disponíveis; caso contrário, o instalador preserva a conexão MCP direta.
Instalação Web pelo Navegador
Se o terminal ou o PowerShell não for confortável, use o instalador web sem terminal na mesma página de instalação.
Instalação Manual
Se a instalação de uma linha ou o instalador web sem terminal não funcionar, registre o WEPPY MCP Server manualmente com seu aplicativo de IA.
Use este comando de servidor:
npx -y @weppy/roblox-mcp@latest
Os aplicativos de IA suportados são Claude Code, Claude Desktop, Cursor, Codex CLI, Codex App, Gemini CLI e Antigravity / Antigravity IDE / Antigravity CLI.
Qualquer cliente de IA compatível com MCP funciona. O comando do servidor é
npx -y @weppy/roblox-mcp@latest.
Plugin Opcional WEPPY AI Agent
O WEPPY Roblox AI Toolkit conecta-se a todos os aplicativos de IA suportados por meio do WEPPY MCP Server. Claude Code, Codex e Antigravity podem instalar adicionalmente o WEPPY AI Agent Plugin para configuração nativa do cliente e orientação de fluxo de trabalho para controle do Studio, sincronização e assets.
Claude Code
claude plugin marketplace add hope1026/weppy-roblox-mcp --scope user
claude plugin install weppy-roblox-ai-toolkit@hope1026-roblox-mcp --scope user
Codex
codex plugin marketplace add hope1026/weppy-roblox-mcp
Após adicionar o marketplace do Codex, reinicie o Codex, abra o Plugin Directory e instale o WEPPY AI Agent Plugin.
Antigravity
O Antigravity CLI é necessário para instalar o WEPPY AI Agent Plugin. O instalador de uma linha usa agy plugin install com o release público mais recente do GitHub, verifica-o com agy plugin list e publica o payload verificado somente de skills nas superfícies de IDE suportadas. As instalações existentes são substituídas a cada execução para que possam convergir para o release mais recente.
O instalador relata resultados como instalado, atualizado, reinstalado, reparado, fallback, falhou ou ignorado. A ausência do CLI mantém a conexão MCP compartilhada em ~/.gemini/config/mcp_config.json funcionando e relata fallback; um plugin existente nunca é tratado como ignorado. Em um perfil somente CLI, o MCP de plugin nativo verificado substitui a entrada WEPPY direta compartilhada. Quando o Antigravity IDE e o CLI coexistem, ambas as visualizações de plugin permanecem somente skills e uma definição weppy-roblox-mcp direta compartilhada atende a ambos. Fora da matriz verificada de SO e versão, a descoberta nativa usa o fallback MCP.
No Antigravity para Windows, a instalação do CLI foi verificada para expor skills e MCP. A descoberta de plugin do Antigravity IDE para Windows não é verificada porque o ambiente verificado não tem UI de inspeção de plugins ou skills, então o fallback MCP compartilhado é preservado. URLs do GitHub não são passadas diretamente para agy plugin install; o instalador baixa o release público mais recente e instala a partir de um caminho local preparado.
Compatibilidade
| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI | Antigravity / Antigravity IDE / Antigravity CLI |
|---|---|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Requisitos: Node.js 18+, Roblox Studio, Windows 10+ ou macOS 12+
O Que Ele Faz
1) Ferramentas MCP: Execução direta no Studio a partir de linguagem natural
A IA pode lidar diretamente com scripts, instâncias, propriedades, terreno, iluminação, assets, áudio e animação dentro do Studio.
- "Adicione partículas + som + cooldown quando o jogador pular."
- "Construa uma arena de chefe no centro do mapa e coloque pontos de spawn seguros contra colisão."
- "Altere esta interface de módulo e atualize todos os scripts dependentes."
- "Gere terreno com montanhas e rios e coloque pontos de spawn em áreas planas."
- "Pesquise na Creator Store um modelo de espada e insira-o no StarterPack."
2) Trabalho multi-Place: Divida uma solicitação entre várias janelas do Studio
Muitas experiências Roblox não são um único Place. O WEPPY permite manter até cinco janelas do Studio conectadas a um servidor MCP e rotear o trabalho por Studio ID.
- Abra até cinco janelas do Roblox Studio, como Lobby, Game, Shop ou Tutorial
- Peça uma vez: "No studio-1, adicione o portal de eventos ao Lobby. No studio-2, adicione o ponto de chegada e a UI de guia ao Game."
- Use o Dashboard Connection para ver cada agente de IA, Studio Target, Studio ID copiável e estado de roteamento
- Trabalhe com o fluxo multi-Studio também documentado pelo guia oficial de Studio MCP da Roblox, com a visibilidade do painel do WEPPY por cima
3) Assets: Gere, envie e aplique imagens no Studio
O WEPPY Assets transforma uma solicitação de asset em linguagem natural em um resultado pronto para o Studio.
- "Crie um ícone de gema para o botão da loja, envie-o para o Roblox e aplique-o na imagem ShopButton no Place do Lobby."
- Salve imagens geradas, Decals e arquivos RBXM na Asset Library local
- Envie imagens pelo Roblox Open Cloud e reutilize assets específicos de Place ou compartilhados
- Aplique o URI do asset retornado a ImageLabel, Decal, Texture ou outras propriedades do Studio
4) Sincronização: Mantenha o contexto completo do projeto estável para a IA
A IA trabalha a partir de um espelho local sincronizado, para que atualizações de vários arquivos permaneçam consistentes.
- Básico: sincronização unidirecional (Studio -> Local)
- Pro: sincronização bidirecional + Modo de Direção/Aplicação por tipo + histórico + até cinco Places
5) Validação de Sintaxe Luau: Detecte scripts quebrados antes do Playtest
A IA pode verificar código-fonte Luau bruto ou um Script existente em busca de erros de sintaxe sem iniciar o jogo. A validação autônoma está disponível no Básico e no Pro.
- Peça à IA para validar o código-fonte ou um caminho de Script para receber todos os diagnósticos de sintaxe em uma resposta
- Ative Controls → Luau Syntax Validation para verificar o código-fonte salvo real após gravações de script suportadas; o padrão é Desligado
- A configuração do Dashboard é aplicada. Se uma chamada de ferramenta solicitar um valor diferente de
validate, a gravação segue a política do Dashboard e retorna um aviso com o caminho da configuração - Verificações válidas automáticas mantêm a resposta de gravação normal inalterada. Verificações inválidas ou indisponíveis adicionam detalhes, enquanto um
validate=truecorrespondente explícito também retorna detalhes válidos completos - Um erro de sintaxe ou parser indisponível nunca reverte uma gravação de script bem-sucedida
A primeira validação que precisa do parser complementar baixa o release WASM exato do luau-parser-v1.0.0 e o armazena em cache localmente. Um luau-compile local compatível pode ser usado como fallback. O código-fonte do script é analisado no seu computador e não é enviado a um serviço remoto de validação; a solicitação de download busca apenas o artefato do parser. Scripts muito grandes podem adicionar algum tempo de leitura e análise.
6) Playtest: Deixe a IA executar e verificar testes automaticamente
A IA pode controlar playtests do Roblox Studio diretamente. Ela pode iniciar e parar o Play (F5) ou Run (F8), injetar scripts de teste, coletar logs e gerar relatórios locais automaticamente.
- "Inicie um playtest em modo Run e verifique se o NPC alcança o alvo."
- "Escreva um teste que verifique se o SpawnLocation está acima do chão e execute-o."
- "Valide que o script que acabei de alterar roda sem erros no playtest."
7) UI Studio: Crie e inspecione UI no jogo
O UI Studio permite que agentes de IA criem UI no jogo que combine com o estilo do seu jogo, ou analisem a UI que você já tem e sugiram melhorias.
- Esclareça o objetivo da UI com perguntas guiadas sobre propósito, tela, dispositivos-alvo e direção visual
- Crie ou refine menus, HUDs, botões, rótulos, painéis de imagem e outros elementos de UI Roblox no estilo do jogo diretamente no Studio
- Capture o resultado, compare alterações antes/depois e siga as sugestões do painel para layout, legibilidade, alvos de toque e áreas seguras
8) WEPPY Dashboard: Monitore o trabalho da IA em tempo real
O servidor MCP fornece um painel web onde você pode verificar o status da conexão, o histórico de execução de ferramentas, o estado da sincronização, o histórico do UI Studio e os logs de alterações do jogo em tempo real.
- Topologia de conexão para agentes de IA, servidor MCP e janelas do Roblox Studio conectadas
- Studio Targets com Studio IDs copiáveis, selos de Prioridade/Fixados e um link para controles de roteamento
- Fluxos de trabalho multi-agente e multi-Studio: mantenha vários agentes e até cinco janelas do Studio visíveis e diga ao agente qual Studio ID usar
- Página de Assets para itens da biblioteca local, assets compartilhados e status de envio ao Roblox
- Página de Controls para aplicar validação de sintaxe Luau pós-gravação, incluindo comportamento claro de Ligado e Desligado
- Compare cada alteração feita pela IA com Antes & Depois no Changelog
- Analise o fluxo de trabalho com histórico de execução de ferramentas, capturas do UI Studio e estatísticas
9) WEPPY Roblox Explorer: Navegue pela hierarquia do Studio no VSCode
Veja a árvore completa de instâncias do seu Place do Roblox Studio diretamente no VSCode. Navegue por serviços, abra scripts sincronizados e arquivos de propriedades e acompanhe o status da sincronização — tudo sem alternar para o Studio. O WEPPY Roblox Explorer é uma extensão complementar do VSCode para dados de sincronização gerados pelo WEPPY. A navegação em árvore funciona a partir de arquivos sincronizados, e o estado de sincronização ao vivo ou indicadores de direção são aprimorados quando o servidor MCP local está em execução. Instale pelo VS Code Marketplace ou Open VSX.
- Ícones de classe correspondentes ao Studio para reconhecimento instantâneo
- Clique para abrir scripts sincronizados e arquivos de propriedades
- Suporte a múltiplos Places com indicadores de status de sincronização para até cinco Places
Casos de Uso
- Prototipagem rápida: Descreva uma mecânica de jogo em linguagem natural e veja a IA construí-la no Studio
- Produção multi-lugar: Mantenha o Lobby e o Jogo abertos em janelas separadas do Studio e atualize ambos a partir de uma única solicitação
- Refatoração em massa: Renomeie uma interface de módulo e atualize todos os scripts dependentes em uma única solicitação
- Terreno e ambiente: Gere terreno procedural, configure iluminação/atmosfera, posicione assets — tudo a partir de um único prompt
- Design de UI: Gere UI no jogo, capture prévias e itere com base nas sugestões do Design Check
- Consistência multi-arquivo: A IA lê o projeto completo via Sync e aplica mudanças em scripts relacionados de uma só vez
- Integração de assets gerados: Crie um ícone ou decalque, envie-o para o Roblox, aplique-o a uma propriedade de UI ou Decal e mantenha o asset para reutilização
Por que isso importa
- Comprima trabalho repetitivo: transforme muitas edições manuais em uma única solicitação
- Trabalhe em até cinco Places sem reexplicar contexto ou copiar mudanças entre janelas do Studio
- Transforme imagens geradas em assets Roblox aplicados sem mover arquivos e IDs de asset manualmente
- Altere arquivos relacionados juntos: não apenas um único arquivo-alvo
- Menor risco: confie no estado de sync e no histórico antes de aplicar mudanças
- Melhor eficiência de tokens (Pro): reduza idas e voltas com ações em massa
Documentação
Guias detalhados e configuração específica por aplicativo agora estão disponíveis na web.
Para detalhes de configuração do aplicativo, abra a central de documentação web e escolha o guia relevante do cliente de IA.
Privacidade e Telemetria
A WEPPY usa telemetria do Google Analytics 4 Measurement Protocol e uma observação anônima de operações por dispositivo, com melhor esforço, para entender o uso do produto, confiabilidade, cobertura de plataformas e adoção de recursos. A telemetria pode ser desativada definindo ENABLE_TELEMETRY=false ou ENABLE_TELEMETRY=0 no ambiente do servidor MCP.
A WEPPY não coleta seu nome, endereço de e-mail, chave de licença bruta, caminhos de arquivos locais, código-fonte de scripts ou conteúdos de projetos Roblox por meio de telemetria.
Consulte PRIVACY.md para o aviso completo de telemetria.
FAQ
Como conecto o Claude Code ao Roblox Studio?
Instale pela página de instalação web para registrar o WEPPY MCP Server e instalar o WEPPY Roblox Studio Plugin. Você também pode adicionar o WEPPY AI Agent Plugin para Claude Code com os comandos acima. O comando MCP dele permanece npx -y @weppy/roblox-mcp@latest.
Como uso o Codex CLI com o Roblox Studio?
Instale o WEPPY Roblox Studio Plugin e adicione a configuração do WEPPY MCP Server ao Codex CLI. Você também pode adicionar o marketplace de plugins do Codex e instalar o WEPPY AI Agent Plugin pelo Plugin Directory.
O Roblox MCP funciona com o Cursor?
Sim. Qualquer cliente de IA compatível com MCP funciona.
A IA pode criar jogos Roblox com isso?
Sim. A IA pode criar instâncias, escrever scripts, gerar terreno, configurar iluminação, inserir assets, configurar física e muito mais — tudo dentro de uma sessão ativa do Roblox Studio. Vai além da geração de código, chegando a ações executáveis.
Qual é a diferença entre Basic e Pro?
Basic (Grátis) inclui execução de ferramentas MCP e sync unidirecional (Studio -> Local). O Pro adiciona trabalho multi-lugar em até cinco Places, Asset Library com upload para Roblox, sync bidirecional, UI Studio, operações em massa, geração de terreno, análise espacial e controle de áudio/animação. Consulte a página de upgrade Pro.
Como o Weppy é diferente de outros servidores MCP para Roblox?
O Weppy usa despacho baseado em ações em vez de ferramentas separadas para cada função. Isso reduz significativamente o consumo de tokens da IA. Também combina trabalho multi-lugar baseado em ID do Studio, upload/aplicação de assets gerados, sync bidirecional de projetos e controle de Playtest.
É seguro? A IA pode quebrar meu jogo?
O servidor roda apenas em localhost (127.0.0.1:3002). Caminhos proibidos (CoreGui, CorePackages) são bloqueados. Limite de taxa (450 req/min) e timeouts de 30 segundos evitam operações descontroladas. Todas as mudanças são rastreáveis pelo histórico de sync.
Upgrade Pro
Trabalho multi-lugar, assets gerados para Roblox, Sync bidirecional, UI Studio, controle de Playtest e eficiência de tokens da IA — tudo em um único upgrade.
Licença
Este repositório é licenciado sob AGPL-3.0.
Licenciamento comercial está disponível separadamente. Consulte COMMERCIAL-LICENSE.md.
O uso do nome e logotipos Weppy é regido por TRADEMARKS.md.
