> 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-es/modelado-y-animaciones-3d/colliders.md).

# Colliders

Aprende cómo añadir colliders a los modelos 3D importados a Decentraland.

Para habilitar las colisiones entre un modelo 3D y los usuarios de tu Scene, debes asignar Colliders al modelo. Sin un Collider, los jugadores pueden atravesar los modelos como si no estuvieran ahí. Los Colliders también son necesarios para que un objeto responda a los eventos de puntero del jugador o los bloquee, o para que los raycasts lo atraviesen o queden bloqueados por él. Por motivos de rendimiento, los Colliders suelen modelarse por separado como una geometría invisible más sencilla, con menos vértices que la geometría visible.

{% hint style="info" %}
**💡 Consejo**: Instala el plugin [Decentraland Tools Blender](https://extensions.blender.org/add-ons/decentraland-tools/). Incluye varias funciones útiles para ayudarte a editar y exportar modelos 3D, Wearables y Emotes.
{% endhint %}

El modelo puede usar una geometría invisible como Collider o, desde SDK7, puedes asignar la geometría visible para que actúe como Collider. Consulta [**Colliders en modelos 3D**](https://docs.decentraland.org/creator/development-guide/sdk7/colliders/#colliders-on-3d-models) . También puedes asignar distintas capas de colisión a las diferentes geometrías para controlar por separado la física del jugador, los eventos de puntero y otras capas personalizadas. Consulta [**Colliders en modelos 3D**](https://docs.decentraland.org/creator/development-guide/sdk7/colliders/#collision-layers) .

Los Colliders no afectan la interacción entre modelos y Entities: siempre pueden superponerse. Los Colliders solo afectan la interacción del modelo con el Avatar del jugador.

Para que una Scene de Decentraland reconozca un objeto como Collider, solo hay que asignarle un nombre específico. El nombre del objeto debe incluir el sufijo «\_collider» al final.

Por ejemplo, para crear un Collider para un poste de luz, puedes crear un objeto de caja simple alrededor de su tronco. Los jugadores de la Scene no verán esta caja, pero les bloqueará el paso.

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

En este caso, podemos llamar a la caja «LampPost*collider» y exportar el árbol y la caja como un único modelo \_\_gltf. La etiqueta \*\_\_collider*\* le indica al motor de Worlds de Decentraland que el objeto de caja pertenece al conjunto de Colliders, lo que hace que la Mesh del Collider sea invisible.

Cuando un jugador vea el modelo del poste de luz en tu Scene, verá el modelo complejo de la farola. Sin embargo, al chocar con él, chocará contra la caja, no contra el árbol.

## Restricciones espaciales de los jugadores

Al diseñar modelos por los que los jugadores puedan desplazarse, ten en cuenta las siguientes medidas de referencia:

* Los jugadores pueden subir un escalón de hasta unos 40 centímetros sin saltar. Para un escalón de 45 centímetros o más, hace falta saltar. Para que las escaleras sean cómodas, procura que cada escalón mida 25 centímetros de alto como máximo y al menos 30 centímetros de profundidad.
* Los jugadores pueden subir pendientes de hasta 46 grados sin saltar. En superficies más inclinadas, el Avatar se resbala. Para facilitar el desplazamiento, procura que las rampas tengan una inclinación máxima de 30 grados. Una excepción es el Collider en forma de rampa sobre las escaleras: sigue la inclinación de estas, de unos 40 grados para escalones de 25 centímetros de alto y 30 centímetros de profundidad (consulta [Añadir un Collider a una escalera](#add-a-collider-to-a-staircase)).
* Los jugadores pueden saltar hasta 1,8 metros de altura
* Los Avatars miden alrededor de 1,9 metros de altura, pero ten en cuenta que pueden llevar sombreros u otros Wearables en la cabeza.
* El Collider del Avatar es una cápsula de 0,6 metros de ancho (con un radio de 0,3 metros). Una viga o un techo de menos de unos 1,85 metros detiene al Avatar. Deja al menos 2 metros de altura libre en todos los lugares por los que pasen los jugadores. En interiores, deja mucho más espacio para la cámara. Consulta [Construir interiores más grandes que en la vida real](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/disenar-la-experiencia/design-games.md#build-interiors-larger-than-real-life).

Cuando un jugador vea el modelo del árbol en tu Scene, verá el modelo complejo del árbol. Sin embargo, al chocar con él, chocará contra la caja, no contra el árbol.

### Añadir un Collider a una escalera

Las escaleras son un caso de uso muy común para los objetos Collider. Para que los jugadores puedan subirlas, debe haber un objeto \_collider correspondiente sobre el que puedan pisar.

Recomendamos usar un objeto en forma de rampa para los Colliders de las escaleras, ya que ofrece una experiencia mucho mejor al subirlas o bajarlas. Al subirlas, el movimiento parecerá fluido, en lugar de exigir que los jugadores «salten» cada escalón.

El uso de un objeto en forma de rampa también evita crear geometría innecesaria y deja espacio para otros modelos más complejos. Ten en cuenta que la geometría del Collider también se tiene en cuenta al calcular las [**limitaciones de la Scene**](https://docs.decentraland.org/creator/development-guide/scene-limitations/)

1. Crea un objeto nuevo con forma de rampa que se aproxime al tamaño y las proporciones de la escalera original.

![](https://1216664193-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. Asigna a la rampa un nombre similar a S*tair\_collider*. Debe terminar en \_*collider*.
3. Superpón la rampa a la escalera para que ocupen el mismo espacio.

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

4. Exporta ambos objetos juntos como un único modelo *glTF* .

Ahora, cuando los jugadores vean las escaleras en tu Scene, verán el modelo más detallado, pero al subirlas chocarán contra la rampa.

## Optimizar los Colliders

* Es preferible usar Colliders de **caja**, **esfera** y **cápsula** porque ofrecen un mejor rendimiento durante la carga y en tiempo de ejecución.
* Considera aproximar una Mesh de colisión compleja usando varias Meshes de colisión primitivas (**caja**/**esfera**/**cápsula**)

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

*Ejemplo: el Collider de un anillo puede componerse de varios Colliders de cápsula o caja*

* Coloca la Mesh de colisión dentro de la jerarquía del objeto al que está asociada. Por ejemplo, Spaceship\_collider puede ser un elemento secundario dentro del objeto principal Spaceship (desde el punto de vista de la jerarquía).

### Colliders convexos y cóncavos

Si usar un collider de malla arbitraria es la única posibilidad, haz que la malla de colisión sea convexa (no cóncava). Esto evitará situaciones físicas extrañas, como movimientos entrecortados, quedar atascado dentro del collider o atravesarlo. Ten en cuenta que a menudo es posible imitar una malla cóncava con varias mallas convexas.

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

## Nombres de colisión

**Usa nombres descriptivos. El nombre debe indicar dónde se usa el asset o a qué parte del objeto corresponde.**

Para nombrar assets, usamos una combinación de `PascalCase` y `snake_case`, a la que podemos llamar `PascalSnake_case`. Las reglas básicas son: cada palabra nueva o palabra que sigue a un separador (`_`) empieza con **mayúscula.**

Collision Mesh es la malla que se usa como referencia para crear un collider en el Explorer.

* Sigue los mismos principios que las mallas anteriores, pero lleva el sufijo `_collider` al final. **Ejemplos:** 🟢 **Se prefieren** nombres como: `Tram_Wheel_LeftFront_collider` 🔴 **Evita** nombres como: `Primitive.001_Collider`, `collider (1)`, `Cylinder.007_collider`,

{% hint style="warning" %}
**🔥Consejo de optimización🔥**

Si un collider se puede aproximar con una forma Box, Sphere o Capsule, añade uno de estos tres sufijos: \_box, \_sphere o \_capsule. Usar estas tres formas en lugar de una malla arbitraria para la detección de colisiones mejorará el rendimiento de la Scene y reducirá el tiempo de carga 💪🚀

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

## Buenas prácticas para colliders

* **Usa siempre la menor cantidad posible de triángulos al crear colliders.** Evita copiar un objeto complejo para usarlo como collider. Los colliders simples garantizan una buena experiencia de usuario y ayudan a mantener la Scene dentro de los límites de triángulos.
* **Los objetos collider no deben tener ningún Material**, ya que los jugadores de tu Scene nunca lo verán. Los colliders son invisibles para los jugadores.
* **Todos los nombres de objetos collider deben terminar en \_*****collider*****.** Por ejemplo, T*ree\_collider*.
* **Si usas un \_plane**\_\*\* como collider, bloqueará solo en una dirección.\*\* Si quieres que los colliders bloqueen desde ambos lados, por ejemplo, en una pared, debes crear dos planos con las normales orientadas en direcciones opuestas.
* Al duplicar objetos collider, presta atención a sus nombres. Algunos programas añaden un \_*1* al final del nombre de archivo para evitar duplicados; por ejemplo, *tree\_collider\_1*. Los objetos con nombres como este serán interpretados por Decentraland World Engine como objetos normales, no como colliders.
* Puedes evitar añadir una malla collider si añades un componente `MeshCollider` invisible a la entidad, que aproxime la forma del modelo 3D.
* También puedes evitar añadir una malla collider si configuras el componente `GLTFContainer` para que use la geometría visible como collider. Consulta [**Colliders en modelos 3D**](https://docs.decentraland.org/creator/development-guide/sdk7/colliders/#colliders-on-3d-models) .
* Si estás creando un modelo 3D con muchas formas de Mesh, cada una con su propio Collider, hay algunos complementos útiles que pueden ayudarte. En Blender puedes usar la opción de cambio de nombre por lotes dentro de Blender \*\*\*\*para agregar automáticamente un `_collider` como sufijo a todos los nombres de Mesh de un grupo. Encontrarás más información sobre esta herramienta en la sección «**Uso de Blender para cambiar el nombre de los 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-es/modelado-y-animaciones-3d/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.
