Commands
Mythic Dungeons comes with a suite of commands to simplify the dungeon creation and play process. Commands will also list the permission associated with them. If a command does not have a permission associated with it, it is available by default.
Important Note!
To use the function editor (the feather tool), you must have the dungeons.functioneditor
permission, even if you have the dungeons.admin
permission!
Core Commands
These commands are the main commands admins and players will employ.
-
/md
(or/dungeon
)
This is the main command for most Mythic Dungeons subcommands. -
/recruit
(EXPERIMENTAL)
Walks you through setting up a party recruitment. You will be prompted to enter information about your party. Party recruitment is broadcasted to the chat regularly so other players can join your party. NOTE: This feature is experimental and rudimentary. While it mostly works, there are known issues cosmetic issues with it that will be fixed soon.
dungeons.party.recruit
-
/recruit cancel
Used to cancel your active party recruitment.
dungeons.party.recruit
-
/leave
Alias for/md leave
. Lets a player immediately leave the dungeon they are in. If the dungeon is in edit mode and there are no players still editing it, it will save and unload the dungeon. -
/ready
When queued for a dungeon, confirms you are ready to enter the dungeon. When all party members are ready, they will be sent to the dungeon. (Note: When queued, a clickable message with the same function is provided.) -
/notready
When queued for a dungeon, if one player in the party says they're not ready, it will cancel the dungeon queue. (Note: When queued, a clickable message with the same function is provided.) -
/stuck
Alias for/md stuck
. Immediately sends the player to their last checkpoint or respawn point in the dungeon. (Admins can configure this to kill the player inconfig.yml
.)
dungeons.stuck
-
/rewards
Opens the player's rewards inventory. If opened in a dungeon, the player can only view the items. Otherwise, players can retrieve their rewards from here.
Player Commands
These are basic commands used to access and play dungeons.
-
/md play <dungeon> [player]
The main command for entering/playing a dungeon. If the player is solo, they will enter immediately. If they are part of a party, they will enter a queue and all players must agree to enter the dungeon. If no player is specified, it will use the player who sent the command.
dungeons.play
to enter a dungeon using the command.dungeons.play.send
to specify a player to send to the dungeon. -
/md stuck
Immediately sends the player to their last checkpoint or respawn point in the dungeon.
dungeons.stuck
-
/md leave
Lets a player immediately leave the dungeon they are in. If the dungeon is in edit mode and there are no players still editing it, it will save and unload the dungeon. -
/md lives
Lets the player see their remaining lives in the dungeon.
Admin and Dev Commands
These are commands used to monitor, create, and edit dungeons.
-
/md join <player>
Allows an admin to enter the target player's current dungeon.
dungeons.admin
-
/md kick <player>
Kicks the target player from the dungeon they're in.
dungeons.admin
-
/md create <dungeon name>
Creates a brand new dungeon with the specified name. Created dungeons are always a flat world.
dungeons.admin
-
/md import <world>
Imports an existing Minecraft world from the server as a dungeon. Useful if you made the world offline or with an editor like worldpainter.
dungeons.admin
-
/md dxlimport <map>
EXPERIMENTAL
Imports a map from DungeonsXL. This checks for the map in theplugins/DungeonsXL/maps
folder. Monitor your console for any messages reporting signs or functionality that can't be converted into Mythic Dungeons.
dungeons.admin
-
/md edit <dungeon>
Either creates or joins an edit session for the specified dungeon. Edit sessions allow building the map itself and configuring dungeon elements.
dungeons.edit
dungeons.edit.*
for edit access to all dungeons
dungeons.edit.[dungeonname]
for edit access to a specific dungeon. -
/md delete <dungeon>
Deletes the specified dungeon. It will ask you to run the command again to confirm deletion.
dungeons.admin
-
/md addkey <dungeon>
Adds your currently held item as a dungeon access key for the specified dungeon. This means player MUST have one of this item to access the dungeon, and the item will be consumed upon entry. If no access keys are configured, the dungeon will not require a key to access it.
NOTE: Mythic items compatible! If a Mythic item is added, it will use the item's namespace instead of its item data.
dungeons.edit
dungeons.edit.*
for edit access to all dungeons
dungeons.edit.[dungeonname]
for edit access to a specific dungeon. -
/md removekey <dungeon>
Removes your currently held item from the dungeon's list of valid access keys.
dungeons.edit
dungeons.edit.*
for edit access to all dungeons
dungeons.edit.[dungeonname]
for edit access to a specific dungeon. -
/md status
OR/md status [dungeon]
Displays information about all or the specified dungeon, including current players and instances.
dungeons.admin
-
/md reload
Reloads the plugin config file. To reload dungeons, see below.
dungeons.admin
-
/md reload [dungeon]
OR/md reload all
Reloads the config and functions of all or the specified dungeon.
dungeons.admin
-
/md setcooldown <dungeon> <player> [duration]
Manually sets the dungeon access cooldown for the target player. Defaults to the dungeon's configured cooldown if a duration is not specified.
dungeons.setcooldown
-
/md setexit <dungeon>
Sets the exit location for the dungeon, which is where the player will appear after finishing the dungeon. (Using the "Finish Dungeon" function.) The dungeon's config.yml includes an option to use this exit regardless of how the player leaves the dungeon.
dungeons.edit
dungeons.edit.*
for edit access to all dungeons
dungeons.edit.[dungeonname]
for edit access to a specific dungeon.
Loot Table Commands
These commands are used to create and modify loot tables.
-
/md loot create [name]
Creates a new loot table with the provided name.
dungeons.loottables
-
/md loot edit [name]
Opens the edit menu for a loot table matching the provided name.
dungeons.loottables
-
/md loot remove [name]
Deletes the specified loot table.
dungeons.loottables
Edit Mode Commands
These are commands only available while editing a dungeon.
-
/md setlobby
Sets the lobby spawn location of the dungeon you're editing. (Also preserves where you're looking.)
dungeons.edit
-
/md banitem
Adds the item in your hand to the banned items list, preventing players from entering the dungeon if they have it in their inventory.
dungeons.edit
-
/md unbanitem
Removes the item in your hand from the banned items list. (If you're having trouble removing an item, you can also remove it manually in the dungeon'sconfig.yml
)
dungeons.edit
-
/md dungeonitem
Makes your currently held item into a dungeon item, preventing it from being taken out of the dungeon. (It will be deleted when the player leaves with it in their inventory.)
dungeons.edit
-
/md functiontool
Gives you the function builder tool, just in case you lost it!
dungeons.functioneditor
is required to get and use the function builder. -
/md save
Force-saves the dungeon immediately. Note: There is a configurable autosave option set to 5 minutes by default, and the dungeon will save when all editors leave, but just in case, you can still do it manually!
dungeons.edit
-
/md cleansigns
Removes all signs located at all the function locations. Useful after importing a DXL dungeon or to quickly clean out temporary blocks.
dungeons.cleansigns
Party Commands
These commands are used by the default party system provided by Mythic Dungeons.
-
/party invite [player]
Invites the target player to join your party, creating a new party if you don't have one yet. -
/party join [player]
Attempts to join the specified player's party. Only works if you have an invite. -
/party leave
Immediately leaves the current party you're in. -
/party givelead [player]
Makes the specified player the leader of the party. -
/party kick [player]
If you are the party lead, kicks the specified player from the party. Yes, you can kick yourself from your own party. -
/party disband
Immediately kicks all players from the party, including yourself. -
/party chat
OR/p
Lets you switch to party chat, making all your messages go to a private chat with your party members. -
/party chat [message]
OR/p [message]
Sends a message to the private party chat without switching to it.
More Permissions
-
dungeons.bypasskeys
Players with this permission will not require an access key to access any dungeon. -
dungeons.bypasscost
Players with this permission will not require a Vault-compatible currency to access any dungeon. -
dungeons.bypasscooldown
Players with this permission will bypass the cooldown for all dungeons.