Map Layers

Map Layers

Everything in a map has to be on a layer.

While some layers are self-explanatory (such as tile layers), object layers need some extra information -- namely, their layer type!

When making an "Object Layer" in Tiled, take a look at the properties panel! You should see an empty field, called Class. This is where you input your layer type!

Layer classes are case-sensitive, and must be spelled exactly as they are listed below.

List of Object Layer Types

objects

• Objects layers are used for placing events into a map.
  • (See Using events for more information about events)
• These can place engine events, any objects registered using Game:registerEvent(), and any legacy events in scripts/world/events.
  • Either the Class or Name property of the object must reference the ID of the registered event you want to spawn.

objects_party

• If an objects layer exists with this name, the party will always spawn on it.
  • If this layer does not exist, the first objects layer that exists above the markers layer spawns the party instead.

controllers

• Controller layers are used for placing controllers into a map.
  • These are special event-like objects that have no physical presence in the map. They are designed for controlling other events, hence their name.
  • (See Using events for more information about controllers)
• User-registered controllers should be stored in the scripts/world/events/controllers folder of the project.

collision

• The shapes on this layer will be used as the collision for each map.

enemycollision

• The shapes on this layer will be used as collision that only affects enemies (ChaserEnemy).
• Enemies will still be affected by the collision of the standard collision layer, regardless of this layer's presence
  • (See the tutorial dedicated to the Chaser Enemy for more information about this layer)

markers

• The shapes on this layer create markers that reference specific points or regions of a map. Each marker must be given a name so it can be referenced later.
• Markers for the current map are stored in Game.world.map.markers, and can be gathered with Game.world.map:getMarker(name).
  • Sometimes, events will need markers for certain properties.
  • Additionally, the world uses the spawn marker, if it exists, to determine where to place the party when the map is loaded from a savefile or without an entry position.

paths

• The perimeter of each shape on this layer is treated as a path. Each path must be given a name so it can be referenced later.
  • (Go to the Path system tutorial to know more).

battleareas

• When the player enters any object on this layer, it will cause them to enter a "World Battle". This causes the battleborder layer to become visible, and the world to darken.
  • (See Battle Areas for more information on battle areas.)

blockcollision

• The shapes on this layer will be used as collision for the pushblock event.
  • (Go to the push block tutorial to know more).

List of Tile Layer Types

battleborder

• Only visible when the player is inside a battle area.
  • (See Battle Areas for more information on battle areas.)