Estructura de Directorios de Blender

Esta página documenta los diferentes directorios utilizados por Blender (que pueden ser de utilidad para la resolución de problemas).

Hay tres directorios diferentes que Blender podría utilizar, sus ubicaciones exactas son dependientes del Sistema Operativo.

LOCAL

Ubicación de la configuración y los datos de ejecución (para un paquete autocontenido).

USER

Ubicación de los archivos de configuración (normalmente en el directorio «home» del usuario).

SISTEMA

Ubicación de los datos de ejecución para una instalación completa en el sistema (podría ser de solo lectura).

Para instalaciones en el sistema, son necesarios los directorios SYSTEM y USER.

Para las distribuciones de Blender extraídas localmente, la configuración del usuario y los datos de ejecución se mantienen en el mismo subdirectorio, permitiendo que varias versiones de Blender se ejecuten sin que entren en conflicto, ignorando los archivos de USER y SYSTEM. Esto requiere la creación de una carpeta llamada config en el directorio LOCAL.

Rutas Dependientes de la Plataforma

Estas son las ubicaciones por defecto para cada sistema:

Linux

LOCAL
./3.4/
USER
$HOME/.config/blender/3.4/
SISTEMA
/usr/share/blender/3.4/

Nota

La ruta ./3.4/ es relativa al ejecutable de Blender y se utiliza para paquetes autocontenidos distribuidos por compilaciones oficiales de blender.org.

Nota

La ruta USER usará $XDG_CONFIG_HOME si está establecida:

$XDG_CONFIG_HOME/blender/3.4/

macOS

LOCAL
./3.4/
USER
/Users/$USER/Library/Application Support/Blender/3.4/
SISTEMA
/Library/Application Support/Blender/3.4/

Nota

macOS almacena el binario de Blender en ./Blender.app/Contents/MacOS/Blender. La ruta local a los datos y configuración es:

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

Windows

LOCAL
.\3.4\
USER
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.4\
SISTEMA
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.4\

Nota

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.

Estructura de Rutas

Esta es la estructura de las rutas, la cual es usada dentro de los directorios descritos más arriba.

Donde ./config/startup.blend podría ser, por ejemplo ~/.blender/3.4/config/startup.blend.

./autosave/ ...

Ubicación de autoguardado para el archivo blend (solo para usuarios de Windows, en otros sistemas se utiliza el directorio temporal).

Orden de búsqueda: LOCAL, USER.

./config/ ...

Valores Predefinidos e información de sesión.

Orden de búsqueda: LOCAL, USER.

./config/startup.blend

Archivo predefinido a cargar en el arranque.

./config/userpref.blend

Preferencias predefinidas para cargar en el arranque.

./config/bookmarks.txt

Marcadores del explorador de archivos.

./config/recent-files.txt

Lista del menú de archivos recientes.

./datafiles/ ...

Archivos de ejecución.

Orden de búsqueda: LOCAL, USER, SYSTEM.

./datafiles/locale/{idioma}/

Archivos de lenguajes precompilados estáticos para la traducción de la IU.

./scripts/ ...

Scripts de Python para la interfaz de usuario y herramientas.

Orden de búsqueda: LOCAL, USER, SYSTEM.

./scripts/addons/*.py

Los complementos Python, que pueden habilitarse en las Preferencias, incluyen soporte para importación/exportación de formatos, integración de motor de render y muchas utilidades prácticas.

./scripts/addons/modules/*.py

Módulos para ser utilizados por los complementos (añadidos al sys.path de Python).

./scripts/addons_contrib/*.py

Otro directorio de complementos utilizado para complementos mantenidos por la comunidad (debe ser creado manualmente).

./scripts/addons_contrib/modules/*.py

Módulos utilizados por los addons_contrib (añadidos al sys.path de Python).

./scripts/modules/*.py

Módulos de Python que contienen el núcleo de nuestra API y funciones de utilidades para que puedan importar otros scripts (añadido al sys.path de Python).

./scripts/startup/*.py

Scripts que son automáticamente importados en el arranque.

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

Valores predefinidos usados para almacenar ajustes definidos por el usuario para telas, formatos de render, etc.

./scripts/templates/*.py

Scripts de ejemplo, accesibles desde Text Editor ‣ Templates ‣ Python.

./scripts/templates_osl/*.osl

Shaders OSL de ejemplo, accesibles desde Text Editor ‣ Templates ‣ Open Shading Language.

./python/ ...

Distribución Python incorporada.

Orden de búsqueda: LOCAL, SYSTEM.

Directorio de Caché Local

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\

Directorio Temporal

El directorio temporal se usa para almacenar varios archivos en tiempo de ejecución (incluyendo capas de render, caché de físicas, búfer de copia/pega y registros de errores).

El directorio temporal se selecciona basado en la siguiente prioridad:

  • Preferencias de Usuario (véase Rutas de Archivo).

  • Variables de entorno (TEMP en Windows, TMP y TMP_DIR en otras plataformas).

  • El directorio /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.