Door

Table of Contents

• Overview
• Methods inherited from map entity
• Methods of the type door
  • door:is_open()
  • door:is_opening()
  • door:is_closed()
  • door:is_closing()
  • door:open()
  • door:close()
  • door:set_open([open])
• Events inherited from map entity
• Events of the type door
  • door:on_opened()
  • door:on_closed()

A door is an obstacle that can be opened by Lua, and optionally by the hero under some conditions.

This type of map entity can be declared in the map data file. It can also be created dynamically with map:create_door().

Overview

A door may have four states: open, closed, opening or closing. States opening and closing are transitional states used to play a door opening or closing animation on the door's sprite. The sprite of a door must define animations "open" and "closed". Animations "opening" and "closing" are optional: if they don't exist, the door won't use states opening and closing. If they exist, be aware that after you call a function like map:open_doors(), your door will first be in state opening (for the duration of its sprite "opening" animation), and only after that, will get in state open. In other words, door:is_open() does not return true as soon as you open the door, unless the sprite has no animation "opening".

Doors often work by pairs. Indeed, when you have two adjacent rooms on the same map, you normally use two door entities. They can be linked by setting a common prefix to their name. Then, you can use map:open_doors() and map:close_doors() to handle both of them at the same time more easily. Additionaly, dynamic tiles whose names also have this prefix and end by _open or _closed are automatically enabled or disabled, respectively. This helps a lot to make tiles follow harmoniously the state of doors. See door:open(), and map:open_doors(prefix) for more information about these mechanisms.

A door may be opened by one of the following methods:

• "none": Cannot be opened by the player. You can only open it explicitly by calling map:open_doors().
• "interaction": Can be opened by pressing the action command in front of it.
• "interaction_if_savegame_variable": Can be opened by pressing the action command in front of it, provided that a specific savegame variable is set.
• "interaction_if_item": Can be opened by pressing the action command in front of it, provided that the player has a specific equipment item.
• "explosion": Can be opened by an explosion.

For doors whose opening method is "interaction_if_savegame_variable" or "interaction_if_item", you can specify which savegame variable or equipment item is required. You can also choose whether opening the door should consume the savegame variable of equipment item that was required.

Methods inherited from map entity

Doors are particular map entities. Therefore, they inherit all methods from the type map entity.

See Methods of all entity types to know these methods.

Methods of the type door

The following methods are specific to doors.

door:is_open()

Returns whether this door is open.

• Return value (boolean): true if this door is open, false if it is opening, closed or closing.

door:is_opening()

Returns whether this door is being opened.

• Return value (boolean): true if this door is being opened, false if it is open, closed or closing.

door:is_closed()

Returns whether this door is closed.

• Return value (boolean): true if this door is closed, false if it is closing, open or opening.

door:is_closing()

Returns whether this door is being closed.

• Return value (boolean): true if this door is being closed, false if it is closed, open or opening.

door:open()

Opens this door, enables dynamic tiles whose name starts with the door's name followed by _open and plays the "door_open" sound.

Remarks

The door will be really closed once the opening animation of its sprite is finished. However, it immediately becomes an obstacle.

door:close()

Closes this door, disables dynamic tiles whose name starts with the door's name followed by _closed and plays the "door_closed" sound.

door:set_open([open])

Makes the door open or closed like door:open() or door:close(), but does not play any sound or any sprite animation.

This function is intended to be called when you don't want the player to notice the change, typically when your map starts (i.e. from the map:on_started() event).

• open (boolean, optional): true to open the door, false to close it. No value means true.

Events inherited from map entity

Events are callback methods automatically called by the engine if you define them.

Doors are particular map entities. Therefore, they inherit all events from the type map entity.

See Events of all entity types to know these events.

Events of the type door

The following events are specific to doors.

door:on_opened()

Called when this door starts being opened.

door:on_closed()

Called when this door starts being closed.