Макет каталога 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 file to load on startup.
./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’ssys.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
Примеры скриптов, к которым можно получить доступ из меню
../scripts/templates_osl/*.osl
Примеры шейдеров OSL, доступ к которым можно получить из
.
./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/
.