Proceso de importación

Importando recursos en Godot 3.0+

Previamente, importar recursos en Godot 2.x requería mantener una carpeta separada del directorio con los recursos originales. Sin hacer esto, era imposible especificar cómo convertir y cambiar banderas de texturas, audios, escenas, etc.

In Godot 3.0+, we use a more modern approach to importing: Simply drop your assets (image files, scenes, audio files, fonts, etc) directly in the project folder (copy them manually with your OS file explorer). Godot will automatically import these files internally and keep the imported resources hidden in a res://.import folder.

This means that when trying to access imported assets through code you need to use the Resource Loader as it will automatically take into account where the internal files are saved. If you try and access an imported asset using the File class it will work in the editor, but break in the exported project.

However, the Resource Loader cannot access non imported files, only the File class can.

Cambiando parámetros de importación

To change the import parameters of an asset in Godot (again, keep in mind import parameters are only present in non-native Godot resource types) select the relevant resource in the filesystem dock:

../../../_images/asset_workflow1.png

A continuación, después de ajustar los parámetros, pulsa "Reimportar". Los parámetros utilizados serán sólo para este recurso y serán utilizados en futuras reimportaciones.

También es posible modificar los parámetros de importación de varios recursos al mismo tiempo. Simplemente selecciónalos a todos en el panel de recursos y los parámetros indicados se aplicarán a todos al reimportar.

Reimporting multiple assets

While working on a project you may find that several assets need to have the same parameters changed, such as enabling mipmaps, but you only want those specific parameters changed. To do this, select every asset you want to reimport in the file system. In the import tab there will now be a checkbox to the left of every import parameter.

../../../_images/reimport_multiple.png

Select the checkbox of the parameters you want to change on your imported assets, then change the parameters normally. Finally, click the reimport button and every selected asset will be reimported with only those parameters changed.

Reimportación automática

Cuando el checksum MD5 de un recurso de origen cambia, Godot realizará una reimportación automática del mismo, aplicando el preset configurado para ese recurso específico.

Archivos generados

Al importar se agregará un archivo adicional <asset>.import, que contiene la configuración de importación ¡Asegúrate de enviarlos a tu sistema de control de versiones!

../../../_images/asset_workflow4.png

Además, los assets adicionales estarán preestablecidos en la carpeta oculta res://.import:

../../../_images/asset_workflow5.png

Si alguno de los archivos presentes en esta carpeta es borrado (o toda la carpeta), el recurso o recursos se reimportarán automáticamente. Como tal, la confirmación de esta carpeta al sistema de control de versiones es opcional. Puedes ahorrar tiempo en la reimportación al realizar el proceso en otra computadora, pero ocupa mucho más espacio y tiempo de transferencia. ¡Elige lo que más te convenga!

Cambiar el tipo de recurso importado

Algunos recursos de origen pueden importarse como diferentes tipos de recursos. Para ello, selecciona el tipo de recurso deseado y pulsa "Reimportar":

../../../_images/asset_workflow2.png

Cambiar los parámetros de importación por defecto

Diferentes tipos de juegos pueden requerir diferentes valores predeterminados. El cambio de los valores predeterminados por proyecto se puede lograr utilizando el botón "Preset..." del menú. Además hay algunos tipos de recursos que ofrecen configuraciones preestablecidas, la configuración por defecto también se puede guardar y borrar:

../../../_images/asset_workflow3.png

¡La sencillez es la clave!

Esto es un flujo de trabajo simple el cual tomará poco tiempo en acostumbrarse. También fuerza un modo mejor para tratar con recursos.

Existen muchos tipos de recursos disponibles para importar, así que por favor continúa leyendo para entender cómo trabajar con todos ellos!