Blender’s Directory Layout#

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

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

ЛОКАЛЬНЫЙ:

Место расположения данных конфигурации и работы программы (для автономного пакета).

ПОЛЬЗОВАТЕЛЬСКИЙ:

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

СИСТЕМНЫЙ:

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

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

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

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

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

Linux#

ЛОКАЛЬНЫЙ:
./4.1/
ПОЛЬЗОВАТЕЛЬСКИЙ:
$HOME/.config/blender/4.1/
СИСТЕМНЫЙ:
/usr/share/blender/4.1/

Примечание

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

Примечание

ПОЛЬЗОВАТЕЛЬСКИЙ путь будет использовать $XDG_CONFIG_HOME, если установлено:

$XDG_CONFIG_HOME/blender/4.1/

macOS#

ЛОКАЛЬНЫЙ:
./4.1/
ПОЛЬЗОВАТЕЛЬСКИЙ:
/Users/$USER/Library/Application Support/Blender/4.1/
СИСТЕМНЫЙ:
/Library/Application Support/Blender/4.1/

Примечание

macOS хранит двоичный файл Blender в ./Blender.app/Contents/MacOS/Blender. Локальный путь к данным и конфигурация:

./Blender.app/Contents/Resources/4.1/

Окна#

ЛОКАЛЬНЫЙ:
.\4.1\
ПОЛЬЗОВАТЕЛЬСКИЙ:
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.1\
СИСТЕМНЫЙ:
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.1\

Примечание

For installations from the Window’s Store, the USER and SYSTEM directories are inside a special folder resembling:

%ProgramFiles%\WindowsApps\BlenderFoundation.Blender<HASH>\Blender\4.1\

Where «HASH» is a string specific to each installation.

Расположение путей#

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

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

./autosave/ ...

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

Порядок поиска: ЛОКАЛЬНЫЙ, ПОЛЬЗОВАТЕЛЬСКИЙ.

./config/ ...

Установки по умолчанию и информация о сессии.

Порядок поиска: ЛОКАЛЬНЫЙ, ПОЛЬЗОВАТЕЛЬСКИЙ.

./config/startup.blend

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

./config/userpref.blend

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

./config/bookmarks.txt

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

./config/recent-files.txt

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

./datafiles/ ...

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

Порядок поиска: ЛОКАЛЬНЫЙ, ПОЛЬЗОВАТЕЛЬСКИЙ, СИСТЕМНЫЙ.

./datafiles/locale/{язык}/

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

./scripts/ ...

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

Порядок поиска: ЛОКАЛЬНЫЙ, ПОЛЬЗОВАТЕЛЬСКИЙ, СИСТЕМНЫЙ.

./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/{пресет}/*.py

Пресеты, используемые для хранения пользовательских параметров ткани, форматов визуализации и т.д.

./scripts/templates_py/*.py

Примеры скриптов, к которым можно получить доступ из меню Редактор текста ‣ Шаблоны ‣ Python (Text Editor ‣ Templates ‣ Python).

./scripts/templates_osl/*.osl

Примеры скриптов, к которым можно получить доступ из меню Редактор текста ‣ Шаблоны ‣ Open Shading Language (Text Editor ‣ Templates ‣ Open Shading Language).

./python/ ...

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

Порядок поиска: ЛОКАЛЬНЫЙ, СИСТЕМНЫЙ.

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.

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

  • Linux:

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

  • macOS:

    /Library/Caches/Blender/

  • Окна:

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

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

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

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

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

  • Переменные среды (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.