Combinar com código
Combine o conteúdo criado no Scene Editor com o poder de escrever código.
O Creator Hub mais código personalizado é uma combinação muito poderosa para criar conteúdo. Você pode usar a tela para posicionar itens visualmente de forma intuitiva e depois 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 buscar 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. 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 no TypeScript, ou se você quer economizar tempo escrevendo código.
📔 Nota: Se você estiver no macOS, certifique-se de que o app do editor de código esteja no diretório Applications.
Uma vez instalado, pode ser necessário selecionar seu Code Editor nas configurações do Creator Hub. Para fazer isso,
Abra o ícone de engrenagem no canto superior direito da tela
Em Editor de código preferido, selecione seu Editor de Código. Você pode encontrar seu editor listado no menu suspenso, ou pode precisar 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 seu projeto de 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 personalizado em index.ts arquivo sob /src, dentro da main() função. Você também pode adicionar código personalizado fora dessa função ou criar novos .ts arquivos dentro da /src pasta, mas estes devem ser de alguma forma referenciados dentro da main() função de index.ts.
📔 Nota: Se você tem VS Code ou Cursor instalado, mas o CODE botão não o 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 preview aberta executando sua cena, sempre que alterar o código nos seus arquivos e salvar, a cena recarrega automaticamente com suas mudanças.
Usando IA com Cursor
Se você estiver usando o Cursor, pode usar o assistente de IA para ajudar a escrever código. Para isso,
Abra o assistente de IA do Cursor clicando no AI botão no canto superior direito da tela
Lá você pode solicitar ao assistente de IA que o ajude a escrever código. Você também pode selecionar um modelo 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á procurar 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 toda vez que as dependências da sua cena são atualizadas. Você também pode forçar a atualização dessa pasta executando o seguinte:
💡 Tip: 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 acontecem atualizações do SDK.
Controle de versão
Recomendamos que você crie um repo 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 Início rápido para repositórios, ou use o aplicativo GitHub Desktop para um fluxo baseado em UI mais simples.
📔 Nota: Faça upload de toda a pasta do projeto para um repo no GitHub, mas certifique-se de que as pastas /node-modules ou /bin e o package-lock.json arquivo estejam todos incluídos no arquivo .gitignore , para evitar sincronizá-los. Isso deve ser o caso se você configurar o repo como do tipo node. Esses arquivos são todos gerados automaticamente, e o conteúdo pode diferir entre máquinas.
Veja também
SDK Quick start: siga este mini tutorial para um curso rápido.
Fluxo de desenvolvimento: leia isto para entender a criação de scenes de ponta a ponta.
Exemplos: mergulhe diretamente em scenes de exemplo funcionando.
Atualizado