Level editor

From SDG Wiki
Revision as of 23:22, September 21, 2021 by MoltonMontro (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Level editors are used to create custom maps in Unturned (version 3). There are two level editors available: the legacy editor, and the devkit. The level editors can be accessed from the game's main menu screens.

From the main menu, players can create a the files necessary for their new custom map, and set some of the map's settings. Players may name their map, set the map's size, and specify the map's gamemode. Afterwards, they can select their newly-created map and begin editing by choosing to use either the legacy editor or the devkit. When a new map is created, its editability is locked to the map's creator.

Legacy editor[edit]

The legacy editor has been available to players starting from the game's initial pre-release build. It is the technically confined, but more user-friendly, level editor option. Editing tools can be selected from the top of the editor, with fifteen tools being split across four top-level categories.

There used to be support for editing while using virtual reality devices, but this support has since been removed from the game.

Terrain[edit]

Hilly terrain being lowered to water level.

The landscape of a map can be edited through the terrain toolset. The toolset allows for manipulating the level's geometry, terrain type, and resource spawns.

With the heights tool, players can manipulate the level's heightmaps. Unturned levels use two distinct heightmaps, with the main difference being in collision. The primary heightmap has collision and is meant to be used for all the terrain without the playable bounds of the map. Meanwhile, the secondary heightmap does not feature collision, and is meant to be used outside the playable map bounds. Additionally, details and resources will not automatically generate on the secondary heightmap when bake function. Both heightmaps support the terrain being raised, lowered, smoothed, and flattened; and both will be automatically textured when using the bake tool for materials.

Alphamaps are managed with the materials tool. With the legacy editor, a total of eight unique materials can be loaded for use on that map. To use more than eight materials, alphamaps must be managed from the devkit editor instead. Each alphamap material can be individually configured. These configurations affect how materials are automatically generated when using the bake function, and such as restricting the generation to a certain height or steepness. They also affect the details and resources that can automatically generate on the material when using those respective bake functions.

Details are purely aesthetic, and are distributed across the map through the use of detailmaps. The legacy editor only supports ten different detail types, so the devkit must be used in order to add additional assets. The details made available by default are four flower assets, two grass assets, a wheat asset, and three pebble assets. The baking density and spawn chance can be configured per detail.

The resources tool allows for managing the level's resourcemaps. Resources can typically be mined, chopped, or otherwise harvested for items and experience. Any number of resources can be loaded into the legacy editor, and each resource can be individually configured to automatically generate under specific conditions when using the bake function. Resources can be baked locally, globally, or within the skybox. Local baking occurs near the player's current camera position, making it useful for only replacing a small area with the desired resources. Global bake will generate resources across all primary terrain, while the skybox bake will generate across all secondary terrain.

Environment[edit]

Navmesh flag marker.

The environment tools are used to manage level ambience, pathfinding, and roads. Its toolset includes the lighting tool, roads tool, navigation tool, and nodes tool.

The lighting tool, also called the day/night tool, allows for customizing the map's skybox. Water, sky, clouds, fog, lighting, and particle colors and intensities and can be adjusted through the lighting tool. Additionally, weather can be toggled, tweaked, and previewed from this tool as well.

The roads tool, or paver, is used to create roads. This is done by plotting multiple points across the map. Upon baking the road, it is generated using spline-based procedural geometry and will follow the points in the road network. There are multiple road textures that can be used when creating roads.

A navigation mesh (navmesh), is an abstract data structure used by artificial intelligence to aid in pathfinding. The navigation tool allows for creating these navmeshes. Navmeshes are used by zombies, which are otherwise unable to move when spawned outside a navmesh.

When a navmesh is placed on a map, it is marked in the legacy editor with a white flag. The flag turns red when selected. This flag marks the center of the navmesh, and by selecting the flag the properties of the navmesh can be tweaked.

The nodes tool is used to create a variety of different ambience nodes. There are seven types of nodes: arena, deadzone, airdrop, effect, location, safezone, and purchase.

Spawns[edit]

Game spawns for items, animals, vehicles, and zombies are managed by the spawn tools. These tools allow for placing spawn points, configuring spawn properties, and adjusting spawn tables. However, it is not recommended to use the legacy editor to implement spawn tables for items, animals, or vehicles. Instead, spawn tables should be constructed within DAT files using the Spawn asset type, and then referenced in the editor through the Spawn ID field.

Level[edit]

Objects list and filters.

The fourth toolset is the level toolset, also called the world tools. Level tools allow for placing objects and NPCs, toggling visibility for various in-editor elements, and managing player spawn points.

Objects are models that can be placed onto maps. They serve as props for players to loot, explore, and travel upon or through. They may be purely decorative with merely aesthetic value, or they can be interactable. NPCs are considered to be a type of interactable object, along with many quest objects. Objects pertaining to NPCs are often affected by external conditions that may influence when or how they appear, and as such are only seen client-side when it is appropriate for that individual player to see them. This makes such objects non-ideal for use outside of their intended functions. Traditionally player-made structures and barricades can be placed through the legacy editor as well, but these can be salvaged by any player who comes across them, permanently removing them from that location until the world's savedata is reset. There are multiple filters available to players when searching through the object list. When the desired object is selected, it can be spawned with E by default. Objects have three transformation options: translate, scale, and rotation. When holding Ctrl, objects can be snapped to a grid-like placement system, based on the specified snap distance.

The visibility tab provides a simple list of toggles regarding the visible display of various in-editor elements. These settings have no effect on the level itself, and are only relevant while in the editor. While the visibility tab remains open, a numbered grid is rendered over the level, with each number representing coordinates. The function keys can be used to quickly toggle each individual setting on or off, without needing to navigate to the visibility tab.

Player spawn points can be toggled between arena placements and normal spawn points. This is only relevant for the arena game mode, where players initially spawn in a lobby area during intermission periods and when they first join, but are teleported into the arena during gameplay.

Devkit[edit]

The devkit editor is the more technically advanced editor option. It is generally regarded as being more difficult to use, and it can be optimal to still use the legacy editor to perform stuff tasks in place of the devkit. However, many of the more advanced tools, features, and optimizations are entirely restricted to the devkit. The devkit also includes tools for uploading and updating Steam Workshop content.

Smartly Dressed Games has shown interest in merging the devkit with the legacy editor.

UNLOCKER[edit]

Maps can be edited by someone other than the map's initial creator, provided that the map has been unlocked with an unnamed UNLOCKER file. The UNLOCKER file must be placed inside each individual map's folder, for those maps to be unlocked. If your file manager is configured to show file extensions at the end of file names, and allows for empty file names, then creation of an UNLOCKER is straightforward. Create a new file, and simply rename it to .unlocker.

Alternatively, an unnamed UNLOCKER file can be created through a command-line interpreter.