Rutas de datos

Separadores de rutas

Con el fin de apoyar tantas plataformas como sea posible, Godot sólo acepta separadores de ruta de estilo UNIX (/). Estos funcionan en todas las plataformas, incluyendo Windows.

Una ruta como C:\Projects se convertirá en C:/Projects.

Ruta del recurso

Como se menciona en Tutorial de línea de comandos, Godot considera que un proyecto existe en cualquier carpeta que contenga un archivo de texto project.godot, incluso si dicho archivo está vacío.

El acceso a los archivos del proyecto se puede hacer abriendo cualquier ruta con res:// como base. Por ejemplo, una textura ubicada en la raíz de la carpeta del proyecto puede abrirse desde la siguiente ruta: res://some_texture.png.

Ruta de usuario (datos persistentes)

Mientras el proyecto esté en marcha, es un escenario común que la ruta de recursos sea de sólo lectura, debido a que está dentro de un paquete, un ejecutable autónomo o una ubicación de instalación en todo el sistema.

El almacenamiento de archivos persistentes en tales escenarios debe hacerse usando el prefijo user://, por ejemplo: user://game_save.txt.

En algunos dispositivos (por ejemplo, móviles y consolas), esta ruta es única para el proyecto. En los sistemas operativos de escritorio, el motor utiliza el típico ~/.local/share/godot/app_userdata/Name en macOS y Linux, y %APPDATA%/Name en Windows. El nombre se toma del nombre de la aplicación definido en la configuración del proyecto, pero puede ser sobrescrito en cada plataforma usando feature tags.

Rutas de datos del editor

El editor utiliza diferentes rutas para los datos del usuario, la configuración del usuario y la caché dependiendo de la plataforma. Por defecto, estas rutas son:

Tipo Localización
Datos de usuario
  • Windows: %APPDATA%\Godot\
  • macOS: ~/Library/Application Support/Godot/
  • Linux: ~/.local/share/godot/
Ajustes de usuario
  • Windows: %APPDATA%\Godot\
  • macOS: ~/Library/Application Support/Godot/
  • Linux: ~/.config/godot/
Cache
  • Windows: %TEMP%\Godot\
  • macOS: ~/Library/Caches/Godot/
  • Linux: ~/.cache/godot/
  • Los datos de usuario contienen plantillas de exportación y datos específicos del proyecto.
  • Los ajustes del usuario contienen ajustes del editor, temas del editor de texto, plantillas de script, etc.
  • La cache contiene datos temporales. Pueden ser eliminados con seguridad cuando Godot se cierre.

Godot cumple con la XDG Base Directory Specification <https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html> en todas las plataformas. Las variables de entorno pueden ser anuladas según la especificación para cambiar las rutas de datos del editor (y del proyecto).

Nota

Si usas Godot empaquetado como un Flatpak, las rutas de datos del editor se ubicarán en subcarpetas como ~/.var/app/org.godotengine.Godot/.

Modo autónomo

Si creas un archivo llamado ._sc_ o _sc_ en el mismo directorio que el binario del editor, Godot habilitará el modo autónomo (self-contained mode). Esto hará que Godot escriba todos los datos del usuario en un directorio llamado editor_data/ en el mismo directorio que el binario del editor. Esto es útil para crear una instalación "portable", que luego puede ser colocada en una unidad USB.

El Steam release of Godot utiliza el modo autónomo por defecto.