> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items-advanced.md).

# Smart Items - Avançado

Use smart items na sua scene para adicionar interatividade.

A maioria dos itens inteligentes tem um módulo básico onde pode configurar apenas as definições mais comuns de forma simples, mas pode percorrer a página para baixo, passando o marcador **Avançado** , para personalizar quase todos os aspetos do comportamento do item.

{% embed url="<https://www.youtube.com/watch?v=m_xWCSDDxpQ>" %}

O item seguinte tem um componente Transform e um módulo básico que expõe apenas os campos essenciais para configurar um botão. Mas, se percorrer a página para baixo, passando o marcador **Avançado** , encontrará todas as definições disponíveis.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-489d4458f5a0820fb2963f828c986787dabb1bc0%2Fadvanced-settings-smart-item.webp?alt=media)

{% hint style="info" %}
**📔 Nota**: A maioria das definições do módulo básico também está disponível nos componentes mais abaixo. As alterações feitas no módulo básico refletem-se nos componentes mais abaixo, e vice-versa, exceto em alguns casos em que as definições básicas são uma abstração de várias definições mais abaixo. Nesses casos, se alterar as definições avançadas para valores não suportados pelo módulo básico, o campo do módulo básico será marcado como indefinido.
{% endhint %}

## Configuração avançada

As propriedades estão agrupadas em [**componentes**](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura/entities-components.md). Diferentes itens inteligentes podem ter componentes diferentes, consoante a sua funcionalidade.

O comportamento da maioria dos itens é controlado por:

