> 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/modelacao-3d-e-animacoes/colliders.md).

# Colliders

Saiba como adicionar colliders a modelos 3D importados para o Decentraland.

Para ativar colisões entre um modelo 3D e os utilizadores da sua scene, tem de atribuir colliders ao modelo. Sem um collider, os jogadores conseguem atravessar os modelos como se não estivessem lá. Os colliders também são necessários para que um objeto responda aos pointer events do jogador ou os bloqueie, ou para que os raycasts o intersectem ou sejam bloqueados por ele. Por motivos de desempenho, os colliders são muitas vezes modelados separadamente como uma geometria invisível mais simples, com menos vértices do que a geometria visível.

{% hint style="info" %}
**💡 Dica**: Instale o [plugin Decentraland Tools Blender](https://extensions.blender.org/add-ons/decentraland-tools/). Inclui várias funções úteis para ajudar a editar e exportar modelos 3D, Wearables e Emotes.
{% endhint %}

O modelo pode usar uma geometria invisível como collider ou, desde o SDK7, pode atribuir a geometria visível para que se comporte como um collider. Consulte [**Colliders em modelos 3D**](https://docs.decentraland.org/creator/development-guide/sdk7/colliders/#colliders-on-3d-models) . Também pode atribuir diferentes camadas de colisão às diferentes geometrias para controlar separadamente a física do jogador, os pointer events e outras camadas personalizadas. Consulte [**Colliders em modelos 3D**](https://docs.decentraland.org/creator/development-guide/sdk7/colliders/#collision-layers) .

Os colliders não afetam a forma como os modelos e as entidades interagem entre si; podem sempre sobrepor-se. Os colliders só afetam a forma como o modelo interage com o avatar do jogador.

Para que uma scene de Decentraland reconheça um objeto como collider, basta dar-lhe um nome específico. O nome do objeto tem de incluir o sufixo “\_collider” no fim.

Por exemplo, para criar um collider para um candeeiro de rua, pode criar uma caixa simples à volta do seu tronco. Os jogadores da scene não verão esta caixa, mas ela bloqueará o caminho.

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

Neste caso, podemos chamar à caixa “LampPost*collider” e exportar a árvore e a caixa como um único modelo \_\_gltf. A etiqueta \*\_\_collider*\* informa o motor de Worlds de Decentraland de que o objeto caixa pertence ao conjunto de colliders, tornando invisível a mesh do collider.

Sempre que um jogador vir o modelo do candeeiro de rua na sua scene, verá o modelo complexo do candeeiro. No entanto, quando caminhar contra ele, colidirá com a caixa, não com a árvore.

## Restrições espaciais dos jogadores

Ao criar modelos destinados a permitir que os jogadores caminhem à sua volta, tenha em conta as seguintes medidas de referência:

* Os jogadores conseguem subir um degrau com cerca de 40 centímetros sem saltar. Um degrau com 45 centímetros ou mais exige um salto. Para que as escadas sejam confortáveis, cada degrau deve ter, no máximo, 25 centímetros de altura e pelo menos 30 centímetros de profundidade.
* Os jogadores conseguem subir inclinações até 46 graus sem saltar. Em superfícies mais inclinadas, o avatar desliza. Para facilitar a deslocação a pé, mantenha as rampas a 30 graus ou menos. Uma rampa de collider sobre escadas é a exceção: segue a inclinação das escadas, cerca de 40 graus para degraus com 25 centímetros de altura e 30 centímetros de profundidade (consulte [Adicionar um collider a uma escadaria](#add-a-collider-to-a-staircase)).
* Os jogadores conseguem saltar até 1,8 metros de altura
* Os avatares têm cerca de 1,9 metros de altura, mas tenha em conta que podem usar chapéus ou outros wearables na cabeça.
* O collider do avatar é uma cápsula com 0,6 metros de largura (um raio de 0,3 metros). Uma viga ou um teto com menos de cerca de 1,85 metros impede a passagem do avatar. Deixe pelo menos 2 metros de altura livre em todos os locais por onde os jogadores passem. Em espaços interiores, deixe muito mais espaço para a câmara. Consulte [Criar interiores maiores do que na vida real](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/conceber-a-experiencia/design-games.md#build-interiors-larger-than-real-life).

Sempre que um jogador vir o modelo da árvore na sua scene, verá o modelo complexo da árvore. No entanto, quando caminhar contra a árvore, colidirá com a caixa, não com a árvore.

### Adicionar um collider a uma escadaria

As escadas são um caso de utilização muito comum para objetos collider. Para que os jogadores consigam subir escadas, tem de existir um objeto \_collider correspondente onde possam pisar.

Recomendamos que use um objeto de rampa para os colliders das escadas, pois proporciona uma experiência muito melhor ao subir ou descer. Ao subirem as escadas, os jogadores terão a sensação de uma subida ou descida suave, em vez de terem de “saltar” cada degrau.

Usar um objeto de rampa também evita criar geometria desnecessária, deixando espaço para outros modelos mais complexos. Tenha em conta que a geometria do collider também é considerada ao calcular as [**limitações da scene**](https://docs.decentraland.org/creator/development-guide/scene-limitations/)

1. Crie um novo objeto em forma de rampa, com dimensões e proporções semelhantes às das escadas originais.

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

2. Dê à rampa um nome semelhante a S*tair\_collider*. O nome tem de terminar em \_*collider*.
3. Sobreponha o objeto de rampa às escadas, de modo a ocuparem o mesmo espaço.

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

4. Exporte os dois objetos em conjunto como um único modelo *glTF* .

Agora, quando os jogadores virem as escadas na sua scene, verão o modelo mais elaborado das escadas, mas, ao subi-las, colidirão com a rampa.

## Otimizar colliders

* Prefira usar meshes de colisão **Box**, **Sphere** e **Capsule** porque oferecem melhor desempenho durante o carregamento e em runtime.
* Considere aproximar uma mesh de colisão complexa usando várias meshes de colisão Primitive (**Box**/**Sphere**/**Capsule**)

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

*Exemplo: o collider de um anel pode ser composto por vários colliders Capsule ou Box*

* Coloque a mesh de colisão dentro da hierarquia do objeto a que está associada. Por exemplo, Spaceship\_collider pode ser um objeto filho dentro do objeto principal Spaceship (do ponto de vista da hierarquia)

### Colliders convexos vs. côncavos

Se utilizar uma malha de colisão arbitrária for a única possibilidade, torne a malha de colisão convexa (não côncava). Isto evita situações físicas estranhas, como movimentos aos solavancos, ficar preso dentro do collider ou atravessá-lo. Nota: muitas vezes é possível imitar uma malha côncava com várias malhas convexas.

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

## Nomenclatura de colisores

**Utilize nomes significativos. O nome deve indicar o contexto em que o asset é utilizado ou a parte do objeto a que diz respeito.**

Para nomear assets, utilizamos uma combinação de `PascalCase` e `snake_case`, a que podemos chamar `PascalSnake_case`. As regras básicas são: uma palavra nova ou uma palavra após um separador (`_`) começa com letra **maiúscula.**

Collision Mesh é a malha utilizada como referência para criar um collider no Explorer

* Segue os mesmos princípios das malhas acima, mas tem o sufixo `_collider` no final **Exemplos:** 🟢 **Prefira** nomes como: `Tram_Wheel_LeftFront_collider` 🔴 **Evite** nomes como: `Primitive.001_Collider`, `collider (1)`, `Cylinder.007_collider`,

{% hint style="warning" %}
**🔥Dica de otimização🔥**

Se for possível aproximar um collider com uma forma de caixa, esfera ou cápsula, utilize um dos três sufixos adicionais: \_box, \_sphere ou \_capsule. Utilizar estas três formas em vez de uma malha arbitrária para detetar colisões melhora o desempenho da cena e reduz o tempo de carregamento 💪🚀

Exemplos: 🟢 Teater\_MainWall\_North\_collider\_box, Fountain\_Statue\_collider\_sphere
{% endhint %}

## Práticas recomendadas para colliders

* **Utilize sempre o menor número possível de triângulos ao criar colliders.** Evite copiar um objeto complexo para o utilizar como collider. Colliders simples garantem uma boa experiência de utilização e ajudam a manter a cena dentro dos limites de triângulos.
* **Os objetos collider não devem ter nenhum material**, uma vez que os jogadores da sua cena nunca os verão. Os colliders são invisíveis para os jogadores.
* **Os nomes de todos os objetos collider devem terminar em \_*****collider*****.** Por exemplo, T*ree\_collider*.
* **Se utilizar um \_plane**\_\*\* como collider, este só bloqueará numa direção.\*\* Se quiser que os colliders bloqueiem dos dois lados, por exemplo, no caso de uma parede, terá de criar dois planos com as normais orientadas em direções opostas.
* Ao duplicar objetos collider, tenha atenção aos nomes. Alguns programas acrescentam um \_*1* ao final do nome do ficheiro para evitar duplicados, por exemplo *tree\_collider\_1*. Os objetos com nomes deste tipo serão interpretados pelo Decentraland World Engine como objetos normais, e não como colliders.
* Pode evitar adicionar uma malha de collider se adicionar um componente invisível `MeshCollider` à entidade, que aproxima a forma do modelo 3D.
* Também pode evitar adicionar uma malha de collider se configurar o componente `GLTFContainer` para utilizar a geometria visível como collider. Consulte [**Colliders em modelos 3D**](https://docs.decentraland.org/creator/development-guide/sdk7/colliders/#colliders-on-3d-models) .
* Se estiver a criar um modelo 3D com muitas formas de Mesh que precisam, cada uma, do seu Collider, existem alguns complementos úteis que podem ajudar. No Blender, pode usar a opção de renomeação em lote dentro do Blender \*\*\*\*para adicionar automaticamente um `_collider` sufixo a todos os nomes de Mesh de um grupo. Saiba mais sobre esta ferramenta na secção «**Usar o Blender para renomear assets»**


---

# 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/modelacao-3d-e-animacoes/colliders.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.
