User Tools

Site Tools


item_container_tutorial

Adding an Item Container to a Map


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 this object to behave as a container. 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 paths to the tile that the chest is located on because the object is configured as being not passable. 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.

To do so, switch the Map Editor into “Connect” mode.

Select “Interact Only” (colored orange by default) from the Navigation Palette in the top left corner, then click and drag from each adjacent tile to either the treasure chest or the tile it's located on. This will allow the player to open the item container from these tiles

Save the map, export the game, then try out the item container you've created!

item_container_tutorial.txt · Last modified: 2017/12/06 13:51 by justin