Макет каталога 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.3/
USER
$HOME/.config/blender/3.3/
SYSTEM
/usr/share/blender/3.3/

Примечание

The path ./3.3/ 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.3/

macOS

LOCAL
./3.3/
USER
/Users/$USER/Library/Application Support/Blender/3.3/
SYSTEM
/Library/Application Support/Blender/3.3/

Примечание

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

./Blender.app/Contents/Resources/3.3/

Windows

LOCAL
.\3.3\
USER
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.3\
SYSTEM
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.3\

Схема путей

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, временный каталог используется для других систем.)

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

Закладки файлового браузера.

./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, которые можно включить в настройках, включают поддержку формата импорта/экспорта, интеграцию с механизмом рендера и множество удобных утилит.

./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.

./scripts/templates_osl/*.osl

Примеры шейдеров OSL, доступ к которым можно получить из Текстовый редактор ‣ Шаблоны ‣ Open Shading Language.

./python/ ...

Пакетный дистрибутив Python.

Search order: LOCAL, SYSTEM.

Каталог локального кэша

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

Будет использован следующий путь:

  • Linux

    $XDG_CACHE_HOME/blender/, если установлен $XDG_CACHE_HOME, в противном случае $HOME/.cache/blender/

  • macOS

    /Library/Chaches/Blender/

  • Windows

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

Каталог для временных файлов

Каталог временных файлов используется для хранения различных временных файлов во время работы Blender’а (включая: слои визуализации, кэш физики, буфер копирования-вставки и журналы аварийного завершения программы).

Временный каталог выбирается исходя из следующего приоритета:

  • Установленный в пользовательских настройках (смотрите раздел File Paths).

  • Переменные среды (environment variables) (TEMP в Windows, TMP и TMP_DIR на других платформах).

  • Каталог /tmp/.