# Actions

List of all actions available to use in dungeon scripts.

# Target

Some scripts have Target option to define action target. It accepts the following values:

GLOBAL - Performs an action globally.
ALL_PLAYERS - Performs an action per each dungeon player.
ALIVE_PLAYERS - Performs an action per each alive dungeon player.
EVENT_PLAYER - Performs an action for a player involved in the dungeon event.

# List

Adds specific task to the current dungeon stage.

Type: add_task

Options:

TaskId - Task identifier (must present in the config of current dungeon stage).
Replace - Whether to replace the same current task. Values: true, false.

Example:

Type: add_task
TaskId: kill_mobs
Replace: false

Removes a task from the current dungeon stage.

Type: remove_task

Options:

TaskId - Task identifier (must present in the config of current dungeon stage).

Example:

Type: remove_task
TaskId: kill_mobs

Marks dungeon as 'completed' or 'failed' and initializes end countdown.

Type: dungeon_end

Options:

Countdown - End countdown value (in seconds).
Completed - Whether dungeon is completed or not. Values: true, false.

Example:

Type: dungeon_end
Completed: true
Countdown: 10

Resets spot to it's initial state set in the config. All spots are auto-reset on dungeon end.

Type: reset_spot

Options:

SpotId - Spot identifier.

Example:

Type: reset_spot
SpotId: gate

Revives dead players if they have extra lifes and there is at least one alive player left in the dungeon.

Type: revive_players

Options:

Check_Death_Time - Whether to check player's death time or not. Values: true, false.
Seconds_Since_Death - Min. and max. amount of seconds since player's death to revive. Use -1 for no min/max limit.

Example:

Type: revive_players
Check_Death_Time: true
Seconds_Since_Death:
  Min: 30
  Max: 60

Runs listed commands globally or on specific player(s).

Type: run_command

Options:

Commands - List of commands.
Target - Command Target.

Placeholders:

%player_name% - Player name.
%player_display_name% - Player display name.
PlaceholderAPI

Example:

Type: run_command
Target: EVENT_PLAYER
Commands:
- eco give %player_name% 10
- heal %player_name%

Changes current dungeon level. If dungeon is already on that level, nothing happens.

Type: set_level

Options:

LevelId - Level identifier.

Example:

Type: set_level
LevelId: level_2

Changes current dungeon stage. If dungeon is already on that stage, nothing happens.

Type: set_stage

Options:

StageId - Stage identifier.

Example:

Type: set_stage
StageId: stage_2

Changes spot state. If spot is already on that state, nothing happens.

Type: set_spot

Options:

SpotId - Spot identifier.
StateId - State identifier.

Example:

Type: set_spot
SpotId: gate
StateId: open

Spawns mob(s) in the dungeon.

Type: spawn_mob

Options:

MobId - Mob Identifier.
SpawnerId - Spawner identifier (must present in the dungeon config).
Amount - Scalable Amount of mobs to spawn.

Example:

Type: spawn_mob
MobId: 'ada:zombie'
SpawnerId: spawner_1
Amount:
  Initial:
    Min: 1
    Max: 1
  Scalers:
    PLAYER_AMOUNT:
      Value: 1
      Type: PLAIN