Data paths¶
Path separators¶
For the sake of supporting as many platforms as possible, Godot only
accepts UNIX-style path separators (/
). These work on all
platforms, including Windows.
A path like C:\Projects
will become C:/Projects
.
Resource path¶
As mentioned before, Godot considers that a project exists in any
given folder that contains a project.godot
text file, even if such
file is empty.
Accessing project files can be done by opening any path with res://
as a base. For example, a texture located in the root of the project
folder may be opened from the following path: res://some_texture.png
.
User path (persistent data)¶
While the project is running, it is a common scenario that the resource path will be read-only, due to it being inside a package, self-contained executable, or system-wide install location.
Storing persistent files in such scenarios should be done by using the
user://
prefix, for example: user://game_save.txt
.
On some devices (for example, mobile and consoles), this path is unique
to the project. On desktop operating systems, the engine uses the
typical ~/.local/share/godot/app_userdata/Name
on macOS and Linux,
and %APPDATA%/Name
on Windows. Name
is taken from the
application name defined in the Project Settings, but it can be
overridden on a per-platform basis using
feature tags.