Rozloženie priečinkov Blenderu

This page documents the different directories used by Blender (which can be helpful for troubleshooting).

There are three different directories Blender may use, their exact locations are platform dependent.

LOCAL:

Location of configuration and run-time data (for self-contained bundle).

USER:

Location of configuration files (typically in the user’s home directory).

SYSTEM:

Location of run-time data for system wide installation (may be read-only).

For system installations both SYSTEM and USER directories are needed.

For locally extracted Blender distributions, the user configuration and run-time data are kept in the same subdirectory, allowing multiple Blender versions to run without conflict, ignoring the USER and SYSTEM files. This requires you to create a folder named config in the LOCAL directory.

Platform Dependent Paths

Here are the default locations for each system:

Linux

LOCAL:
./3.6/
USER:
$HOME/.config/blender/3.6/
SYSTEM:
/usr/share/blender/3.6/

Poznámka

The path ./3.6/ is relative to the Blender executable and is used for self-contained bundles distributed by official blender.org builds.

Poznámka

The USER path will use $XDG_CONFIG_HOME if it is set:

$XDG_CONFIG_HOME/blender/3.6/

macOS

LOCAL:
./3.6/
USER:
/Users/$USER/Library/Application Support/Blender/3.6/
SYSTEM:
/Library/Application Support/Blender/3.6/

Poznámka

macOS stores the Blender binary in ./Blender.app/Contents/MacOS/Blender. The local path to data and config is:

./Blender.app/Contents/Resources/3.6/

Windows

LOCAL:
.\3.6\
USER:
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.6\
SYSTEM:
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.6\

Poznámka

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 installation.

Rozloženie cesty

This is the path layout which is used within the directories described above.

Where ./config/startup.blend could be ~/.blender/|BLENDER_VERSION|/config/startup.blend for example.

./autosave/ ...

Umiestnenie s automatickým uložením blend súboru. (Len pre Windows, pre ostatné systémy sa používa dočasný priečinok.)

Search order: LOCAL, USER.

./config/ ...

Defaults & session info.

Search order: LOCAL, USER.

./config/startup.blend

Default file to load on startup.

./config/userpref.blend

Default preferences to load on startup.

./config/bookmarks.txt

Záložky v prehliadači súborov.

./config/recent-files.txt

Zoznam ponuky posledných súborov.

./datafiles/ ...

Runtime files.

Search order: LOCAL, USER, SYSTEM.

./datafiles/locale/{language}/

Static precompiled language files for UI translation.

./scripts/ ...

Python scripts for the user interface and tools.

Search order: LOCAL, USER, SYSTEM.

./scripts/addons/*.py

Medzi doplnky Pythonu, ktoré môžete povoliť v predvoľbách, patrí podpora formátov importu/exportu, integrácia mechanizmu prekreslenia a mnoho užitočných nástrojov.

./scripts/addons/modules/*.py

Moduly na použitie doplnkov (pridané do sys.path Pythonu).

./scripts/addons_contrib/*.py

Another add-ons directory which is used for community maintained add-ons (must be manually created).

./scripts/addons_contrib/modules/*.py

Modules for addons_contrib to use (added to Python’s sys.path).

./scripts/modules/*.py

Moduly Pythonu obsahujúce naše základné API a užitočné funkcie, ktoré môžu importovať iné skripty (pridané do sys.path Pythonu).

./scripts/startup/*.py

Skripty, ktoré sa automaticky importujú pri spustení.

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

Predvoľby slúžia na ukladanie užívateľom definovaných nastavení pre látku, formáty prekreslenia atď.

./scripts/templates_py/*.py

Príklady skriptov, ktoré sú prístupné z Textový editor ‣ Šablóny ‣ Python.

./scripts/templates_osl/*.osl

Príklad OSL tieňovačov, ktoré sú prístupné z Textový editor ‣ Šablóny ‣ Jazyk otvoreného tieňovania (OSL).

./python/ ...

Pribalená distribúcia Pythonu.

Search order: LOCAL, SYSTEM.

Lokálny priečinok zásobníka

Priečinok zásobníka sa používa na lokálne ukladanie trvalých zásobníkov. V súčasnosti sa používa len na indexovanie knižnice aktív. Neočakáva sa, že by ho operačný systém automaticky vymazal.

Použije sa nasledujúca cesta:

  • Linux:

    $XDG_CACHE_HOME/blender/, ak je nastavené $XDG_CACHE_HOME, inak $HOME/.cache/blender/

  • macOS:

    /Library/Caches/Blender/

  • Windows:

    %USERPROFILE%\AppData\Local\Blender Foundation\Blender\Cache\

Dočasný priečinok

Dočasný priečinok sa používa na ukladanie rôznych bežiacich súborov (vrátane vrstiev prekreslenia, zásobníka fyziky, zásobníka kopírovania a záznamov o haváriách).

Dočasný priečinok sa vyberá na základe nasledujúcej priority:

  • Predvoľby užívateľa (pozri Cesty súborov).

  • Premenné prostredia (TEMP na Windows, TMP & TMP_DIR na ostatných platformách).

  • Priečinok /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 Premenné prostredia for details.