Vibe Coding com IA
Crie scenes do Decentraland com assistentes de IA usando o Creator Hub e o SDK Skills oficial do Decentraland (npx skills add decentraland/sdk-skills).
Crie scenes do Decentraland descrevendo o que você quer. Um assistente de IA lida com o código SDK7, a arquitetura ECS e a estrutura do projeto para você.
Seja você um criador de primeira viagem ou um desenvolvedor experiente, o "vibe coding" assistido por IA permite passar de uma ideia para uma scene em execução em minutos em vez de horas.
O que é Vibe Coding?
Vibe coding significa construir scenes conversando com um assistente de IA em vez de escrever cada linha de código manualmente. Você descreve o que quer — "uma taverna medieval com portas clicáveis e música de fundo" — e a IA escreve código SDK7 correto e pronto para deploy.
Essa abordagem funciona em qualquer nível de habilidade:
Iniciantes e não desenvolvedores — Vá do zero a uma scene funcional sem escrever código manualmente.
Desenvolvedores experientes — Pule o boilerplate. Deixe a IA cuidar da sincronização multiplayer, da estruturação da UI e da configuração de deploy enquanto você se concentra nas decisões criativas.
Equipes e estúdios — Prototipe rapidamente conceitos de scene antes de comprometer recursos completos de desenvolvimento.
Use o Assistente de IA no Creator Hub
A maneira mais rápida de começar é o Creator Hub integrado Assistente de IA. Ele vê sua scene aberta, edita entities, components, smart items e código para você, e pode executar a preview para verificar seu próprio trabalho. Ele instala automaticamente as skills abaixo no seu projeto, então não há nada a configurar além de fazer login em uma CLI de programação.
É um recurso experimental, desativado por padrão.
Combine um editor de código com IA
Use um editor de código de IA de uso geral como Cursor ou o VS Code com GitHub Copilot ou Claude AI. O Decentraland fornece uma pasta de contexto para que essas ferramentas entendam o SDK.
Abra o Creator Hub e crie ou abra uma scene.
Clique no < > CODE botão para abrir seu editor de código.
Use o assistente de IA integrado ao editor (chat do Cursor, Copilot etc.) para gerar ou modificar código.
Instale Skills para qualquer agente de IA
Skills são conjuntos de instruções prontos que ensinam seu agente de IA a trabalhar com o SDK do Decentraland. Cada skill cobre um tópico específico, como criar scenes, adicionar modelos 3D ou configurar multiplayer, então a IA já conhece os padrões, APIs e restrições corretos sem que você precise explicá-los. Instalar skills significa menos erros e melhores resultados desde o primeiro prompt.
Isso copia os arquivos de skill para a configuração do seu agente, para que ele conheça os padrões e restrições do Decentraland.
Atualizando Skills
Novas skills são adicionadas ao longo do tempo, e as existentes são aprimoradas. Para obter as versões mais recentes, execute novamente o comando de instalação com --all:
Executar add novamente busca o repositório, então atualiza as skills que você já tem e instala quaisquer que tenham sido adicionadas desde a sua primeira instalação. Se você instalou skills globalmente, adicione -g a este comando também.
Skills de IA disponíveis
Quando você instala skills no seu agente, as seguintes capacidades ficam disponíveis:
sdk-scenes
Ponto de entrada com diretrizes para o agente e índice de todas as skills temáticas
create-scene
Estruture um novo projeto de scene SDK7 do zero
migrate-sdk6-to-sdk7
Migre uma scene legada do SDK6 para SDK7
add-3d-models
Adicione modelos 3D (.glb/.gltf) com posicionamento, escala, colliders
add-interactivity
Eventos de Pointer, triggers, raycasts
build-ui
UI em espaço de tela 2D com React-ECS — HUDs, menus, diálogos
animations-tweens
Animações de modelos GLTF com Animator, tweens do SDK
multiplayer-sync
Multiplayer peer-to-peer usando networking CRDT
authoritative-server
Headless Multiplayer Server para scenes validadas pelo server (BETA)
audio-video
Efeitos sonoros, música, streaming de áudio e players de vídeo
audio-analysis
Dados de amplitude e frequência em tempo real para scenes reativas a áudio
deploy-scene
Faça deploy de scenes para Genesis City (baseado em LAND)
deploy-worlds
Faça deploy de scenes para Worlds (espaços 3D pessoais)
optimize-scene
Otimização de performance, limites de scene, melhores práticas
camera-control
Detecção de modo de camera, camera cinematográfica, câmeras virtuais
composites
Referência do formato de arquivo Composite para conteúdo estático de scene
lighting-environment
Iluminação dinâmica, sombras, skybox, neblina, configurações de ambiente
particle-system
Efeitos de partículas — fogo, fumaça, faíscas, neve, fogos de artifício
npcs
Personagens não jogáveis — biblioteca NPC Toolkit e abordagens manuais
player-avatar
Posição do player, perfil, personalização do avatar, attachments
player-physics
Forças físicas — impulsos, knockback, forças contínuas
nft-blockchain
Exibição de NFT e interações com blockchain/cripto
advanced-rendering
Billboard, TextShape, materiais PBR, materiais de vídeo
advanced-input
Leitura de input em nível de system e controle de movimento do player
scene-runtime
APIs de runtime transversais — trabalho async, HTTP, messaging
script-components
Classes de component script para o Creator Hub
game-design
Padrões de game design, limites de scene, orçamentos de performance
unity-explorer-mcp
Controle um Explorer em execução para testar e verificar uma scene no mundo
Observação: algumas dessas skills envolvem buscar modelos 3D ou outros assets em catálogos gratuitos de assets. O agente de IA deve sempre obter confirmação do usuário antes de baixar quaisquer novos assets para um projeto de scene.
Deixe a IA ver sua scene no mundo
Normalmente a IA escreve código e você executa a preview, olha para ela e relata o que está errado. O cliente desktop do Decentraland pode fechar esse ciclo: ele vem com um opcional MCP server que permite a um agente de IA observar e controlar diretamente o Explorer em execução. O agente tira seus próprios screenshots, lê a saída do console da scene, movimenta o player, clica em objetos e verifica se a scene realmente faz o que foi solicitado — depois corrige o que encontrar e olha novamente.
Isso transforma o vibe coding de "descreva, espere, revise" em um loop que o agente pode executar quase sozinho.
O que você precisa
O cliente desktop do Decentraland instalado (o mesmo que o Creator Hub abre para previews).
Um agente de IA que possa se conectar a MCP servers via HTTP — Claude Code, Cursor, Cline, VS Code com uma extensão compatível com MCP e outros.
Um SDK atualizado na sua scene: execute
npm i @dcl/sdk@latestse a--mcpflag abaixo for rejeitada como uma opção desconhecida.
1. Inicie a scene com o MCP server ativado
Na pasta da sua scene:
Isso faz o que npm run start sempre faz — serve sua scene em http://127.0.0.1:8000 e faz hot-reload sempre que você salva um arquivo — e também inicia o cliente desktop com o MCP server ouvindo em http://127.0.0.1:8123/unity-explorer-mcp.
Faça login quando o cliente abrir. O agente só pode começar a trabalhar depois que você passar pela tela de login e o mundo carregar.
2. Conecte seu agente de IA ao server
Em Claude Code, registre-o uma vez:
Em qualquer outro cliente MCP, adicione o server da forma documentada por esse cliente, usando estes detalhes:
Transporte
Streamable HTTP (não stdio — não há comando para executar, o server vive dentro do cliente em execução)
URL
http://127.0.0.1:8123/unity-explorer-mcp
Autenticação
Nenhum
Nome
explorer
Muitos clientes usam um arquivo de configuração JSON para isso (.cursor/mcp.json, mcp.json, e similares — consulte a documentação do seu cliente para os nomes exatos das chaves):
Reinicie ou recarregue seu cliente de IA após registrar o server, para que ele carregue a conexão. Se o agente disser que as ferramentas do Explorer não estão disponíveis, a causa usual é que o cliente não estava em execução quando o agente iniciou — reconecte o server (no Claude Code, execute /mcp) com o Explorer aberto.
3. Peça o que você quer e deixe que ele verifique
Com o server conectado, peça tarefas como faria normalmente — a diferença é que o agente agora pode verificar seus próprios resultados:
"Adicione uma caixa de tesouro no centro da parcel que se abra quando clicada, depois vá até lá e clique nela para confirmar que a tampa anima."
"A placa neon parece fraca demais. Tire uma screenshot, ajuste a intensidade emissiva e me mostre um antes/depois."
"Tem algo errado com o elevador. Suba na plataforma, observe os logs e me diga por que ele não se move."
Nos bastidores, o agente pode:
Veja — tirar screenshots, ler a
console.logsaída e os erros do console, verificar se a scene carregou ou travou, listar as entities da scene e inspecionar seus components, e ler a posição do player e da camera.Controlar — mover e teletransportar o player, caminhar em uma direção através de colisões reais, apontar a camera, posicionar uma camera livre para um enquadramento específico, trocar os modos de camera, clicar em objetos da scene, enviar mensagens de chat e
/commands, acionar emotes e recarregar a scene.Medir — ler contagens em tempo real do conteúdo da scene (triangles, entities, textures, materials e mais) em relação aos limites do Decentraland, classificar quais modelos 3D mais contribuem para essa carga a partir de qualquer ponto de vista e medir a taxa de quadros real que o player experimenta em qualquer local.
Use isso para otimizar sua scene
Como o agente pode medir assim como ver, você pode entregar diretamente a ele o trabalho de performance. Ele pode verificar sua scene em relação aos limitações da scene, identificar quais modelos 3D são os mais pesados, medir a taxa de quadros em pontos específicos e, o mais importante, medir novamente após fazer alterações para provar que elas ajudaram:
"Verifique se minha scene está dentro dos limites de conteúdo do Decentraland e me diga qual orçamento está mais próximo do limite."
"A scene parece engasgar perto da fonte. Fique lá, meça a taxa de quadros e me diga quais modelos custam mais a partir desse ponto."
"Otimize a scene: descubra o que está derrubando a taxa de quadros, corrija isso e me mostre medições antes e depois."
Para obter os melhores resultados, instale o optimize-scene skill juntamente com unity-explorer-mcp, para que o agente também conheça as melhores práticas de otimização do Decentraland. Veja Otimização de desempenho para mais detalhes sobre este fluxo de trabalho, incluindo como combiná-lo com o Blender MCP server para automatizar correções nos próprios modelos 3D.
Dicas
Peça provas, não afirmações. "Verifique com uma screenshot" ou "confirme pelos logs" é o que faz esse fluxo valer a pena. Um bom agente cruza ambas as coisas: pixels podem parecer certos enquanto o estado subjacente está quebrado, e o contrário também.
Screenshots consomem tokens. Cada screenshot que o agente analisa consome parte do seu contexto. Se você quiser uma varredura visual longa — uma animação ao longo do tempo, um walkthrough de muitos pontos — peça para ele capturar frames em arquivos e ler apenas os que importam. A
unity-explorer-mcpskill inclui um script que faz exatamente isso.Salve uma vez, não cinco vezes seguidas. Salvamentos sucessivos rápidos podem fazer o cliente carregar um bundle parcialmente escrito e derrubar a scene por completo, o que exige reiniciar o cliente para se recuperar. Peça ao agente para agrupar suas edições em um único save.
Mantenha o cliente aberto. Se você o fechar, a conexão cai e o agente perde seus olhos. Reiniciá-lo com o mesmo comando o traz de volta.
Teleports se comportam de forma diferente no desenvolvimento local de scene. Mover-se entre parcels com
/gotonão é permitido lá, então o agente deve reposicionar o player dentro da scene em vez de teleportá-lo.
Dicas para Prompting Eficaz
Obter os melhores resultados da IA tem a ver com fornecer prompts claros e específicos. Aqui estão algumas dicas:
Seja específico sobre o que você quer
Em vez de:
"Melhore minha scene"
Tente:
"Adicione uma porta na posição (8, 0, 8) que se abra com uma animação de rotação quando clicada, e toque um efeito sonoro de rangido"
Consulte itens existentes
"Faça o botão vermelho na mesa acionar o elevador para subir"
Peça uma coisa por vez
Divida pedidos complexos em etapas:
"Adicione uma UI de scoreboard no canto superior direito"
"Adicione um contador que aumente quando o player clicar no alvo"
"Exiba o valor do contador no scoreboard"
Itere e refine
Após cada alteração:
Faça a preview da scene (clique Play no Creator Hub, ou
npm run startna linha de comando)Verifique o que funciona e o que não funciona
Diga à IA o que ajustar: "Mova o NPC 2 metros para a esquerda e faça-o olhar para o player"
Exemplos de prompts
Para ser executado em um clone limpo de sdk7-scene-template.
Exemplo de prompt 1
Exemplo de prompt 2
Com o que a IA pode ajudar
Estruturar novas scenes a partir de uma descrição
Adicionar e posicionar modelos 3D
Escrever handlers de click e interatividade
Construir UI (HUDs, menus, diálogos)
Configurar a sincronização multiplayer
Configurar o Multiplayer Server para anti-cheat
Adicionar áudio, vídeo e streaming
Criar animações e tweens
Otimizar a performance da scene
Preparar scenes para deploy
Depurar problemas em código existente
Testar e verificar visualmente uma scene em um Explorer em execução (veja Deixe a IA ver sua scene no mundo)
Limitações
Embora as ferramentas de IA sejam poderosas, tenha isto em mente:
Sempre faça preview — o código gerado por IA pode não parecer exatamente como você espera. Execute uma preview para verificar.
Os limites da scene continuam valendo — a IA não pode contornar os limitações da scene (contagens de triangles, tamanhos de arquivo, limites de parcel).
Lógica de jogo complexa — Para mecânicas de jogo intrincadas, talvez você precise orientar a IA passo a passo ou refinar a saída manualmente.
Modelos 3D personalizados — a IA pode referenciar assets gratuitos existentes ou carregar modelos que você fornecer, mas não pode criar modelos 3D do zero (a menos que você use outras ferramentas como o Blender official MCP server ao mesmo tempo).
Próximos passos
SDK Quick Start — Aprenda os fundamentos do SDK7
Combine com código — Misture edição visual com código
Multiplayer Server — Multiplayer com server autoritativo
Exemplos de scenes — Navegue por scenes de exemplo em busca de inspiração
Recursos Úteis — Mais ferramentas de IA, bibliotecas de assets e addons para acelerar seu workflow
Atualizado