Chemins d'accès aux fichiers dans les projets Godot

Cette page explique comment les chemins de fichiers fonctionnent dans les projets Godot. Vous apprendrez comment accéder aux chemins dans vos projets en utilisant les notations res:// et user:// et où Godot stocke les fichiers utilisateurs sur votre disque-dur.

Séparateurs de chemin

To make supporting multiple platforms easier, Godot only accepts UNIX-style path separators (/). These work on all platforms, including Windows.

Au lieu d'écrire des chemins comme C:\Projects, dans Godot, vous devriez écrire C:/Projects.

Accéder aux fichiers dans le dossier du projet

Godot considère qu'un projet existe dans tout dossier qui contient un fichier texte project.godot, même si ce fichier est vide. Le dossier qui contient ce fichier est le dossier racine de votre projet.

You can access any file relative to it by writing paths starting with res://, which stands for resources. For example, you can access an image file character.png located in the project's root folder in code with the following path: res://character.png.

Accès aux données persistantes des utilisateurs

Pour stocker des fichiers de données persistants, comme la sauvegarde ou les paramètres du joueur, vous devez utiliser user:// au lieu de res:// comme préfixe de votre chemin. En effet, lorsque le jeu est en cours d'exécution, le système de fichiers du projet sera probablement en lecture seule.

The user:// prefix points to a different directory on the user's device. Unlike res://, the directory pointed at by user:// is guaranteed to be writable to, even in an exported project.

On desktop platforms, the actual directory paths for user:// are:

Type

Localisation

Données utilisateur

  • Windows : %APPDATA%\Godot\app_userdata\[project_name]

  • macOS: ~/Library/Application Support/Godot/app_userdata/[project_name]

  • Linux: ~/.local/share/godot/app_userdata/[project_name]

Données utilisateur (lorsque le paramètre du projet use_custom_user_dir est true)

  • Windows : %APPDATA%\[project_name]

  • macOS : ~/Library/Application Support/[project_name]

  • Linux : ~/.local/share/[project_name]

[project_name] is based on the application name defined in the Project Settings, but you can override it on a per-platform basis using feature tags.

On mobile platforms, this path is unique to the project and is not accessible by other applications for security reasons.

Sur les exportations HTML5, user:// fera référence à un système de fichiers virtuel stocké sur le périphérique via IndexedDB. (L'interaction avec le système de fichiers principal peut toujours être effectuée par le singleton JavaScript.)

Chemins de données de l'éditeur

L'éditeur utilise différents chemins pour les données utilisateur, les paramètres utilisateur et le cache en fonction de la plate-forme. Par défaut, ces chemins sont :

Type

Localisation

Données utilisateur

  • Windows : %APPDATA%\Godot\app_userdata\[project_name]

  • macOS : ~/Library/Application Support/Godot/[project_name]

  • Linux : ~/.local/share/godot/[project_name]

Données utilisateur (lorsque le paramètre du projet use_custom_user_dir est true)

  • Windows : %APPDATA%\[project_name]

  • macOS : ~/Library/Application Support/[project_name]

  • Linux : ~/.local/share/[project_name]

Réglages utilisateur

  • Windows : C:\Users\[username]\AppData\Roaming\Godot\app_userdata\[Name]

  • macOS : ~/Library/Application Support/Godot/

  • Linux : ~/.config/godot/

Cache

  • Windows : %TEMP%\Godot\

  • macOS : ~/Library/Caches/Godot/

  • Linux : ~/.cache/godot/

  • Les données utilisateur contiennent des modèles d'exportation et des données spécifiques au projet.

  • Paramètres utilisateur contient les paramètres de l'éditeur, les thèmes de l'éditeur de texte, les modèles de script, etc.

  • Cache contient des données temporaires. Il peut être supprimé en toute sécurité lorsque Godot est fermé.

Godot est conforme à la XDG Base Directory Specification sur toutes les plateformes. Les variables d'environnement peuvent être remplacées selon la spécification pour modifier les chemins de données de l'éditeur et du projet.

Note

Si vous utilisez Godot comme package Flatpak, les chemins de données de l'éditeur seront situés dans des sous-dossiers de ~/.var/app/org.godotengine.Godot/.

Mode autonome

Si vous créez un fichier appelé ._sc_ ou _sc_ dans le même répertoire que le binaire de l'éditeur, Godot activera le mode self-contained. Ceci fera que Godot écrira toutes les données utilisateur dans un répertoire nommé editor_data/ dans le même répertoire que le binaire de l'éditeur. Vous pouvez l'utiliser pour créer une installation portable de l'éditeur.

La version Steam de Godot utilise le mode autonome par défaut.

Note

Self-contained mode is not supported in exported projects yet. To read and write files relative to the executable path, use OS.get_executable_path(). Note that writing files in the executable path only works if the executable is placed in a writable location (i.e. not Program Files or another directory that is read-only for regular users).