Authors: Vawser

Disclaimer: this information is accurate for Smithbox 1.0.25.

The Map Editor is the key editor for the modding of maps. It provides an interface for you, the mod maker, to edit the data contained within MSB files (the map level data) and a viewport in which the map is rendered.

However, there are some limitations:

• It cannot add a entirely new map for you.
• Loading multiple maps is liable to crash Smithbox (if you are rendering them). You can circumvent this by using the Low Requirements build of Smithbox, which will not render maps in the viewport.

The map list is a list of all the map (MSB) files available to you.

It is drawn from the Game Directory you define when you create a Smithbox project. Note, if the list is empty, this either means the Game Directory you have given is incorrect, or that you have not unpacked the map files with UXM.

You can filter the map list by typing in the search bar above the list. This uses a fuzzy search, and checks both the Map ID and the map name alias.

To load a map, you can either right-click the entry and click Load Map button, or double-click the entry.

For Elden Ring projects, you can automatically load all related maps connected to an entry by clicking the Load Related Maps button.

Once you have loaded a map, it will appear at the top of list in a separate pinned section. You can then switch between loaded maps by clicking on the entry, which updates the Map Content window.

Once a map has been loaded, the Map Contents window will populate with the data representation of the map. This is a tree list, split by the map object's type. Each map object is represented by a discrete entry in this tree list.

There are four core map object types:

• Event: these map objects represent connection data, i.e. X asset should be considered a treasure chest.
• Light: these map objects represent non-ambient light data, e.g. specific point, spot or directional lights.
• Part: these map objects represent the 'parts' of a map, e.g. the enemies, the collision, the geometry itself, etc.
• Region: these map objects represent areas or points either for detection, spawning or other similar usage.

Event, Part and Region in general have sub-types that are different between each game, they will not be covered here in detail.

Before you can do anything to a map object, you must select it. You can do this in two ways:

• Select its entry in the tree list.
• Select the entity itself in the viewport.

You can select multiple map objects by holding Left Control when selecting the entry or entity.

You can select multiple map objects in a range via the Map Contents tree list by selecting the first map object, holding Left Shift and then selecting the second map object. All entries between them will be selected as well.

To edit a map object, you need to select it first.

Once selected, the Properties window will populate with the property data related to the selected map object.

If you have multiple map objects selected that share the same internal type, you can edit them simultaneously within the Properties window. The property inputs will appear green when you are in this mode. Note that the property data shown is only reflecting the properties of the first map object in your selection.

To edit a property, simply change the value in the input box next to the name of the property.

To add a new map object, you can either duplicate an existing map object selection or use the Create tool.

It is recommended you duplicate an existing map object as generally you want to keep most properties the same, and the Create tool will populate all the properties with default values with is rarely ideal.

To duplicate, you need to select a map object and press Left Control + D.

To delete a map object, you can select a map object and then press Delete. This will remove the map object.

If you need to filter the property list, you can use the search bar in the Properties window to do so.