Blender’s Directory Layout – Розстава Каталогів Blender’а

This page documents the different directories used by Blender (which can be helpful for troubleshooting).

There are three different directories Blender may use, their exact locations are platform dependent.

LOCAL:

Location of configuration and run-time data (for self-contained bundle).

USER:

Location of configuration files (typically in the user’s home directory).

SYSTEM:

Location of run-time data for system wide installation (may be read-only).

For system installations both SYSTEM and USER directories are needed.

For locally extracted Blender distributions, the user configuration and run-time data are kept in the same subdirectory, allowing multiple Blender versions to run without conflict, ignoring the USER and SYSTEM files. This requires you to create a folder named config in the LOCAL directory.

Platform Dependent Paths

Here are the default locations for each system:

Linux

LOCAL:
./3.6/
USER:
$HOME/.config/blender/3.6/
SYSTEM:
/usr/share/blender/3.6/

Примітка

The path ./3.6/ is relative to the Blender executable and is used for self-contained bundles distributed by official blender.org builds.

Примітка

The USER path will use $XDG_CONFIG_HOME if it is set:

$XDG_CONFIG_HOME/blender/3.6/

macOS

LOCAL:
./3.6/
USER:
/Users/$USER/Library/Application Support/Blender/3.6/
SYSTEM:
/Library/Application Support/Blender/3.6/

Примітка

macOS stores the Blender binary in ./Blender.app/Contents/MacOS/Blender. The local path to data and config is:

./Blender.app/Contents/Resources/3.6/

Windows

LOCAL:
.\3.6\
USER:
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.6\
SYSTEM:
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.6\

Примітка

For installations from the Window’s Store, the USER and SYSTEM directories are inside a special folder resembling: %USERPROFILE%\AppData\Local\Packages\BlenderFoundation.Blender<HASH>\LocalCache\Roaming\Blender Foundation\Blender where «HASH» is a string specific to each installation.

Path Layout – Розстава Шляхів

This is the path layout which is used within the directories described above.

Where ./config/startup.blend could be ~/.blender/|BLENDER_VERSION|/config/startup.blend for example.

./autosave/ ...

Розміщення автозбережених blend-файлів. (лише Windows, каталог «temp» використовується для інших систем.)

Search order: LOCAL, USER.

./config/ ...

Defaults & session info.

Search order: LOCAL, USER.

./config/startup.blend

Default file to load on startup.

./config/userpref.blend

Default preferences to load on startup.

./config/bookmarks.txt

Закладки Оглядача Файлів – File Browser.

./config/recent-files.txt

Список для меню недавніх файлів.

./datafiles/ ...

Runtime files.

Search order: LOCAL, USER, SYSTEM.

./datafiles/locale/{language}/

Static precompiled language files for UI translation.

./scripts/ ...

Python scripts for the user interface and tools.

Search order: LOCAL, USER, SYSTEM.

./scripts/addons/*.py

Додатки на Python, які можуть вмикатися в уподобаннях Preferences, включаючи підтримку імпорту/експорту форматів, інтеграцію рушіїв рендера та багато зручних утиліт.

./scripts/addons/modules/*.py

Модулі для використовуваних додатків (додається у системний шлях sys.path для Python).

./scripts/addons_contrib/*.py

Another add-ons directory which is used for community maintained add-ons (must be manually created).

./scripts/addons_contrib/modules/*.py

Modules for addons_contrib to use (added to Python’s sys.path).

./scripts/modules/*.py

Модулі для Python, що містять наше ядро API та функції утиліт для інших скриптів для імпорту (додається у системний шлях sys.path для Python).

./scripts/startup/*.py

Скрипти, які автоматично імпортуються при запуску.

./scripts/presets/{preset}/*.py

Передустави, що використовуються для зберігання визначених користувачем устав для тканин, форматів рендера тощо.

./scripts/templates_py/*.py

Приклади скриптів, які доступні через «Редактор Тексту > Шаблони > Python» – Text Editor ‣ Templates ‣ Python.

./scripts/templates_osl/*.osl

Приклади шейдерів на мові OSL, які доступні через «Редактор Тексту > Шаблони > Відкрита Мова Відтінення» – Text Editor ‣ Templates ‣ Open Shading Language.

./python/ ...

Дистрибутив Python у комплекті з Blender’ом.

Search order: LOCAL, SYSTEM.

Local Cache Directory

The cache directory is used to store persistent caches locally. Currently it is only used for the indexing of Asset Libraries. The operating system is not expected to clear this automatically.

The following path will be used:

  • Linux:

    $XDG_CACHE_HOME/blender/ if $XDG_CACHE_HOME is set, otherwise $HOME/.cache/blender/

  • macOS:

    /Library/Caches/Blender/

  • Windows:

    %USERPROFILE%\AppData\Local\Blender Foundation\Blender\Cache\

Temporary Directory – Тимчасова Директорія

Тимчасова директорія використовується для зберігання різних файлів під час прогону (включаючи шари рендера, кеш фізики, буфер копіювання-вставляння та логи крахів).

Тимчасова директорія вибирається, базуючись на наступному пріоритеті:

  • User Preference – Уподобання Користувача (дивіться File Paths – Шляхи Файлів).

  • Environment variables – Змінні середовища (TEMP на Windows, TMP і TMP_DIR на інших платформах).

  • Директорія /tmp/.

Overriding Default Directories

It’s possible to override the default USER and SYSTEM directories using environment variables.

While this shouldn’t be needed for typical usage, some specialized use cases may take advantage of this, such as:

  • Using a shared network drives for specific paths.

  • Isolating an instance from the default user files to prevent automated tasks from accessing user configuration.

See Environment Variables – Змінні Середовища for details.