This tutorial demonstrates how to add an item container to a map. For this walk-through, we will add a treasure chest to our main map that will contain some items for the player to retrieve.

Note: This tutorial assumes that you already understand the basics of navigating around the Map Editor.

To begin, open the map that you want to add an item container to in the Map Editor and switch to “Place” mode.

Select the object that you want to be an item container from the resource selection panel on the right and place it into the map in the desired location. For this example, I will be placing a treasure chest.

Next, switch the Map Editor into “Edit” mode so the necessary modifications can be made to the object.

Right-click on your object and select “Properties” from the context menu.

In the Properties dialog, check the Item Container checkbox to indicate that you want to allow this object to contain items. Double-click any items that you wish to initially be included in the item container - this will add them to the box on the right labelled “Items in Container”. Click the OK button once you are finished. It is not required to add any items initially, as you may just want the object to act as an item container but initially be empty at the start of the game.

Note: You can also add a script to the object to have an event occur when the player opens the item container and an “On Close” script for when the player closes the container window or steps away from it. For example, you could play an opening animation for the object's main script:

play_animation(self, "open")

And a closing animation for the “On Close” script

play_animation(self, "close")

If markers are enabled in the Map Editor, an item container marker () will appear over the object to indicate that the object is now an item container once you've closed the Properties dialog. You'll also see a script marker if you assigned a script to the object.

There is one more step to ensure that the player can interact with the item container. When I placed the treasure chest, the Map Editor removed any navigation/interaction paths to the tile that the chest sits on because the object is not designated as “walkable”. First, decide which adjacent tiles the player should be able to interact with the item container from. In this case, there are two adjacent tiles from which the player should be able to access the chest. For each one, select the tile that the item container is on and the adjacent tile, then right-click to bring up the context menu. Go to the Navigation/Interaction sub-menu and select Interact Only. This will allow the player to open the item container from the adjacent tile.

s shown below, I have set the tile in front of the chest and to the left of the chest as Interact Only (displayed as orange lines by default).

Save the map and then try out the item container in your exported game!