# Vibe Coding com IA

Crie cenas de 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 que você vá de uma ideia a uma cena em execução em minutos, em vez de horas.

{% hint style="info" %}
**💡 Dica**: Você não precisa saber TypeScript para começar. Assistentes de IA podem gerar código de cena funcional a partir de descrições em linguagem natural.
{% endhint %}

## O que é Vibe Coding?

Vibe coding significa construir cenas 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 implantável.

Essa abordagem funciona em qualquer nível de habilidade:

* **Iniciantes e não desenvolvedores** — Vá do zero a uma cena funcional sem escrever código manualmente.
* **Desenvolvedores experientes** — Pule o boilerplate. Deixe a IA lidar com a sincronização multiplayer, a estrutura da UI e a configuração de deploy enquanto você foca nas decisões criativas.
* **Equipes e estúdios** — Prototipe conceitos de cena rapidamente antes de comprometer recursos completos de desenvolvimento.

## Combine um editor de código com IA

Use um editor de código de IA de uso geral como [Cursor](https://www.cursor.com/) ou VS Code com GitHub Copilot ou Claude AI. Decentraland fornece uma pasta de contexto para que essas ferramentas entendam o SDK.

1. Abra o Creator Hub e crie ou abra uma cena.
2. Clique no **< > CODE** botão para abrir seu editor de código.
3. Use o assistente de IA integrado do 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 de Decentraland. Cada skill cobre um tópico específico, como criar cenas, 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 já no primeiro prompt.

```bash
# Instale todas as skills de Decentraland
npx skills add decentraland/sdk-skills

# Ou escolha skills específicas
npx skills add decentraland/sdk-skills --skill create-scene

# Instale globalmente (disponível em todos os projetos)
npx skills add decentraland/sdk-skills -g
```

Isso copia os arquivos de skill para a configuração do seu agente para que ele conheça os padrões e as restrições de Decentraland.

## Skills de IA disponíveis

Quando você instala skills no seu agente, as seguintes capacidades ficam disponíveis:

| Skill                  | O que ela faz                                                                    |
| ---------------------- | -------------------------------------------------------------------------------- |
| `sdk-scenes`           | Ponto de entrada com diretrizes do agente e índice de todas as skills de tópicos |
| `create-scene`         | Estruturar um novo projeto de cena SDK7 do zero                                  |
| `add-3d-models`        | Adicionar modelos 3D (`.glb`/`.gltf`) com posicionamento, escala e colliders     |
| `add-interactivity`    | Eventos de pointer, triggers, raycasts                                           |
| `build-ui`             | UI em espaço 2D de tela 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 rede CRDT                                        |
| `authoritative-server` | Servidor autoritativo headless para multiplayer (BETA)                           |
| `audio-video`          | Efeitos sonoros, música, streaming de áudio e players de vídeo                   |
| `deploy-scene`         | Deploy de cenas para Genesis City (baseado em LAND)                              |
| `deploy-worlds`        | Deploy de cenas para Worlds (espaços 3D pessoais)                                |
| `optimize-scene`       | Otimização de desempenho, limites de cena, melhores práticas                     |
| `camera-control`       | Detecção de modo de câmera, câmera cinematográfica, câmeras virtuais             |
| `composites`           | Referência do formato de arquivo Composite para conteúdo estático de cena        |
| `lighting-environment` | Iluminação dinâmica, sombras, skybox, neblina, configurações de ambiente         |
| `npcs`                 | Personagens não jogáveis — biblioteca NPC Toolkit e abordagens manuais           |
| `player-avatar`        | Posição do player, perfil, personalização de avatar, anexos                      |
| `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 sistema e controle de movimento do player           |
| `scene-runtime`        | APIs de runtime transversais — trabalho assíncrono, HTTP, mensagens              |
| `script-components`    | Classes de componentes de script para o Creator Hub                              |
| `game-design`          | Padrões de game design, limites de cena, orçamentos de desempenho                |

Observação: algumas dessas skills envolvem buscar modelos 3D ou outros assets de catálogos de assets gratuitos. O agente de IA deve sempre obter confirmação do usuário antes de baixar quaisquer novos assets para um projeto de cena.

## Dicas para um Prompting Eficaz

Obter os melhores resultados da IA tem a ver com dar prompts claros e específicos. Aqui estão algumas dicas:

### Seja específico sobre o que você quer

Em vez de:

> "Torne minha cena melhor"

Tente:

> "Adicione uma porta na posição (8, 0, 8) que se abra com uma animação de rotação quando clicada e reproduza um efeito sonoro de ranger"

### Faça referência a itens existentes

> "Faça o botão vermelho na mesa acionar o elevador para subir"

### Peça uma coisa de cada vez

Divida pedidos complexos em etapas:

1. "Adicione uma UI de placar no canto superior direito"
2. "Adicione um contador que aumente quando o player clicar no alvo"
3. "Exiba o valor do contador no placar"

### Inclua restrições

> "Adicione música de fundo que faça loop, mas mantenha o tamanho do arquivo abaixo de 1 MB"

### Itere e refine

Após cada alteração:

1. Faça o preview da cena (clique **Preview** no Creator Hub, ou `npm run start` na linha de comando)
2. Verifique o que funciona e o que não funciona
3. Diga à IA o que ajustar: "Mova o NPC 2 metros para a esquerda e faça-o olhar para o player"

## No que a IA Pode Ajudar

* Estruturar novas cenas a partir de uma descrição
* Adicionar e posicionar modelos 3D
* Escrever handlers de clique e interatividade
* Construir UI (HUDs, menus, diálogos)
* Configurar sincronização multiplayer
* Configurar servidores autoritativos para anti-cheat
* Adicionar áudio, vídeo e streaming
* Criar animações e tweens
* Otimizar o desempenho da cena
* Preparar cenas para deploy
* Depurar problemas em código existente

## Limitações

Embora as ferramentas de IA sejam poderosas, tenha estes pontos em mente:

* **Sempre faça preview** — O código gerado por IA pode não ficar exatamente como você espera. Execute um preview para verificar.
* **Os limites da cena ainda se aplicam** — A IA não pode contornar os [limitações da scene](/creator/content-creator-pt/scenes-sdk7/otimizacao/scene-limitations.md) de Decentraland (contagem de triangles, tamanhos de arquivo, limites de parcel).
* **Lógica de jogo complexa** — Para mecânicas de jogo complexas, 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.

## Próximos Passos

* [Início Rápido do SDK](/creator/content-creator-pt/scenes-sdk7/comecar/sdk-101.md) — Aprenda os fundamentos do SDK7
* [Combine com Código](/creator/content-creator-pt/scene-editor/expandir-com-codigo/overview.md) — Misture edição visual com código
* [Servidores autorizados](/creator/content-creator-pt/scenes-sdk7/networking/authoritative-servers.md) — Multiplayer autoritativo por servidor
* [Exemplos de Cenas](https://studios.decentraland.org/resources?sdk_version=SDK7) — Navegue por cenas de exemplo para se inspirar


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/comecar/vibe-coding.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
