Blender’s Directory Layout

Esta página documenta os diferentes diretórios utilizados pelo Blender (que podem ser úteis para a solução de problemas).

Existem três diretórios diferentes que o Blender poderá utilizar, as suas localizações exatas são dependentes do sistema operacional (ou operativo, em Portugal) utilizado.

LOCAIS (LOCAL)

A localização da configuração e dos dados em tempo de execução (para os arquivos embutidos como blocos)

USUÁRIO (USER)

Localização dos arquivos de configuração (normalmente, dentro de diretórios no ambiente de cada usuário)

SISTEMA (SYSTEM)

A localização dos dados em tempo de execução para a instalação ampla do sistema (pode ser marcado como somente leitura)

Para as instalações, tanto os diretórios SYSTEM e USER são necessários.

Para as distribuições Blender extraídas localmente, as configurações do usuário e dados em tempo de execução são mantidos dentro do mesmo subdiretório, permitindo que múltiplas versões do Blender sejam executadas sem conflitos, ignorando os arquivos das pastas definidas pelas variáveis USER e SYSTEM. Isto requer que você crie uma pasta chamada config` no diretório LOCAL*.

Caminhos dependentes de plataformas

Aqui estão as localizações padrão para cada sistema:

Linux

LOCAIS (LOCAL)
./3.2/
USUÁRIO (USER)
$HOME/.config/blender/3.2/
SISTEMA (SYSTEM)
/usr/share/blender/3.2/

Nota

O caminho ./|BLENDER_VERSION|/ é relativo ao executável do Blender e também é utilizado para os arquivos contidos em si que são embutidos e distribuídos pelo site oficial blender.org.

Nota

O caminho USER irá utilizar o valor da variável $XDG_CONFIG_HOME caso esteja definida:

$XDG_CONFIG_HOME/blender/3.2/

macOS

LOCAIS (LOCAL)
./3.2/
USUÁRIO (USER)
/Users/$USER/Library/Application Support/Blender/3.2/
SISTEMA (SYSTEM)
/Library/Application Support/Blender/3.2/

Nota

O macOS guarda o binário do Blender em ./blender.app/Contents/MacOS/blender. O caminho local para os dados e configuração é:

./Blender.app/Contents/Resources/3.2/

Windows

LOCAIS (LOCAL)
.\3.2\
USUÁRIO (USER)
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.2\
SISTEMA (SYSTEM)
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.2\

Esquema de caminhos

Este é o esquema de caminhos que é utilizado em conjunto com os diretórios descritos acima.

Onde ./config/startup.blend poderá ser ~/.blender/|BLENDER_VERSION|/config/startup.blend por exemplo.

./autosave/ ...

Localização do arquivo salvo automaticamente. (Somente para Windows, o diretório temporário é usado como padrão em outros sistemas).

Ordem de pesquisa: LOCAL, USER.

./config/ ...

Padrões e informações da sessão.

Ordem de pesquisa: LOCAL, USER.

./config/startup.blend

Arquivos padrão a ser carregados durante a inicialização.

./config/userpref.blend

As preferências padrão a ser carregadas durante a inicialização.

./config/bookmarks.txt

Favoritos do navegador de arquivos.

./config/recent-files.txt

Menu com a lista de arquivos recentes.

./datafiles/ ...

Arquivos de tempo de execução.

Ordem de pesquisa: LOCAL, USER, SYSTEM.

./datafiles/locale/{language}/

Arquivos estáticos pré-compilados de linguagem para a tradução da interface de usuário.

./scripts/ ...

Scripts Python para a interface de usuário e ferramentas.

Ordem de pesquisa: LOCAL, USER, SYSTEM.

./scripts/addons/*.py

Add-ons Python que podem ser habilitados em Preferences, incluindo os formatos suportados para importação/exportação, integração com motores de renderização e muitas utilidades práticas.

./scripts/addons/modules/*.py

Módulos para add-ons a serem usados (adicionados ao diretório «sys.path» Python).

./scripts/addons_contrib/*.py

Outros diretórios de complemento os quais são usados para os complementos mantidos pela comunidade (devem ser criados manualmente)

./scripts/addons_contrib/modules/*.py

Módulos para addons_contrib` a utilizar (adicionado ao sys.path do Python).

./scripts/modules/*.py

Módulos Python contendo nossa API principal e funções úteis para outros scripts para serem importados (adicionados ao diretório «sys.path» Python).

./scripts/startup/*.py

Scripts que são automaticamente importados durante a inicialização.

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

Presets usadas para o armazenamento de outras configurações definidas pelos usuários para tecidos, formatos de renderização, etc.

./scripts/templates_py/*.py

Scripts de exemplo que podem ser acessados a partir do Editor de texto ‣ Modelos ‣ Python.

./scripts/templates_osl/*.osl

Sombreadores OSL, os quais podem ser acessados a partir do Editor de texto ‣ Modelos ‣ Linguagem de sombreamento aberto.

./python/ ...

Distribuição do Python embutida.

Ordem de pesquisa: LOCAL, SYSTEM.

Diretório temporário

O diretório temporário é usado para armazenar vários arquivos em tempo de execução (incluindo render layers, cache físicos, copy-paste buffer e logs de erros).

O diretório temporário é selecionado com base na seguinte prioridade:

  • Preferências de usuário (see File Paths).

  • Variáveis de ambiente (TEMP no Windows, TMP e TMP_DIR em outras plataformas).

  • O diretório definido como /tmp/.