BetonQuest Compatibility

Mythic Dungeons features very basic BetonQuest compatibility by adding one action and one objective. In the future, if there is demand for it, functions that can call BetonQuest actions may be considered.

BetonQuest 3.0 or higher is required. On an older BetonQuest, Mythic Dungeons logs WARNING :: Incompatible BetonQuest version! You must use version 3.0 or higher! and registers neither element.

In both elements below, [dungeon name] is the dungeon's folder name inside plugins/MythicDungeons/maps/, not its DisplayName. The comparison is case-sensitive. Each element takes that one argument and nothing else.

Mythic Dungeons Objectives

Finish Dungeon
finishdungeon [dungeon name]
Completed when the player finishes the specified dungeon. It is triggered by the Finish Dungeon function and by the dungeoncomplete Mythic Mobs mechanic, both of which fire once per player, so every member of a party completes their own objective. Any conditions: you put on the objective still apply.

Mythic Dungeons Actions

Play Dungeon
playdungeon [dungeon name]
Sends the player (and their party if they have one) to the specified dungeon. In BetonQuest 3.x this goes in the actions: section of your quest package, not in events:.

Every check Mythic Dungeons normally runs before letting someone in still runs here: party size limits, access keys, the entry cost, permission requirements, access cooldowns, and any dungeons that must be completed first. When one of them refuses, the player gets the usual chat message and is not sent anywhere, and BetonQuest still treats the action as having succeeded. Only an unknown dungeon name raises a BetonQuest error.

If every check passes but no instance is free, the player is put in the queue and told the instances are full, and they enter when one frees up.

There is no difficulty argument. The action always asks for the difficulty named DEFAULT, so unless the dungeon actually has a difficulty level by that name, it runs on its base configuration, and the difficulty selection menu is never shown. The action also does not check the dungeons.play permission.