godotengine/godot-docs
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs.git synced 2026-01-03 05:48:42 +03:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #5463 from skyace65/data-path

Browse Source 
Fix and expand user data path information
This commit is contained in:
Max Hilbrunner
2021-12-29 18:36:15 +01:00
committed by GitHub
parent fbc887ab2d fefe84fb23
commit dc0819b593
1 changed files with 24 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files

43
tutorials/io/data_paths.rst
View File

@@ -37,10 +37,11 @@ when the game is running, the project's file system will likely be read-only.
The ``user://`` prefix points to a different directory on the user's device. On
mobile and consoles, this path is unique to the project. On desktop, the engine
stores user files in ``~/.local/share/godot/app_userdata/Name`` on
Linux, ``~/Library/Application Support/Godot/app_userdata/Name`` on macOS (since Catalina) and ``%APPDATA%/Name`` on Windows. ``Name`` is based on the application
name defined in the Project Settings, but you can override it on a per-platform
basis using :ref:`feature tags <doc_feature_tags>`.
stores user files in ``~/.local/share/godot/app_userdata/[project_name]`` on
Linux, ``~/Library/Application Support/Godot/app_userdata/[project_name]`` on
macOS (since Catalina) and ``%APPDATA%\Godot\app_userdata\[project_name]`` on Windows.
``[project_name]`` is based on the application name defined in the Project Settings, but
you can override it on a per-platform basis using :ref:`feature tags <doc_feature_tags>`.
On HTML5 exports, ``user://`` will refer to a virtual filesystem stored on the
device via IndexedDB. (Interaction with the main filesystem can still be performed
@@ -65,21 +66,25 @@ Editor data paths
The editor uses different paths for user data, user settings, and cache,
depending on the platform. By default, these paths are:
+---------------+---------------------------------------------------+
| Type | Location |
+===============+===================================================+
| User data | - Windows: ``%APPDATA%\Godot\`` |
| | - macOS: ``~/Library/Application Support/Godot/`` |
| | - Linux: ``~/.local/share/godot/`` |
+---------------+---------------------------------------------------+
| User settings | - Windows: ``%APPDATA%\Godot\`` |
| | - macOS: ``~/Library/Application Support/Godot/`` |
| | - Linux: ``~/.config/godot/`` |
+---------------+---------------------------------------------------+
| Cache | - Windows: ``%TEMP%\Godot\`` |
| | - macOS: ``~/Library/Caches/Godot/`` |
| | - Linux: ``~/.cache/godot/`` |
+---------------+---------------------------------------------------+
+-------------------------------+----------------------------------------------------------------+
| Type | Location |
+===============================+================================================================+
| User data | - Windows: ``%APPDATA%\Godot\app_userdata\[project_name]`` |
| | - macOS: ``~/Library/Application Support/Godot/[project_name]``|
| | - Linux: ``~/.local/share/godot/[project_name]`` |
+-------------------------------+----------------------------------------------------------------+
| User data | - Windows: ``%APPDATA%\[project_name]`` |
| (when ``use_custom_user_dir`` | - macOS: ``~/Library/Application Support/[project_name]`` |
| project setting is ``true``) | - Linux: ``~/.local/share/[project_name]`` |
+-------------------------------+----------------------------------------------------------------+
| User settings | - Windows: ``%APPDATA%\Godot\`` |
| | - macOS: ``~/Library/Application Support/Godot/`` |
| | - Linux: ``~/.config/godot/`` |
+-------------------------------+----------------------------------------------------------------+
| Cache | - Windows: ``%TEMP%\Godot\`` |
| | - macOS: ``~/Library/Caches/Godot/`` |
| | - Linux: ``~/.cache/godot/`` |
+-------------------------------+----------------------------------------------------------------+
- **User data** contains export templates and project-specific data.
- **User settings** contains editor settings, text editor themes, script