Макет каталога Blender

На этой странице описаны различные каталоги, используемые Blender (что может быть полезно при устранении неполадок).

Существует три разных каталога, которые может использовать Blender, их точное расположение зависит от платформы.

LOCAL (локальный):: Расположение данных конфигурации и работы программы (для автономного пакета).
USER (пользовательский):: Расположение файлов конфигурации (обычно в домашнем каталоге пользователя).
SYSTEM (системный):: Расположение данных работы программы для общесистемной установки (могут быть доступны только для чтения).

Для установки Blender необходимо наличие как СИСТЕМНОГО, так и ПОЛЬЗОВАТЕЛЬСКОГО каталогов.

Для локально извлеченных дистрибутивов Blender, пользовательская конфигурация и данные времени выполнения (run-time data) хранятся в одном и том же подкаталоге, что позволяет нескольким версиям Blender работать без конфликтов, игнорируя файлы USER и SYSTEM. Для этого вам необходимо создать папку с именем config в каталоге LOCAL.

Пути файлов, в зависимости от ОС

Здесь перечислены пути, определённые по умолчанию для каждой операционной системы:

Linux

LOCAL (локальный):

./3.6/

USER (пользовательский):

$HOME/.config/blender/3.6/

SYSTEM (системный):

/usr/share/blender/3.6/

Примечание

Путь ./3.6/ относится к исполняемому файлу Blender и используется для автономных пакетов, распространяемых официальными сборками blender.org.

Примечание

Путь USER будет использовать $XDG_CONFIG_HOME, если установлено:

$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 хранит двоичный файл Blender в ./Blender.app/Contents/MacOS/Blender. Локальный путь к данным и конфигурация:

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

Схема путей

Это макет путей, который используется в описанных выше каталогах.

Например, путь ./config/startup.blend откроется в ~/.blender/3.6/config/startup.blend.

./autosave/ ...

Расположение blend-файла автосохранения. (Только для Windows, временный каталог используется для других систем.)

Порядок поиска: LOCAL, USER.

./config/ ...

Значения по умолчанию и информация о сеансе.

Порядок поиска: LOCAL, USER.

./config/startup.blend

Файл, загружаемый по умолчанию при запуске программы.

./config/userpref.blend

Параметры, загружаемые по умолчанию при запуске программы.

./config/bookmarks.txt

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

./config/recent-files.txt

Список недавно открытых файлов.

./datafiles/ ...

Файлы работы программы (runtime).

Порядок поиска: LOCAL, USER, SYSTEM.

./datafiles/locale/{language}/

Статически скомпилированные языковые файлы для перевода интерфейса программы.

./scripts/ ...

Скрипты Python для пользовательского интерфейса и инструментов.

Порядок поиска: LOCAL, USER, SYSTEM.

./scripts/addons/*.py

Аддоны Python, которые можно включить в настройках, включают поддержку формата импорта/экспорта, интеграцию с механизмом рендера и множество удобных утилит.

./scripts/addons/modules/*.py

Модули для использования аддонов (добавлены в sys.path Python).

./scripts/addons_contrib/*.py

Ещё один каталог, который используется для аддонов, поддерживаемых сообществом (должен быть создан вручную).

./scripts/addons_contrib/modules/*.py

Модули для использования addons_contrib (добавлены в sys.path Python).

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

Порядок поиска: LOCAL, SYSTEM.

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

Каталог кэша используется для локального хранения постоянных (persistent) кэшей. В настоящее время он используется только для индексации библиотеки ассетов. Очевидно, что операционная система не очистит их автоматически.

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

Linux:

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

/Library/Caches/Blender/
Windows:

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

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

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

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

Установленный в пользовательских настройках (смотрите раздел File Paths).
Переменные среды (environment variables) (TEMP в Windows, TMP и TMP_DIR на других платформах).
Каталог /tmp/.

Переопределение каталогов «по умолчанию»

Можно переопределить каталоги «по умолчанию» USER и SYSTEM, используя переменные среды.

Хотя для обычного использования это не требуется, в некоторых специализированных случаях это может быть полезно, например:

Использование общих сетевых дисков для определённых путей.
Изоляция экземпляра от пользовательских файлов «по умолчанию», чтобы предотвратить доступ автоматизированным задачам к пользовательской конфигурации.

Подробности см. в разделе Переменные среды (Environment Variables).