* [**Ações**](#actions): o componente Actions define o que o item pode fazer. Por exemplo, reproduzir um som, reproduzir uma animação, mover-se para cima ou ficar invisível.
* [**Acionadores**](#triggers): o componente Triggers determina quais os eventos que fazem essas ações acontecer. Por exemplo, quando o jogador clica no item, quando entra numa área ou quando a cena é carregada pela primeira vez.

Por exemplo, num item inteligente de porta, o componente **Actions** inclui as ações "Abrir" e "Fechar". O componente **Triggers** desse item inclui um acionador **Ao clicar** que ativa a ação "Abrir" quando o jogador clica na porta.

Os acionadores de um item inteligente podem ativar ações em qualquer item inteligente da cena, não apenas nesse mesmo item inteligente. Por exemplo, um item inteligente de botão pode ter um componente **Triggers** que ativa a ação "mover para cima" definida no componente **Actions** de uma plataforma flutuante.

Os acionadores também podem ocorrer de forma condicional. Por exemplo, os itens inteligentes de porta incluem dois acionadores **Ao clicar** no respetivo componente Triggers: um abre a porta se estiver fechada; o outro fecha-a se estiver aberta. Para mais detalhes, consulte [Estados e lógica condicional](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/states-and-conditions.md).

## Interações entre itens

Para fazer com que os itens interajam entre si:

* Um dos itens tem de ter pelo menos uma ação definida num componente [Actions](#actions) .
* O outro item precisa de um acionador no componente [Triggers](#triggers) que aponte para essa ação.

Por exemplo, para fazer com que um botão abra uma porta:

1. Adicione qualquer item inteligente de botão e abra o respetivo componente **Triggers** . Este tem um evento de acionador predefinido que reproduz um som e uma animação para o próprio botão.
2. Clique no sinal **+** junto a **Assigned Actions**, para adicionar uma terceira ação ao mesmo evento de acionador.
3. Selecione o item inteligente da porta no primeiro menu suspenso.
4. No segundo menu suspenso, selecione a ação "Abrir".

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-18c5fd9a94ea5c0d3e90a62bbdd3a544dac54d57%2Fbutton-to-door.webp?alt=media)

{% hint style="info" %}
**💡 Dica**: Em alternativa, pode criar um novo evento Trigger que trate apenas da ação da porta. Ambos os eventos Trigger são chamados sempre que se clica no botão.

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a313d118307399f40a8b72051b897d1b44ae4000%2Fbutton-to-door2.webp?alt=media" alt="" data-size="original">
{% endhint %}

Qualquer item pode acionar qualquer ação de outro item, desde que a ação esteja definida. Consulte [Triggers](#triggers) para conhecer mais formas de acionar uma ação.

Pode usar [estados e lógica condicional](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/states-and-conditions.md) para acionar uma ação apenas se uma condição for satisfeita. A condição pode até verificar o estado de um terceiro smart item. Por exemplo, um botão só abre a porta se o estado de um smart item personalizado de "gerador de energia" estiver definido como "Ligado".

## Ações

O componente **Actions** enumera as ações que o item pode executar. Cada smart item inclui um conjunto de ações predefinidas. Pode personalizar as ações existentes ou adicionar novas. Estão disponíveis os seguintes tipos de ações:

* **Reproduzir animação**: reproduz uma animação no modelo 3D do item. Consulte [Sobre a reprodução de animações](#about-playing-animations)
* **Parar animação**: para todas as animações reproduzidas pelo modelo 3D do item.
* **Reproduzir som**: reproduz um som de um ficheiro na localização do item. Consulte [Sobre a reprodução de sons](#about-playing-sounds)
* **Parar som**: para todos os sons reproduzidos pelo item.
* **Iniciar Tween**: altera gradualmente a posição, rotação ou escala ao longo de um período definido. Consulte [Mover, rodar ou redimensionar](#moving-rotating-or-scaling).
* **Definir visibilidade**: torna o item visível ou invisível.
* **Anexar ao jogador**: define o item como filho do avatar do jogador. Por exemplo, para o transportar na mão ou acima da cabeça.
* **Desanexar do jogador**: desanexa o item do avatar do jogador.
* **Abrir link**: abre um link para um site externo num separador do navegador. É perguntado aos jogadores se confiam no domínio antes de o abrir.

{% hint style="info" %}
**📔 Nota**: esta ação só pode ocorrer como resultado de um clique num item. Não pode ser acionada ao entrar numa área de Trigger.
{% endhint %}

* **Mover jogador**: altera a posição do jogador para um conjunto de coordenadas locais dentro da cena. Só é possível mover o jogador dentro da mesma cena.
* **Teletransportar jogador**: teletransporta um jogador para outra localização em Decentraland. Use o menu suspenso **Modo de teletransporte** para o enviar **Para coordenadas** de outra cena em Genesis City ou **Para World**, indicando o nome de um World. Os jogadores aparecerão no ponto de spawn da cena de destino.
* **Reproduzir Emote**: faz o avatar do jogador executar uma das animações predefinidas do avatar (por exemplo, acenar ou bater palmas).
* **Reproduzir Emote personalizado**: faz o avatar do jogador executar uma animação personalizada, a partir de um ficheiro carregado para a cena.
* **Mostrar texto**: Apresenta texto na interface do ecrã, que será ocultado após alguns segundos. Ideal para dicas, falas de diálogo, notificações, etc.
* **Ocultar texto**: Oculta qualquer texto da interface que possa estar a ser apresentado.
* **Iniciar atraso**: Atrasa outra ação do mesmo item durante o número de segundos pretendido.
* **Parar atraso**: Cancela quaisquer ações atrasadas no item.
* **Iniciar ciclo**: Repete continuamente uma ação do mesmo item, num intervalo definido.
* **Parar ciclo**: Cancela quaisquer ações em ciclo no item.
* **Reproduzir vídeo**: Reproduz um vídeo como Material numa forma primitiva.
* **Parar vídeo**: Para quaisquer vídeos que estejam a ser reproduzidos.
* **Reproduzir stream de áudio**: Reproduz um stream de áudio.
* **Parar stream de áudio**: Para quaisquer streams de áudio que estejam a ser reproduzidos.
* **Clonar**: Duplica um item na posição designada.
* **Criar entidade**: Cria uma nova cópia de um item na Scene, numa posição relativa ao item que executa a ação. O item a criar não precisa de estar colocado na Scene. Consulte [Sobre a criação de entidades](#about-spawning-entities).
* **Remover**: Elimina um item da Scene.
* **Mostrar imagem**: Apresenta uma imagem na interface, possivelmente durante um período limitado. Também pode incluir uma legenda.
* **Ocultar imagem**: Oculta qualquer imagem atualmente apresentada na interface através da ação Mostrar imagem.
* **Dano**: Reduz a saúde de qualquer barra de saúde que esteja próxima. A *Layer* propriedade pode determinar se a ação afeta apenas as barras de saúde do jogador ou também as de outros itens.
* **Mover jogador para aqui**: Altera a posição do jogador para a posição deste item.
* **Colocar no jogador**: Altera a posição do item para a posição do jogador.
* **Rodar como o jogador**: Altera a rotação do item para a rotação do jogador.
* **Colocar na câmara**: Altera a posição do item para a posição da câmara.
* **Rodar como a câmara**: Altera a rotação do item para a rotação da câmara.
* **Definir posição**: Altera a posição do item para uma posição específica. Pode ser absoluta ou relativa à posição atual.
* **Definir rotação**: Altera a rotação do item para uma rotação específica. Pode ser absoluta ou relativa à rotação atual.
* **Definir escala**: Altera a escala do item para um valor específico. Pode ser absoluta ou relativa à escala atual.
* **Seguir jogador**: Começa a mover-se e a virar-se na direção da posição do jogador. Ignora quaisquer obstáculos no caminho. Pode definir a velocidade e fazer com que se mova apenas em determinados eixos. A distância mínima determina a que distância ficará do jogador.
* **Parar de seguir jogador**: Para a ação Seguir jogador.
* **Ação aleatória**: Uma das ações listadas aqui será executada aleatoriamente, com igual probabilidade, sempre que a ação aleatória for chamada. Pode listar qualquer uma das ações pertencentes ao item.
* **Ações em lote**: Todas as ações listadas aqui serão executadas simultaneamente sempre que a ação em lote for chamada. Pode listar qualquer uma das ações pertencentes ao item.
* **Curar jogador**: Restaura a saúde na barra de saúde do jogador.
* **Fazer jogador olhar para o item**: Faz o avatar do jogador virar-se para olhar para o item.
* **Congelar jogador**: Impede o jogador de se mover, saltar ou executar Emotes.
* **Descongelar jogador**: Restaura a capacidade de movimento do jogador após uma ação Congelar jogador.
* **Ligar luzes**: Liga o componente **Light Source** do item.
* **Desligar luzes**: Desliga o componente **Light Source** do item.
* **Modificar luzes**: Altera as propriedades do componente **Light Source** do item, como a cor ou a intensidade.
* **Selecionar câmara**: Muda a vista do jogador para uma **Virtual Camera**, neste item ou noutra Entity.
* **Alterar texto**: Altera o texto de um item com um componente **Text Shape** . Também pode alterar o tamanho e a cor do tipo de letra.
* **Parar Tween**: Para qualquer movimento Tween que esteja atualmente em curso no item.
* **Deslizar textura**: Desliza continuamente a textura no Material do item numa determinada direção, criando efeitos como água corrente ou tapetes rolantes.
* **Alterar colisões**: Ativa ou desativa os Colliders do item, tanto para a física como para os Pointer Events.
* **Alterar skybox**: Altera a skybox da Scene para uma hora fixa do dia, expressa em segundos desde a meia-noite.
* **Repor skybox**: Repõe as definições predefinidas da skybox da Scene.
* **Registar na consola**: Apresenta uma mensagem na consola, útil para depurar durante o desenvolvimento da Scene.
* **Eliminar**: Remove o item e todos os respetivos elementos subordinados da cena.

Consulte [estados e lógica condicional](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/states-and-conditions.md) para saber mais sobre outras ações relacionadas com condições lógicas, como **Definir estado** e as ações de contador.

O **Actions** componente define as ações possíveis, mas estas não fazem nada na cena, a menos que sejam acionadas. As ações são ativadas por um [trigger](#triggers), seja do mesmo smart item ou de outro.

Para adicionar uma nova ação a um item, clique no botão **Adicionar nova ação** na parte inferior do componente Action. Em seguida, atribua um nome à ação, selecione um tipo e preencha os campos adicionais específicos desse tipo de ação.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-9e9472ac259c8fabec7c63bf7d5836ed287923c2%2Fnew-action.webp?alt=media)

### Triggers

O **Triggers** componente define eventos de trigger, que ativam ações quando ocorre um determinado evento. Existem os seguintes tipos de eventos de trigger:

* **Ao clicar**: quando o jogador clica no item. Consulte [Sobre os triggers de clique](#about-click-triggers)
* **Ao executar uma ação de input**: quando o jogador prime um botão de input enquanto aponta para o item.
* **Ao clicar em qualquer lugar**: quando o jogador clica com o ponteiro em qualquer lugar, sem precisar de apontar para o item.
* **Ao premir o botão principal em qualquer lugar**: quando o jogador prime o botão principal (E) em qualquer lugar.
* **Ao premir o botão secundário em qualquer lugar**: quando o jogador prime o botão secundário (F) em qualquer lugar.
* **O jogador entra na área**: quando o jogador entra numa área. Consulte [Trigger Area](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/trigger-area.md)
* **O jogador sai da área**: quando o jogador sai de uma área. Consulte [Trigger Area](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/trigger-area.md)
* **Ao aparecer**: quando a cena começa ou o item aparece na cena. Consulte [Trigger ao aparecer](#trigger-on-spawn)
* **Ao terminar o atraso**: quando uma ação **Iniciar atraso** do item termina a contagem decrescente.
* **A cada ciclo**: em cada iteração de uma ação **Iniciar ciclo** do item.
* **Ao clonar**: quando o item é clonado através de uma ação **Clonar** , a nova cópia aciona este trigger.
* **Ao clicar na imagem**: quando o jogador clica em uma imagem exibida por uma ação **Exibir imagem** ação.
* **Ao receber dano**: quando o item recebe dano de uma ação **Dano** ação.
* **Ao curar o jogador**: quando o jogador é curado por uma ação **Curar jogador** ação.
* **A cada tick**: a cada tick da cena, uma vez por frame. Use com cuidado, pois as ações acionadas por esse evento são executadas com muita frequência.

Consulte [estados e lógica condicional](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/states-and-conditions.md) para saber mais sobre outros acionadores relacionados a condições lógicas, como **Ao alterar o estado**, **Ao alterar o contador** e **Ao terminar o Tween**.

Para adicionar um novo acionador, clique em **Adicionar novo evento de acionador** na parte inferior do componente Trigger. Em seguida, selecione o tipo de acionador, a entidade que deseja ativar e uma ação dessa entidade.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-daae47bcc6247ff825168d5845a00619ccc41a22%2Fnew-trigger.webp?alt=media)

{% hint style="info" %}
**📔 Observação**: é necessário definir uma ação no componente [Actions](#actions) da entidade antes de acioná-la. Os acionadores só podem afetar entidades que tenham um componente Actions.
{% endhint %}

## Sobre a reprodução de animações

Use uma ação do tipo **Reproduzir animação** para executar uma animação no modelo 3D do item inteligente. A animação já precisa existir no arquivo do modelo 3D. O menu suspenso **Selecionar animação** exibe uma lista de todas as animações disponíveis no modelo 3D.

O campo **Modo de reprodução** permite selecionar se uma animação deve ser reproduzida apenas uma vez ou em loop.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c7abc86eb1816aa1e974d0ce2b5335c04ce55818%2Fplay-animation.webp?alt=media)

Depois de criar a ação, você pode ativá-la pelo componente [Triggers](#triggers) desse mesmo item ou de qualquer outro item.

Use a ação **Parar animação** para parar todas as animações do item, tanto as que estão em loop quanto as que não estão.

{% hint style="info" %}
**💡 Dica**: para conferir facilmente o conteúdo de um modelo 3D, ver quais animações ele inclui e como elas são, uma boa ferramenta é o [Babylon Sandbox](https://sandbox.babylonjs.com/). Basta arrastar o arquivo do modelo 3D para a janela. Um menu suspenso com uma lista das animações deverá aparecer na parte inferior.
{% endhint %}

Para saber mais sobre animações e como criar as suas como parte de um modelo 3D, consulte [Animações](https://docs.decentraland.org/creator/content-creator-pt/modelacao-3d-e-animacoes/animations.md).

## Sobre a reprodução de sons

Utilize uma ação do tipo **Play Sound** para reproduzir um ficheiro de som. Pode reproduzir qualquer ficheiro de som, desde que tenha sido importado para o projeto da cena. O som é ouvido de forma posicional, a partir da localização do item, o que significa que se ouve mais alto quando o jogador está mais perto.

{% hint style="info" %}
**💡 Dica**: Em vez de escrever o caminho para o ficheiro de som, pode arrastá-lo para o campo **Path** a partir do menu de navegação de ficheiros na parte inferior do Scene Editor.
{% endhint %}

Utilize o campo **Play Mode** para escolher se o som é reproduzido uma vez ou continuamente em loop.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-b68563c714883d68aaa32761fa72d3c58e17e2aa%2Fplay-sound.webp?alt=media)

Depois de criar a ação, você pode ativá-la pelo componente [Triggers](#triggers) desse mesmo item ou de qualquer outro item.

Utilize a ação **Stop Sound** para parar todos os sons do item, tanto os que estão em loop como os que não estão. Isto também para os sons do componente **AudioSource** .

Para fazer com que um item reproduza sempre um som em loop, por exemplo, para criar ambiente ou música, é mais fácil utilizar o componente **AudioSource** , em vez de utilizar Actions e Triggers. Este componente só requer que indique o caminho para um ficheiro e assinale as caixas **Start Playing** e **Loop**.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-8bc2b88cbd78240c40491ac5b8b768e014b0ad7d%2Faudiosource.webp?alt=media)

{% hint style="info" %}
**📔 Nota**: um smart item só pode reproduzir um som de cada vez. A reprodução de um segundo som interrompe quaisquer outros sons que estejam a ser reproduzidos. Isto também se aplica aos sons do componente **AudioSource** . Se precisar de reproduzir dois sons em simultâneo, considere adicionar uma Entity invisível no mesmo local para conter uma ação **Play Sound** .
{% endhint %}

Consulte [sons](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/sounds.md) para saber mais sobre a reprodução de sons em Decentraland.

## Mover, rodar ou redimensionar

Utilize uma ação **Start Tween** para alterar a **posição**, **escala**, ou a **rotação**do item ao longo de um período de tempo. Todas as **Start Tween** ações começam no estado original do item e alteram-no para um estado final ao longo de um período de tempo.

Os Tweens de posição podem ser relativos ou absolutos. Um Tween de posição absoluto move o item para uma posição fixa em relação à cena. O item move-se da posição em que se encontra para essa posição. Se já estiver nessa posição, não parecerá mover-se. Um Tween de posição relativo move o item uma determinada distância a partir da posição atual, por exemplo, um Tween para uma posição relativa de `1, 0, 0` move o item 1 metro para a frente, na direção para a qual está virado. Se executar a ação Tween uma segunda vez, o item avançará mais um metro.

Os Tweens de rotação também podem ser relativos ou absolutos. Uma rotação relativa é adicionada à rotação atual do item. Um Tween de rotação absoluto faz com que o item fique virado para uma direção específica em relação à cena.

Utilize o campo **Duration** para definir quanto tempo deve durar todo o movimento, em segundos. Tenha em atenção que o controlo deslizante vai até 100 segundos, mas também pode introduzir manualmente um valor maior, se necessário.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-722be741f04505c23cc8e2081e1675a166e13ec0%2Ftweens.webp?alt=media)

Depois de criar a ação, você pode ativá-la pelo componente [Triggers](#triggers) desse mesmo item ou de qualquer outro item.

Os Tweens podem seguir diferentes **Curve Types** que afetam a taxa de alteração ao longo do tempo. Uma curva **linear** curva (predefinida), significa que a velocidade da mudança é constante do início ao fim. Há muitas opções à escolha, que desenham curvas com formas diferentes, dependendo de se o início e/ou o fim começam devagar, e em que medida. Uma **easeinexpo** curva começa devagar e termina depressa, aumentando a velocidade exponencialmente; pelo contrário, uma **easeoutexpo** curva começa depressa e termina devagar.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-df967c421ebe6616c2a25a566fef8baa2ed10597%2Feasing-functions.webp?alt=media)

{% hint style="info" %}
**💡 Dica**: Experimente diferentes curvas de movimento. As diferenças costumam ser subtis, mas interpretamos subconscientemente informações sobre a forma como as coisas se movem, como o peso, a fricção ou até a personalidade.
{% endhint %}

Use **On Tween End** para acionar eventos no componente **Triggers** e ativar uma ação depois de um tween terminar. Use [estados e lógica condicional](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/states-and-conditions.md) para descrever um percurso em loop para uma plataforma flutuante, de modo que se desloque constantemente entre dois locais.

Quando um item executa um tween, isso afeta tudo o que lhe diz respeito. Por exemplo, se alterar a escala, altera a escala do modelo 3D visível e também a geometria invisível do collider, o tamanho do texto, etc. Se o item tiver elementos subordinados (aninhados na árvore de entidades à esquerda), essas entidades filhas também serão afetadas pelo tween.

{% hint style="info" %}
**📔 Nota**: Cada entidade só pode executar um tween de cada vez. Por exemplo, não é possível fazer um item deslocar-se para o lado e também rodar ao mesmo tempo. Como alternativa, pode usar entidades parentais. Por exemplo, pode ter uma entidade parental invisível que se desloca para o lado e uma entidade filha visível que roda.
{% endhint %}

## Sobre gerar entidades

Use uma ação **Spawn Entity** para criar uma nova cópia de um item na cena enquanto esta está em execução. Ao contrário da ação **Clone** o item gerado não precisa de ser colocado primeiro na cena.

### Tornar um item gerável

Antes de poder gerar um item, este tem de estar disponível nos ficheiros do projeto. Para adicionar um item sem o colocar na cena:

1. No painel **Assets** localize o item no catálogo ou em **Custom Items**.
2. Clique com o botão direito do rato no item e selecione **Add to filesystem**.

Isto copia o item para o projeto para que possa ser gerado mais tarde. Não adiciona nada visível à cena. O item passa então a aparecer no menu pendente **Source** de qualquer ação **Spawn Entity** .

### Configurar a ação

Uma ação **Spawn Entity** tem dois campos:

* **Source**: O item a gerar. Escolha entre os itens adicionados aos ficheiros do projeto.
* **Position**: As coordenadas X, Y e Z onde a nova cópia aparece, relativamente ao item que executa a ação.

Se o item gerado for, por sua vez, um smart item, cada cópia gerada mantém as suas próprias ações e triggers a funcionar de forma independente.

{% hint style="info" %}
**💡 Dica**: Para gerar itens através de código, consulte [Composites](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura/composites.md). Os itens adicionados aos ficheiros do projeto são armazenados como composites, o mesmo formato usado pela função spawn do SDK.
{% endhint %}

## Sobre triggers de clique

Para acionar uma ação ao clicar num item, crie um **Ao clicar** trigger. A ação será ativada sempre que o jogador clicar na entidade.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5b8e97937e37b036049a84c9a0eaaa7e0c21fdd0%2Fon_click.webp?alt=media)

Consulte [Tornar qualquer item inteligente](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/make-any-item-smart.md#interactivity) para obter mais detalhes.

{% hint style="info" %}
**📔 Nota**: ao utilizar modelos 3D personalizados, o modelo tem de ter uma geometria de collider invisível para poder ser clicável. Consulte [colliders](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/colliders.md#pointer-blocking).

Em alternativa, pode configurar o componente **GLTF** do item para que a sua **Visible Layer** de colisão esteja definida como **Pointer**.

Outra alternativa é adicionar um item inteligente **Click Area** para desenhar um cubo que se sobreponha ao item em que pretende clicar. O item inteligente Click Area é um [item invisível](#invisible-items).
{% endhint %}

## Acionar no aparecimento

Os triggers do tipo **On Spawn** ativam uma ação quando a cena é carregada. Em vez de esperar que o jogador interaja com um item, a ação é executada imediatamente.

Por exemplo, utilize este tipo de trigger para fazer uma plataforma mover-se continuamente. Utilize um trigger **On Spawn** para ativar uma ação de tween. Em seguida, utilize triggers **On State Change** para a manter em movimento entre duas ou mais posições.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-80691ad3f7a654f986fe7c7c1a14b9e004c9dbe8%2Fon_spawn.webp?alt=media)

## Multijogador

Todos os itens inteligentes são multijogador por predefinição. Consulte [Itens inteligentes - Básico](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items.md) para obter mais detalhes.

Pode alterar ou ajustar este comportamento multijogador para sincronizar apenas determinados componentes do item.

No componente **Multiplayer** do item, assinale as caixas dos componentes que pretende partilhar.

Por exemplo, uma porta partilha o seu `Animator` para que todos vejam as animações de abertura, o seu `AudioSource` para que todos ouçam o som e o seu `State` para que todos acompanhem se está aberta ou fechada. A porta não partilha o seu componente `Visibility` porque, normalmente, a porta está sempre visível. Se incluir ações para ativar e desativar a visibilidade, poderá querer assinalar também este componente, para que as alterações sejam sincronizadas entre todos os jogadores.

## Itens invisíveis

Alguns itens não se destinam a ser vistos pelo jogador, mas ficam visíveis durante a edição da cena para facilitar a sua gestão. É o caso de itens como **Ambience**, **Trigger Area**, **Click Area**, etc.

No modo avançado, estes itens têm um **Visibilidade** componente definido como invisível. Este componente não afeta a visibilidade dos itens no Scene Editor, mas os jogadores não veem os itens definidos como invisíveis durante uma pré-visualização.

## Ver também

* [Smart items - Noções básicas](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items.md)
* [Estados e condições](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/states-and-conditions.md)
* [Tornar qualquer item inteligente](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/make-any-item-smart.md)
* [Combinar com código](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/expandir-com-codigo/overview.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items-advanced.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
