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

This page documents the different directories used by Blender.

This can be helpful for troubleshooting, automation and customization.

User Directories#

User directories store preferences, startup file, installed extensions, presets and more. By default these use the standard configuration folders for each operating system.

Linux#

$HOME/.config/blender/4.2/

If the $XDG_CONFIG_HOME environment variable is set:

$XDG_CONFIG_HOME/blender/4.2/

macOS#

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

Windows#

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

Portable Installation#

When running Blender from a portable drive, it’s possible to keep the configuration files on the same drive to take with you.

To enable this, create a folder named portable at the following locations:

  • Windows: Next to the Blender executable, in the unzipped folder

  • Linux: Next to the Blender executable, in the unzipped folder

  • macOS: Inside the application bundle at Blender.app/Contents/Resources

This folder will then store preferences, startup file, installed extensions and presets.

Переменные среды (Environment Variables)#

The BLENDER_USER_RESOURCES environment variable can be set to a custom directory to replace the default user directory.

System Directories#

System directories store files that come bundled with Blender and are required for it to function. This includes scripts, presets, essential assets and more.

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\

Переменные среды (Environment Variables)#

BLENDER_SYSTEM_SCRIPTS and BLENDER_SYSTEM_EXTENSIONS environment variables can be used to bundle additional scripts and extensions, that are not part of the regular Blender installation.

Other BLENDER_SYSTEM environment variables can override other system paths, though are not commonly used in practice.

Схема путей#

./autosave

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

Located in user directories.

./config

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

Located in user directories.

./config/startup.blend

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

./config/userpref.blend

User preferences.

./config/bookmarks.txt

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

./config/recent-files.txt

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

./config/{APP_TEMPLATE_ID}/startup.blend

Startup file for an application template.

./config/{APP_TEMPLATE_ID}/userpref.blend

User preferences file for an application template.

./datafiles

Data files loaded at runtime.

Located in both user and system directories. User data files either override or add to system data files.

./datafiles/colormanagement

Default OpenColorIO configuration.

./datafiles/fonts

User interface fonts.

./datafiles/studiolights

Studio light images for 3D viewport.

./extensions

Extension repositories.

Located in both user and system directories. Repositories are loaded from both directories.

./scripts

Add-ons, presets, templates, user interface, startup scripts.

Located in both user and system directories. Scripts are loaded from both directories.

./scripts/addons/*.py

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

./scripts/addons/modules/*.py

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

./scripts/addons_core/*.py

The add-ons directory which is used for bundled add-ons.

./scripts/addons_core/modules/*.py

Modules for addons_core to use (added to Python’s sys.path when it found).

./scripts/modules/*.py

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

./scripts/startup/*.py

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

./scripts/startup/bl_app_templates_user/{APP_TEMPLATE_ID}

Application templates installed in user directories.

./scripts/startup/bl_app_templates_system/{APP_TEMPLATE_ID}

pplication templates automatically loaded from system directories.

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

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

./scripts/templates_py/*.py

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

./scripts/templates_osl/*.osl

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

./python

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

Located in system directories.

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

Каталог кэша используется для локального хранения постоянных (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/.