Blender’s Directory Layout

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.

ЛОКАЛЬНЫЙ

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

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

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

СИСТЕМНЫЙ

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

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

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.

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

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

Linux

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

Примечание

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

Примечание

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

$XDG_CONFIG_HOME/blender/3.4/

macOS

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

Примечание

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

./Blender.app/Contents/Resources/3.4/

Windows

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

Примечание

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

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

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

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

./autosave/ ...

Autosave blend-file location. (Windows only, temp directory used for other systems.)

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

./config/ ...

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

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

./config/startup.blend

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

./config/userpref.blend

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

./config/bookmarks.txt

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

./config/recent-files.txt

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

./datafiles/ ...

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

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

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

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

./scripts/ ...

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

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

./scripts/addons/*.py

Python add-ons which may be enabled in the Preferences include import/export format support, render engine integration and many handy utilities.

./scripts/addons/modules/*.py

Modules for add-ons to use (added to Python’s sys.path).

./scripts/addons_contrib/*.py

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

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

  • Windows

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

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

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

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

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

  • Environment variables (TEMP on Windows, TMP & TMP_DIR on other platforms).

  • Каталог /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.