Макет каталога 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.4/

If the $XDG_CONFIG_HOME environment variable is set:

$XDG_CONFIG_HOME/blender/4.4/

macOS

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

Windows

%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.4\

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

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

/usr/share/blender/4.4/

macOS

./Blender.app/Contents/Resources/4.4/

Windows

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

./4.4/

Установщик скачан с сайта blender.org:

%ProgramFiles%\Blender Foundation\Blender\4.4\

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

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

Переменные среды (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 Text Editor ‣ Templates ‣ 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/.