Itens personalizados

Crie seus próprios itens personalizados para reutilizar em qualquer uma das suas scenes.

Defina um Custom Item para reutilizá-lo facilmente em qualquer uma das suas scenes, ou compartilhe-o com outros criadores de scenes. Custom Items podem consistir em uma única entity, ou em tantas entities quanto você quiser. Custom Items podem ser variações de Smart Items existentes, ou totalmente personalizados, com seus próprios models e funcionalidade sob medida.

Como Definir um Custom Item

Clique com o botão direito em uma entity no Entity Tree, ou selecione várias entities e então clique com o botão direito nelas. Selecione Create Custom Item.

Na seção inferior da tela, você será então solicitado a dar um nome ao seu novo Custom Item.

O item agora está listado na Custom Items aba, na parte inferior da tela. Essa aba só é exibida se pelo menos um Custom Item existir no seu workspace.

Quando definir um custom item, você pode selecionar várias entities no mesmo nível hierárquico, mas não entities de parents separados se elas não compartilharem um ancestor comum. Quaisquer entities aninhadas são incluídas automaticamente como parte do custom item; elas não precisam ser selecionadas.

As entities originais na sua scene não são afetadas pela ação de definir um Custom Item.

📔 Nota: Ao definir um Custom Item, você captura um snapshot do estado de cada component nas entities selecionadas (exceto pela position, rotation e scale da root entity). Isso inclui Actions, Triggers, Multiplayer, Scripts, Visibility, e qualquer outro component.

Quaisquer actions e triggers de smart item farão auto-referência à sua própria cópia. Por exemplo, se você definir um Custom Item que inclua um elevador e botões, os botões em cada cópia do elevador controlarão a cópia do elevador à qual pertencem, e não a cópia original do elevador.

Usando Custom Items

Basta arrastar o item da Custom Items aba para a sua scene.

Uma vez adicionado, você pode alterar livremente qualquer propriedade de um Custom Item; as alterações que você fizer afetam apenas essa cópia do Custom Item. Você também pode editar ou excluir os itens originais a partir dos quais o Custom Item foi definido; isso não afetará cópias existentes ou futuras.

Observe que Custom Items são exibidos com um ícone diferente na Entity Tree. No topo do menu de propriedades do Item à direita, você também verá uma menção de qual Custom Item eles foram criados.

Para excluir uma definição de custom item, clique com o botão direito no item no Custom Items menu e selecione Delete. Essa ação não afeta nenhuma cópia existente do item nas suas scenes; Custom Items órfãos permanecem inalterados na sua scene. Excluir uma definição de Custom Item remove apenas a definição da aba Custom Items.

Para renomear uma definição de Custom Item, clique com o botão direito na definição de Custom Item na Custom Items aba e selecione Rename.

Você não pode modificar a definição de um Custom Item que já foi criado; você deve criar uma nova definição e excluir a original.

Criando Custom Items dinamicamente

Cada Custom Item é armazenado como um composite, um arquivo que descreve uma tree de entities e components. Isso significa que você pode criar uma nova cópia de um Custom Item enquanto a scene está em execução, em vez de colocar cada cópia manualmente.

Você pode criar um Custom Item de duas maneiras:

• Sem código: Use a Spawn Entity action no Scene Editor. Veja Sobre criar entities.

• Com código: Use Composite.instance() no SDK. Veja Composites.

Compartilhando Custom Items

Você pode compartilhar seus custom items com outros criadores, para que eles possam usá-los em suas próprias scenes.

Custom Items são armazenados cada um em uma pasta separada na sua máquina local. Abra essa pasta clicando no ícone de pasta no canto superior direito da aba Custom Items.

Você também pode encontrar manualmente essa pasta na sua máquina:

• No Windows: User/AppData/Roaming/creator-hub/Custom Items

• No Mac: Users/username/Library/Application Support/creator-hub/Custom Items

📔 Nota: A Library pasta está oculta no Mac por padrão. A maneira mais fácil de acessá-la é abrindo Go > Go to Folder e digitando application support/creator-hub

Para compartilhar com outra pessoa, basta abrir a pasta Custom Items e copiar a pasta completa do item. Talvez seja útil compactar a pasta em zip para facilitar a transferência. Essa pasta contém tudo o que é necessário para usar o seu Custom Item.

A pessoa que estiver usando o seu Custom Item deve então descompactar a pasta do item em sua própria pasta Custom Items na máquina dela. Ela pode precisar clicar no botão Refresh para que o item apareça na Custom Items aba.

Quaisquer Assets usados pelo seu Custom Item também são armazenados na pasta do Custom Item. Isso inclui quaisquer modelos 3D, imagens, scripts, sons e vídeos referenciados pelo item.