# Levels & Stages

# Levels

Levels are mean to define global dungeon behavior. They can listen for dungeon events and execute custom scripts when specific events fired.

Initial dungeon level defined by the Start Level setting in the Dungeon Settings.

Level configurations located inside the /levels/ sub-directory of your dungeon's directory.

Level must have a defined spawn location for players. This location is used to spawn players when dungeon started, respawn dead players, and in a few other less important cases.

Levels can be used to "split" the dungeon map and restrict access to other dungeon's regions. Use them as "checkpoints", so dead players will continue from that position. Or simply have different scripts executed based on the current dungeon/arena's progress.

However, there is no strict instructions on how you should use dungeon levels. It all depends on your creativity!

# Level Creation

Adding dungeon levels is simple.

Run the /ada addlevel <dungeon> <name> command. Where <dungeon> is your dungeon identifier, <name> is new level identifier.

It will create a new level configuration with some default scripts, that you should modify according to your preferences.

To change level's spawn location, use the following command: /ada setlevelspawn <dungeon> <level>, where <dungeon> is your dungeon identifier, <level> is level identifier.

# Stages

Stages are mean to define local dungeon behavior. They can listen for dungeon events and execute custom scripts when specific events fired.

Initial dungeon stage defined by the Start Stage setting in the Dungeon Settings.

Stage configurations located inside the /stages/ sub-directory of your dungeon's directory.

Stages are very similar to levels, but instead of spawn location, they have the Tasks feature.

Stages can be used to create "rounds" like in mob arenas. Lock or unlock dungeon map progression depends on (in)completed tasks. Spawn bosses when players killed certain amount of mobs.

However, there is no strict instructions on how you should use dungeon stages. It all depends on your creativity!

# Stage Creation

Adding dungeon stages is simple.

Run the /ada addstage <dungeon> <name> command. Where <dungeon> is your dungeon identifier, <name> is new stage identifier.

It will create a new stage configuration with some default scripts, that you should modify according to your preferences.