Combinar com código
Combine conteúdo criado no Scene Editor com o poder de escrever código.
O Creator Hub mais código customizado é uma combinação muito poderosa para criar conteúdo. Você pode usar a tela para posicionar visualmente os itens de forma intuitiva e, em seguida, escrever código que interaja com esses itens com total liberdade. Você pode até colocar um smart item, que tem seu próprio comportamento padrão, e escrever código que reaja quando o item for ativado.
Por exemplo, você pode aproveitar um smart item de alavanca existente, que já vem com seus sons, animações e estados, e escrever código que detecte quando a alavanca é puxada para executar sua própria lógica personalizada.
Veja Referenciar itens no código para saber como obter itens por nome ou por tags a partir do seu código.
Editando código
Você deve instalar um editor de código na sua máquina para editar o código da sua cena. As opções recomendadas são:
Visual Studio Code: Esta é a opção recomendada para desenvolvedores experientes.
Cursor AI: Este é um editor de código poderoso integrado com IA. Ele permite escolher diferentes modelos de IA para ajudar a escrever código, todos gratuitos. É uma boa opção para desenvolvedores que são novos no Decentraland ou em TypeScript, ou se você quiser economizar tempo escrevendo código.
📔 Observação: Se você estiver no macOS, certifique-se de que o aplicativo do editor de código esteja no diretório Applications.
Uma vez instalado, pode ser necessário selecionar seu Editor de Código nas configurações do Creator Hub. Para fazer isso,
Abra o ícone da engrenagem no canto superior direito da tela
Em Code editor of choice, selecione seu Editor de Código. Você pode encontrar seu editor listado no dropdown, ou pode ser necessário selecionar Escolher do seu dispositivo para encontrá-lo.
Abrir o código de uma cena
Depois de instalar um editor de código na sua máquina e selecioná-lo nas configurações do Creator Hub, você pode clicar no < > CODE botão para abri-lo no projeto da sua cena.
Isso abre uma janela separada com o editor de código. Na margem esquerda você pode navegar pelos arquivos e pela estrutura de pastas do seu projeto.
Adicione seu código customizado em index.ts arquivo sob /src, dentro da função main() . Você também pode adicionar código customizado fora dessa função ou criar novos .ts arquivos dentro da /src pasta, mas estes devem ser de alguma forma referenciados dentro da função main() função de index.ts.
📔 Observação: Se você tem VS Code ou Cursor instalados mas o CODE botão não os abre, pode ser que o VS Code não esteja configurado corretamente na sua máquina para abrir via linha de comando. Na maioria dos casos, isso é tratado como parte da instalação padrão, mas caso não esteja, veja estas instruções do VS para habilitar o VS Code a partir da linha de comando.
Se você tiver uma janela de visualização aberta executando sua cena, sempre que você alterar o código nos seus arquivos e salvar, a cena recarrega automaticamente com suas alterações.
Usando IA
Você pode aproveitar assistentes de IA como Cursor ou Claude Code para ajudá-lo a escrever o código da cena. Por exemplo, para usar o Cursor, faça o seguinte:
Abra o assistente Cursor AI clicando no AI botão no canto superior direito da tela
Lá você pode pedir ao assistente de IA que o ajude a escrever código. Seus prompts podem incluir links para páginas de documentação, caminhos para arquivos específicos no seu projeto ou até imagens. Você também pode selecionar um modelo específico para usar no dropdown.
Decentraland fornece uma pasta de contexto para o assistente de IA ajudar a escrever código; essa pasta de contexto está localizada em /dclcontext no seu projeto de cena. O assistente de IA saberá pesquisar esse contexto sempre que gerar código, para se familiarizar com o SDK do Decentraland.
Essa pasta é atualizada com os arquivos de contexto mais recentes sempre que as dependências da sua cena são atualizadas. Você também pode forçar a atualização dessa pasta executando o seguinte:
💡 Dica: Você também pode adicionar seus próprios arquivos de contexto a essa pasta para ajudar o assistente de IA a entender sua cena e projeto. Se fizer isso, certifique-se de adicioná-los em um novo arquivo nessa pasta, pois os arquivos padrão são sobrescritos quando ocorrem atualizações do SDK.
Controle de versão
Recomendamos que você crie um repositório para seu projeto no GitHub e o use para acompanhar as versões do seu projeto e trabalhar colaborativamente com outras pessoas.
Se você não está familiarizado com como fazer isso, veja Guia rápido para repositórios, ou use o aplicativo GitHub desktop para um fluxo mais simples baseado em UI.
📔 Observação: Faça upload de toda a pasta do projeto para um repositório no GitHub, mas certifique-se de que as pastas /node-modules ou /bin e o arquivo package-lock.json estejam todos incluídos no arquivo .gitignore , para evitar sincronizá-los. Isso deve ser o caso se você configurar o repositório como do tipo node. Esses arquivos são todos gerados automaticamente, e o conteúdo pode diferir entre máquinas diferentes.
Veja também
SDK Quick start: siga este mini tutorial para um rápido curso intensivo.
Fluxo de desenvolvimento: leia isto para entender a criação de cenas de ponta a ponta.
Exemplos: mergulhe direto em cenas de exemplo funcionando.
Atualizado