m (MoltonMontro moved page Game Files to Game Directory without leaving a redirect) |
mNo edit summary |
||
(2 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
+ | This article describes the '''game directory''' structure of ''[[Unturned]]''. |
||
− | This page is designed for programmers interested in the framework of Unturned, or if you feel something isn't quite right, you can make the change below. If you don't usually get along with computers well, it isn't recommended that you mess with any of these things. |
||
+ | This information primarily applies to the file structure used for a Windows computer. Some things may not apply for users on other operating systems. The installation path will be different if you have a non-standard installation of your operating system, Steam, or game. |
||
⚫ | |||
+ | |||
− | Add information about the location of items |
||
+ | == Conventions == |
||
+ | |||
+ | When a path starts with a backslash character <code>\</code>, it means that the installation directory has been omitted from the path. |
||
+ | |||
+ | When an ellipsis character <code>...</code> precedes a backlash, it means that the file path up to that point has been omitted. |
||
+ | |||
⚫ | |||
+ | |||
+ | Once you have completed installation, you will have the following directory structure: |
||
+ | |||
+ | === \ === |
||
+ | |||
+ | The root, acting as a system directory and containing several things: |
||
+ | |||
+ | * The game executables, <code style="color: #22BB22">DLL</code> (dynamic-link library) files, a <code style="color: #22BB22">VDF</code> file, and an <code style="color: #22BB22">XML</code> file. |
||
+ | * <i>Unturned</i>'s licenses, its application ID for reference, and its Steam Economy information alongside a test localization for it. |
||
+ | * Various <code style="color: #22BB22">JSON</code> files for providing game information such as the current version, configuration of the Streamer Mode name list, and preferences on graphical fidelity and other settings. |
||
+ | * <code style="color: #22BB22">Screenshot.png</code>, as created when taking a high-resolution screenshot in-game via {{Keypress|Insert}}, and |
||
+ | * <code style="color: #22BB22">Spy.jpg</code>, as created when using the Spy tool as a server administrator. |
||
+ | |||
+ | The latest crash log also appears in the root, in a folder named in a <code style="color: #22BB22">YEAR-MONTH-DAY_STRING</code> format, with "STRING" being a random set of numbers. |
||
+ | |||
+ | === \.vs === |
||
+ | |||
+ | The <code style="color: #22BB22">\.vs</code> directory contains a Visual Studio file. |
||
+ | |||
+ | === \_CommonRedist === |
||
+ | |||
+ | The <code style="color: #22BB22">\_CommonRedist</code> directory contains Microsoft Visual C++ Redistributable installations required for the game. |
||
+ | |||
+ | === \BattlEye === |
||
+ | |||
+ | The <code style="color: #22BB22">\BattlEye</code> directory contains an installer for BattlEye—the anti-cheat software used by the game. The directory also contains BattlEye's EULA and privacy information. |
||
+ | |||
+ | === \Bundles === |
||
+ | |||
+ | The <code style="color: #22BB22">\Bundles</code> directory contains a majority of all the <code style="color: #22BB22">DAT</code> files used for items, vehicles, objects, and other assets. All non-economy assets' localization files can also be found in this directory. Various tools and <code style="color: #22BB22">Unity package</code> files are also available from here. |
||
+ | |||
+ | The directory is broken up into several folders: |
||
+ | |||
+ | * <code style="color: #22BB22">...\Animals</code> contains <code style="color: #22BB22">DAT</code> files for animals. |
||
+ | * <code style="color: #22BB22">...\Assets</code> contains <code style="color: #22BB22">DAT</code> files for miscellaneous assets; e.g., object material palettes, stereo songs, and map-specific zombie difficulty. |
||
+ | * <code style="color: #22BB22">...\Effects</code> contains <code style="color: #22BB22">DAT</code> files for particle effects and various noises. |
||
+ | * <code style="color: #22BB22">...\Items</code> contains <code style="color: #22BB22">DAT</code> files for items, including cosmetics and some other assets part of the Steam Economy integration. |
||
+ | * <code style="color: #22BB22">...\Level</code> contains various <code style="color: #22BB22">DAT</code> and <code style="color: #22BB22">UNITY3D</code> files used by the Editor. |
||
+ | * <code style="color: #22BB22">...\Mythics</code> contains mythic <code style="color: #22BB22">DAT</code> files, as used for the Steam Economy. |
||
+ | * <code style="color: #22BB22">...\NPCs</code> contains <code style="color: #22BB22">DAT</code> files for NPCs, vendor tables, quests, and dialogue. |
||
+ | * <code style="color: #22BB22">...\Objects</code> contains <code style="color: #22BB22">DAT</code> files for map objects. |
||
+ | * <code style="color: #22BB22">...\Skins</code> contains skin <code style="color: #22BB22">DAT</code> files, as used for the Steam Economy. Localization files for the assets is located in the root. |
||
+ | * <code style="color: #22BB22">...\Sources</code> contains <code style="color: #22BB22">Unity package</code> files as examples for modding, various shaders and animations, a <code style="color: #22BB22">BLEND</code> file of the player character model and a <code style="color: #22BB22">PNG</code> of the textures for it, tools for properly exporting and bundling custom assets, and other useful resources. |
||
+ | * <code style="color: #22BB22">...\Spawns</code> contains all of the game's spawn tables. |
||
+ | * <code style="color: #22BB22">...\Trees</code> contains <code style="color: #22BB22">DAT</code> files for natural resources (trees, bushes, and boulders). |
||
+ | * <code style="color: #22BB22">...\Vehicles</code> contains <code style="color: #22BB22">DAT</code> files for vehicles. |
||
+ | * <code style="color: #22BB22">...\Workshop</code> is an archaic directory. It was originally used for manually installing game modifications without having to mix the files with official assets. However, after Steam Workshop integration as added, a majority of mod-hosting websites have since shutdown. |
||
+ | |||
+ | Maps can have an exclusive equivalent folder too, at <code style="color: #22BB22">...\Maps\...\Bundles</code>. All curated content is found within their map's respective <code style="color: #22BB22">...\Bundles</code>. |
||
+ | |||
+ | === \Cloud === |
||
+ | |||
+ | The <code style="color: #22BB22">\Cloud</code> directory contains game data pertaining Editor settings, and the player's ignored blueprints. |
||
+ | |||
+ | === \Content === |
||
+ | |||
+ | The <code style="color: #22BB22">\Content</code> directory contains files with core game framework data. |
||
+ | |||
+ | === \Extras === |
||
+ | |||
+ | The <code style="color: #22BB22">\Extras</code> directory contains a high-resolution wallpaper, previous event-exclusive maps, high-definition exports of icons for game content and Steam Economy content, and various demo assets. A unique barricade item can be found at the <code style="color: #22BB22">\Extras\Bundles\Items\Barricades</code> file path. |
||
+ | |||
+ | === \Localization === |
||
+ | |||
+ | The <code style="color: #22BB22">\Localization</code> directory contains a bulk of the localization files. |
||
+ | |||
+ | Other localization files can be found at <code style="color: #22BB22">\Translations</code> and <code style="color: #22BB22">\EconInfo_TestLocalization.json</code>. |
||
+ | |||
+ | === \Logs === |
||
+ | |||
+ | The <code style="color: #22BB22">\Logs</code> directory contains logs regarding occurrences on hosted servers and single-player worlds. Server hosts can configure the information saved to their server logs. |
||
+ | |||
+ | Logs pertaining to the latest crash will appear in the root. |
||
+ | |||
+ | === \Maps === |
||
+ | |||
+ | The <code style="color: #22BB22">\Maps</code> directory contains all of the game's map folders, including any currently curated maps. When using the Editor, players can normally only edit maps they have created, unless a file called <code>[[Unlocking Any Map|.unlocker]]</code> is created and placed in the map's respective folder. |
||
+ | |||
+ | All curated content for a curated map is found within the map's respective <code style="color: #22BB22">...\Bundles</code> folder. |
||
+ | |||
+ | The map's <code style="color: #22BB22">Config.json</code> is used for certain settings and options available to maps, e.g., the map's category, Devkit-related terrain options, train spawns, curated map's creators, and the Aurora Borealis. |
||
+ | |||
+ | The <code style="color: #22BB22">English.dat</code> provides an English localization of the map's description and loading text. |
||
+ | |||
+ | === \Modules === |
||
+ | |||
+ | The <code style="color: #22BB22">\Modules</code> directory is normally ''entirely'' empty. Its only purpose is to serve as a repository for custom game modules. |
||
+ | |||
+ | Modules are similar to mods, but can add entirely new features, act as a total conversion, or build on other modules to improve functionality. Third-party modules cannot be loaded with BattlEye enabled. |
||
+ | |||
+ | === \Screenshots === |
||
+ | |||
+ | The <code style="color: #22BB22">\Screenshots</code> directory contains images used for loading screens. |
||
+ | |||
+ | === \Servers === |
||
+ | |||
+ | The <code style="color: #22BB22">\Servers</code> directory contains data pertaining to servers hosted on the machine. |
||
+ | |||
+ | === \Translations === |
||
+ | |||
+ | The <code style="color: #22BB22">\Translations</code> directory contains <code style="color: #22BB22">TRANSLATION</code> files, which are used for localizations. |
||
+ | |||
+ | Other localization files can be found at <code style="color: #22BB22">\Localization</code> and <code style="color: #22BB22">\EconInfo_TestLocalization.json</code>. |
||
+ | |||
+ | === \UnturnedData === |
||
+ | |||
+ | The <code style="color: #22BB22">\UnturnedData</code> directory contains all game data that will be loaded by the game at some point. All game assets and databases are stored in <code style="color: #22BB22">ASSETS</code> files—a game resource archive used by Unity. |
||
+ | |||
+ | === \Worlds === |
||
+ | |||
+ | The <code style="color: #22BB22">\Worlds</code> directory contains all single-player save data. |
||
+ | [[Category:Browse]] |
Revision as of 21:34, 30 December 2018
This article describes the game directory structure of Unturned.
This information primarily applies to the file structure used for a Windows computer. Some things may not apply for users on other operating systems. The installation path will be different if you have a non-standard installation of your operating system, Steam, or game.
Conventions
When a path starts with a backslash character \
, it means that the installation directory has been omitted from the path.
When an ellipsis character ...
precedes a backlash, it means that the file path up to that point has been omitted.
Layout
Once you have completed installation, you will have the following directory structure:
\
The root, acting as a system directory and containing several things:
- The game executables,
DLL
(dynamic-link library) files, aVDF
file, and anXML
file. - Unturned's licenses, its application ID for reference, and its Steam Economy information alongside a test localization for it.
- Various
JSON
files for providing game information such as the current version, configuration of the Streamer Mode name list, and preferences on graphical fidelity and other settings. Screenshot.png
, as created when taking a high-resolution screenshot in-game via Insert, andSpy.jpg
, as created when using the Spy tool as a server administrator.
The latest crash log also appears in the root, in a folder named in a YEAR-MONTH-DAY_STRING
format, with "STRING" being a random set of numbers.
\.vs
The \.vs
directory contains a Visual Studio file.
\_CommonRedist
The \_CommonRedist
directory contains Microsoft Visual C++ Redistributable installations required for the game.
\BattlEye
The \BattlEye
directory contains an installer for BattlEye—the anti-cheat software used by the game. The directory also contains BattlEye's EULA and privacy information.
\Bundles
The \Bundles
directory contains a majority of all the DAT
files used for items, vehicles, objects, and other assets. All non-economy assets' localization files can also be found in this directory. Various tools and Unity package
files are also available from here.
The directory is broken up into several folders:
...\Animals
containsDAT
files for animals....\Assets
containsDAT
files for miscellaneous assets; e.g., object material palettes, stereo songs, and map-specific zombie difficulty....\Effects
containsDAT
files for particle effects and various noises....\Items
containsDAT
files for items, including cosmetics and some other assets part of the Steam Economy integration....\Level
contains variousDAT
andUNITY3D
files used by the Editor....\Mythics
contains mythicDAT
files, as used for the Steam Economy....\NPCs
containsDAT
files for NPCs, vendor tables, quests, and dialogue....\Objects
containsDAT
files for map objects....\Skins
contains skinDAT
files, as used for the Steam Economy. Localization files for the assets is located in the root....\Sources
containsUnity package
files as examples for modding, various shaders and animations, aBLEND
file of the player character model and aPNG
of the textures for it, tools for properly exporting and bundling custom assets, and other useful resources....\Spawns
contains all of the game's spawn tables....\Trees
containsDAT
files for natural resources (trees, bushes, and boulders)....\Vehicles
containsDAT
files for vehicles....\Workshop
is an archaic directory. It was originally used for manually installing game modifications without having to mix the files with official assets. However, after Steam Workshop integration as added, a majority of mod-hosting websites have since shutdown.
Maps can have an exclusive equivalent folder too, at ...\Maps\...\Bundles
. All curated content is found within their map's respective ...\Bundles
.
\Cloud
The \Cloud
directory contains game data pertaining Editor settings, and the player's ignored blueprints.
\Content
The \Content
directory contains files with core game framework data.
\Extras
The \Extras
directory contains a high-resolution wallpaper, previous event-exclusive maps, high-definition exports of icons for game content and Steam Economy content, and various demo assets. A unique barricade item can be found at the \Extras\Bundles\Items\Barricades
file path.
\Localization
The \Localization
directory contains a bulk of the localization files.
Other localization files can be found at \Translations
and \EconInfo_TestLocalization.json
.
\Logs
The \Logs
directory contains logs regarding occurrences on hosted servers and single-player worlds. Server hosts can configure the information saved to their server logs.
Logs pertaining to the latest crash will appear in the root.
\Maps
The \Maps
directory contains all of the game's map folders, including any currently curated maps. When using the Editor, players can normally only edit maps they have created, unless a file called .unlocker
is created and placed in the map's respective folder.
All curated content for a curated map is found within the map's respective ...\Bundles
folder.
The map's Config.json
is used for certain settings and options available to maps, e.g., the map's category, Devkit-related terrain options, train spawns, curated map's creators, and the Aurora Borealis.
The English.dat
provides an English localization of the map's description and loading text.
\Modules
The \Modules
directory is normally entirely empty. Its only purpose is to serve as a repository for custom game modules.
Modules are similar to mods, but can add entirely new features, act as a total conversion, or build on other modules to improve functionality. Third-party modules cannot be loaded with BattlEye enabled.
\Screenshots
The \Screenshots
directory contains images used for loading screens.
\Servers
The \Servers
directory contains data pertaining to servers hosted on the machine.
\Translations
The \Translations
directory contains TRANSLATION
files, which are used for localizations.
Other localization files can be found at \Localization
and \EconInfo_TestLocalization.json
.
\UnturnedData
The \UnturnedData
directory contains all game data that will be loaded by the game at some point. All game assets and databases are stored in ASSETS
files—a game resource archive used by Unity.
\Worlds
The \Worlds
directory contains all single-player save data.