Level Files

Overview

There are a number of files that are generated when you create a new level in Sandbox. This article will give you an overview of the common files.

For these examples, we'll be referring to the files for Woodland, one of the sample maps that are shipped with the SDK.

File

Description

LevelData\Environment.xml

Environment variables defined in the Environment Panel in the RollupBar are stored here.

LevelData\GameTokens.xml

GameToken libraries created inside this level are stored here.

LevelData\Heightmap.dat

Terrain Heightmap data used by the Engine.

LevelData\Objectives.xml

Mission objective information.

LevelData\TerrainTexture.xml

Terrain texture tile data is stored here.

LevelData\TimeOfDay.xml

Variables defined through the Time of Day tool are stored in this file.

LevelData\VegetationMap.dat

Vegetation data used by the Engine.

auto_resourcelist.txt

DEPRECATED - See here for more information: Auto Resource List Files.

auto_resources_sequence.txt

DEPRECATED - See here for more information: Creating LevelCache Files.

filelist.xml

Stores information (MD5 and size) about critical files. Done during "Export to Engine" process.

level.cfg

Each level can have its own individual configuration file that is only loaded when loading that level. If you wish to run certain CVars for a single level use this file. NB: This is not used/shipped in Woodland but still can be used in any level.

level.pak

The level.pak file houses lots of information about your level that is used by the Launcher. This file is (re)generated when you "Export to Engine" in Sandbox.

tags.txt

When you create camera locations in Sandbox (CTRL + F1-F12) these locations are stored inside this file and can be called (SHIFT + F1-F12) to relocate the camera. This file is updated along with any changes when you save the level.

tags.json

An additional copy of the tags.txt file but in .json format.

terraintexture.pak

Tiled terrain texture data that is stored when you Generate Surface Textures inside Sandbox.

timedemo.tmd

See here for more information: Recording Time Demos.

Woodland.cry

This is a container file which is used by Sandbox. Changes to this file do not effect pure-game.
It can be opened with an archive program (such as WinRAR or 7zip) and contains several files which contain information/data for the level.

Woodland.xml

This script file contains information for use in the Launcher. It defines the loading screen, mini-map display information, loading description text and game rules for the level.

woodland.dds

Minimap file that is generated from Sandbox to give a birds-eye view of the level. The file can be called whatever you like but it needs to be defined in the Woodland.xml file.

<texturename>.dds

This file is the loading screen for use in the Launcher. The file can be called whatever you like but it needs to be defined in the Woodland.xml file and the UI configured to use it. This is not currently used in the GameSDK package.

Layers

When you create Layers inside Sandbox, a "Layers" sub-folder is created in your level folder. Each layer gets its own .lyr file which allows for collaborative editing. If a layer inside Sandbox has sub-layers within it, another sub-folder is created.

Backup Files

Backup files are automatically generated by Sandbox each time you save your level. When you save over your .cry file, your existing .cry file is renamed to .bak and if in the event a .bak file already exists, .bak2 is created as a secondary backup.

These .bak files are exactly the same as the .cry file, only with renamed extensions. If you wish to use or restore from a backup file, there's two ways in which you can do this (using Forest as an example):

  1. Rename the Woodland.bak file to Woodland.cry. When prompted about changing the extension, select 'Yes'.
  2. Open the Woodland.bak file in Sandbox (you'll need to view "All Files") then "Save As" the Woodland.cry file.