This translation is community contributed and may not be up to date. We only maintain the English version of the documentation. Read this manual in English
Defold admite modelos, esqueletos y animaciones en el formato glTF 2.0 (GL Transmission Format). Usa archivos .gltf o .glb para los modelos 3D. glTF es un formato moderno diseñado para transferir y cargar datos 3D en motores de videojuegos y aplicaciones en tiempo real.
Puedes usar herramientas como Maya, 3ds Max, SketchUp y Blender para crear modelos 3D o convertirlos a glTF.
Blender es un programa potente y popular de modelado, animación y renderizado 3D. Funciona en Windows, macOS y Linux y está disponible de forma gratuita en https://www.blender.org.

Para importar un modelo, arrastra y suelta el archivo .gltf o .glb en el panel Assets del editor Defold.
glTF puede almacenarse de dos maneras comunes:
Las imágenes integradas pueden usarse directamente desde un archivo glTF o GLB sin extraerlas como assets independientes. Las imágenes y los buffers externos deben seguir importándose junto con el modelo, conservando sus rutas relativas.
Defold conserva las posiciones y transformaciones del archivo glTF importado y no vuelve a centrar automáticamente el modelo durante la importación. La vista previa del editor y el runtime usan las transformaciones importadas de forma coherente: las mallas con skinning o vinculadas a huesos conservan sus transformaciones locales relativas al esqueleto, mientras que las mallas rígidas mantienen su posición global resultante.
Un componente Model puede seleccionar una única malla con nombre de la escena importada. Dejar vacío el campo Mesh usa toda la escena y conserva las transformaciones descritas anteriormente. Seleccionar una malla usa su geometría local sin las transformaciones de los nodos glTF, por lo que debes colocarla con la transformación del componente Model o del objeto de juego.
Si un modelo creado con una versión anterior de Defold cambia de posición u orientación después de volver a importarlo, corrige la transformación en Blender u otra herramienta de creación y vuelve a exportar el archivo .gltf o .glb.
Las fuentes .gltf y .glb pueden contener geometría comprimida con Draco o Meshopt. Las extensiones de compresión glTF admitidas son:
| Compresión | Extensión glTF |
|---|---|
| Draco | KHR_draco_mesh_compression |
| Meshopt | EXT_meshopt_compression y KHR_meshopt_compression |
Exporta u optimiza tu asset glTF 2.0 usando una de estas extensiones e impórtalo siguiendo los mismos pasos que para un modelo sin comprimir. Incluye los buffers y las texturas externos y conserva sus rutas relativas. Asigna el archivo importado a la propiedad Scene de un componente Model como de costumbre.
Defold decodifica la geometría comprimida durante la importación y la build. El modelo resultante usa la representación geométrica normal de Defold en runtime. Esta compatibilidad no activa la compresión Draco o Meshopt en el motor en ejecución, y un archivo fuente más pequeño no garantiza un bundle de juego más pequeño.
Expande un archivo .gltf o .glb en el panel Assets para explorar sus mallas, materiales generados e imágenes integradas. Al abrir la escena se muestra una vista previa con sus materiales y texturas definidos. También puedes abrir una malla individual para previsualizarla.
Los recursos expuestos dentro del archivo son de solo lectura. Para crear un recurso Model editable para una malla, copia la malla y pégala en una carpeta del proyecto. El archivo .model resultante sigue referenciando el archivo glTF o GLB importado. Para cambiar la geometría fuente o las imágenes integradas, edita el asset en tu herramienta de creación y expórtalo de nuevo.
Los scripts del editor pueden enumerar estos recursos con editor.resource_children(path). Consulta Recorrer los recursos del proyecto para ver un ejemplo que visita recursivamente los recursos de carpetas y archivos glTF/GLB.
Las texturas de modelos pueden usar fuentes .ktx2, tanto como archivos externos como imágenes integradas en un archivo .gltf o .glb. Importa los archivos externos junto con el modelo. Las imágenes KTX2 integradas aparecen bajo la escena en el panel Assets y pueden asignarse directamente a los campos de textura de los materiales o mediante Auto Fill.
Los perfiles de textura determinan si se conserva el formato fuente KTX2 o se convierte a los formatos de salida configurados. Keep KTX2 Format conserva el formato de codificación de origen cuando la compresión de texturas está activada, pero el procesamiento de imágenes puede requerir volver a codificarlo. Comprueba la compatibilidad del formato en tus dispositivos objetivo y considera la posible pérdida adicional de calidad al recomprimir una textura ya comprimida. Consulta Formatos de entrada y vistas previas de KTX2.
Una vez que hayas importado el modelo, úsalo en un componente Model:
El editor ofrece completar las asignaciones cuando la fuente glTF o GLB seleccionada expone materiales. Resuelve tanto las imágenes integradas como las referencias a imágenes externas. Los materiales generados usan los shaders glTF integrados; consulta el manual de PBR para conocer la iluminación y los efectos de material admitidos.
Si eliges Keep Current o necesitas sombreado personalizado, establece cada propiedad Material con un material adecuado. Los materiales gltf integrados proporcionan sombreado PBR; también están disponibles los materiales model integrados y tus propios materiales. Consulta el manual de Model para conocer las variantes estáticas, con skinning y con instancias, y sus requisitos.
Asigna cada textura al campo de textura correspondiente del material. Puedes usar una imagen integrada expuesta bajo el archivo glTF o GLB en el panel Assets, o un asset de imagen independiente del proyecto. Para materiales con varios samplers, asocia cada textura con el sampler previsto; el manual de PBR enumera los nombres de los samplers glTF integrados.
El archivo .gltf o .glb exportado contiene todos los vértices, aristas y caras que componen el modelo, así como las coordenadas UV (qué parte de la imagen de textura se asigna a cierta parte de la malla) si las has definido, los huesos del esqueleto y los datos de animación.
Puedes encontrar una descripción detallada de las mallas poligonales en http://en.wikipedia.org/wiki/Polygon_mesh.
Las coordenadas UV y el mapeado UV se describen en http://en.wikipedia.org/wiki/UV_mapping.
Defold impone algunas limitaciones a los datos de animación exportados:
Actualmente Defold solo admite animaciones horneadas. Las animaciones deben tener matrices para cada hueso animado en cada keyframe, y no posición, rotación y escala como claves separadas.
Las animaciones también se interpolan linealmente. Si usas una interpolación de curvas más avanzada, las animaciones deben prehornearse desde el exportador.
Al exportar un modelo, ten en cuenta que la compatibilidad con glTF puede variar entre herramientas y motores. Usa glTF 2.0 y comprueba que el modelo tenga coordenadas UV correctas si utiliza texturas. Las imágenes pueden integrarse en el archivo glTF o GLB o almacenarse como archivos independientes referenciados por la escena. Incluye todas las imágenes y los buffers externos al importar el modelo a Defold.
Aunque nuestra intención es admitir completamente el formato glTF, todavía no hemos llegado a ese punto. Si falta alguna funcionalidad, crea una solicitud de funcionalidad para ella en nuestro repositorio.
Si quieres crear una imagen de textura manualmente, puedes exportar el layout UV de Blender como plantilla. Comienza seleccionando la malla y todos sus vértices:

Cuando todos los vértices estén seleccionados, desenvuelve la malla para obtener el layout UV:

Luego puedes exportar el layout UV a una imagen que pueda usarse como textura:


Exporta tu modelo desde Blender con File ▸ Export ▸ glTF 2.0 (.glb/.gltf).

Selecciona el objeto o los objetos antes de exportar y activa Selected Objects si solo quieres exportar la selección.
Elige una de las opciones de Format:
Si el modelo contiene animaciones, activa la exportación de animaciones y asegúrate de que las animaciones estén horneadas. Si el modelo usa texturas, asegúrate de que la malla tenga un UV unwrap y de que las imágenes de textura se exporten en un formato que Defold pueda importar, como PNG o JPEG.
