Макет папок Blender’а#

На этой странице описываются различные папки, используемые Blender’ом.

Данная информация может быть полезна для настройки, устранения неполадок и автоматизации.

Пользовательские папки#

В пользовательских папках хранятся настройки, файлы автозагрузки, установленные расширения, пресеты и многое другое. По умолчанию они используют стандартные папки конфигурации для каждой операционной системы.

Linux#

$HOME/.config/blender/4.2/

Если установлена переменная среды $XDG_CONFIG_HOME:

$XDG_CONFIG_HOME/blender/4.2/

macOS#

/Users/$USER/Library/Application Support/Blender/4.2/

Windows#

%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.2\

Портативная установка#

При запуске Blender’а с переносного диска, – можно сохранять файлы конфигурации на том же диске и брать их с собой.

Чтобы это реализовать, – создайте папку с именем portable в следующих местах:

  • Windows: рядом с исполняемым файлом Blender’а, в распакованной папке

  • Linux: рядом с исполняемым файлом Blender’а, в распакованной папке

  • macOS: внутри пакета приложения в Blender.app/Contents/Resources

В этой папке будут храниться настройки, файл запуска, установленные расширения и пресеты.

Переменные среды#

Переменную среду BLENDER_USER_RESOURCES можно задать в качестве пользовательской папки для замены пользовательской папки по умолчанию.

Системные папки#

В системных папках хранятся файлы, поставляемые вместе с Blender’ом и те, что необходимы для его работы. Сюда входят скрипты, пресеты, необходимые ассеты и многое другое.

Linux#

Архив, скачанный с сайта blender.org:

./4.2/

Дистрибутивы Linux:

/usr/share/blender/4.2/

macOS#

./Blender.app/Contents/Resources/4.2/

Windows#

ZIP-файл, скачанный с сайта blender.org:

./4.2/

Установщик, который был скачан с сайта blender.org:

%ProgramFiles%\Blender Foundation\Blender\4.2\

Установка Microsoft Store:

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

Переменные среды#

Переменные среды BLENDER_SYSTEM_SCRIPTS и BLENDER_SYSTEM_EXTENSIONS могут использоваться для сборки дополнительных скриптов и расширений, которые не являются частью обычной установки Blender’а.

Другие переменные среды BLENDER_SYSTEM могут переопределять другие системные пути, хотя на практике они обычно не используются.

Схема путей#

./autosave

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

Расположены в пользовательских папках.

./config

Конфигурация пользователя и информация о сеансе.

Расположены в пользовательских папках.

./config/startup.blend

Blend-файл для загрузки при запуске.

./config/userpref.blend

Настройки пользователя.

./config/bookmarks.txt

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

./config/recent-files.txt

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

./config/{APP_TEMPLATE_ID}/startup.blend

Файл запуска для шаблона приложения.

./config/{APP_TEMPLATE_ID}/userpref.blend

Файл пользовательских настроек для шаблона приложения.

./datafiles

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

Расположены как в пользовательских, так и в системных папках. Файлы пользовательских данных либо переопределяют, либо дополняют файлы системных данных.

./datafiles/colormanagement

Конфигурация OpenColorIO по умолчанию.

./datafiles/fonts

Шрифты пользовательского интерфейса.

./datafiles/studiolights

Изображения студийного освещение для 3D-вьюпорта.

./extensions

Репозитории расширений.

Расположены как в пользовательских, так и в системных папках. Репозитории загружаются из обоих папок.

./scripts

Аддоны, пресеты, шаблоны, пользовательский интерфейс, скрипты запуска.

Расположены как в пользовательских, так и в системных папках. Скрипты загружаются из обоих папок.

./scripts/addons/*.py

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

./scripts/addons/modules/*.py

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

./scripts/addons_core/*.py

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

./scripts/addons_core/modules/*.py

Модули для использования addons_core (добавляются в sys.path Python’а при его обнаружении).

./scripts/modules/*.py

Модули Python’а, содержащие наши основные функции API, а также вспомогательные функции для других скриптов, предназначенных для импорта (добавляются к sys.path Python’а).

./scripts/startup/*.py

Скрипты, которые автоматически импортируются при запуске.

./scripts/startup/bl_app_templates_user/{APP_TEMPLATE_ID}

Шаблоны приложений, устанавливаемые в пользовательских папках.

./scripts/startup/bl_app_templates_system/{APP_TEMPLATE_ID}

Шаблоны приложений, автоматически загружаемые из системных папок.

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

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

./scripts/templates_py/*.py

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

./scripts/templates_osl/*.osl

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

./python

Встроенный дистрибутив Python.

Расположены в системных папках.

Локальная папка кэша#

Папка кэша используется для локального хранения постоянных кэшей. В настоящее время она используется только для индексации библиотеки ассетов. Операционная система не должна очищать её автоматически.

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

  • 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)»).

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

  • Папка /tmp/.