Data paths
Path separators
For the sake of supporting as many platforms as possible, Godot only accepts unix style path separators (/
). These work everywhere, including Windows.
A path like: C:\Projects
will become C:/Projects
.
Resource path
As mentioned before. Godot considers that a project exists at any given folder that contains an “engine.cfg” 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://sometexture.png
.
Userdata path (persistent data)
While the project is running, it is a very 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://gamesave.txt
.
In some devices (for example, mobile ad consoles) this path is unique for the app. Under desktop operating systems, the engine uses the typical ~/.Name (check the project name under the settings) in OSX and Linux, and APPDATA/Name for Windows.
© 2014–2020 Juan Linietsky, Ariel Manzur and the Godot community
Licensed under the Creative Commons Attribution Unported License v3.0.
https://docs.godotengine.org/en/2.1/learning/features/misc/data_paths.html