Actions

Some [Objects] (laser receivers, buttons, ...) can take a comma-seperated list of actions to execute on certain events.

Actions follow the format name[:param1[:param2[:...]]].

##World Changes

• set-tile
  • description: change a tile in the map
  • parameters:
    • x: x tile coordinate (int)
    • y: y tile coordinate (int)
    • layer: layer name (string)
    • id: tile to set to (int) (0 is nothing, otherwise take column*width_of_atlas_in_tiles + row + 1)
• door-open
  • description: open a door
  • parameters:
    • x: x tile coordinate of the door
    • y: y tile coordinate of the bottom tile
    • top: top layer name
    • bottom: bottom layer name
    • walk: walkability layer name#
• door-close
  • description: close a door
  • parameters:
    • x: x tile coordinate of the door
    • y: y tile coordinate of the bottom tile
    • top: top layer name
    • bottom: bottom layer name
    • walk: walkability layer name
• set-prop
  • description: set a property on an object
  • parameters:
    • world: world of the object
    • name: object name
    • property: property name
    • value: new value to set to (string)

##Notifications/Narration/Sound

• notify
  • description: add a permanent notification
  • parameters:
    • type: INFO, WARNING, or OBJECTIVE (string)
    • message: that (string) (may not include commas or colons, everything else is allowed i suppose, but please avoid chinese)
• notify-timed
  • description: add a notification that expires after a time
  • parameters
    • time: time to expiration, in milliseconds
    • type: INFO, WARNING, or OBJECTIVE (string)
    • message: that (string) (may not include commas or colons, everything else is allowed i suppose, but please avoid chinese)
• narration-queue
  • description: add a narration to the queue
  • parameters:
    • narration: the narrations to add. format is "text|sound". You can repeat this as many times as you like. You may also leave sound out to just display the text.
• narration-clear
  • description: clear the narration queue
• (NOT IMPLEMENTED) music-set
  • description: Set the current music track
  • parameters:
    • file: filename of the music inside resources/music
• (NOT IMPLEMENTED) sound-play
  • description: play a sound effect
  • parameters:
    • sound: filename of the sound to play inside resources/sound

##Keycards

• keycard-drop
  • description: drop a keycard
  • parameters:
    • card: binary flag of the card to drop (binary string)
    • world: world to drop in (string)
    • x: x tile coordinate (float)
    • y: y tile coordinate (float)
• keycard-add
  • description: give the player keycard(s)
  • parameters:
    • cards: binary mask of what keycards to add (they are or'ed in)
• keycard-remove
  • description: take keycard(s) from the player
  • parameters:
    • cards: binary mask of what keycards to remove (they are anded with the inverse)
• keycard-clear
  • description: remove all keycards from the player

##Device

• device-drop
  • description: drop the device
  • parameters:
    • world: world to drop in (string)
    • x: x tile coordinate (float)
    • y: y tile coordinate (float)
• device-give
  • description: give the player the device

##Drops

• health-drop
  • description: drop a health item
  • parameters:
    • health: health to add (1.0 = max player health)
    • world: world to drop in (string)
    • x: x tile coordinate (float)
    • y: y tile coordinate (float)

##Laser Devices

• laser-dev-rotate
  • description: rotates a laser device
  • parameters:
    • world: world to drop in (string)
    • x: x tile coordinate (int)
    • y: y tile coordinate (int)
• laser-dev-toggle
  • description: toggles a laser emitter
  • parameters:
    • world: world to drop in (string)
    • x: x tile coordinate (int)
    • y: y tile coordinate (int)

##Checkpoints

• checkpoint
  • description: set the respawn location for a player (i.e. checkpoint)
  • parameters:
    • name: name of the checkpoint object

##Zombies

• zombie-spawn
  • description: Spawn a zombie in a world
  • parameters:
    • world: name of the world to spawn it in
    • x: x tile coordinate (float)
    • y: y tile coordinate (float)
• zombie-spawn-x
  • description: Spawn a zombie in a world with special parameters
  • parameters:
    • world: name of the world to spawn it in
    • x: x tile coordinate (float)
    • y: y tile coordinate (float)
    • move_speed: speed the zombie moves at, in tiles per millisecond (try: 0.005)
    • attack_duration: time in milliseconds between zombie attacks (try: 900)
    • attack_strength: strength of a single attack - 1.0 is the entire player's health (try: 0.075)
    • attack_distance: distance a zombie can attack over - recommended 1.1 to deal with some AI issues (try: 1.1)