Skip to content

GitLab

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in
MythicDungeons MythicDungeons
  • Project overview
    • Project overview
    • Details
    • Activity
  • Issues 86
    • Issues 86
    • List
    • Boards
    • Labels
    • Service Desk
    • Milestones
  • Operations
    • Operations
    • Metrics
    • Incidents
  • Analytics
    • Analytics
    • Repository
    • Value Stream
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Members
    • Members
  • Activity
  • Create a new issue
  • Issue Boards
Collapse sidebar
  • MythicCraft
  • MythicDungeonsMythicDungeons
  • Wiki
  • Commands and Permissions

Last edited by MarcatoSound Mar 22, 2024
Page history

Commands and Permissions

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

  • /recruit browse
    Opens a window showing all parties currently recruiting players.
    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 in config.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.

    Dungeon Difficulties (v1.3.1+)
    /md play <dungeon>[:difficulty] [player]
    The dungeon's difficulty level can be specified in-command (example: /md play MyDungeon:HARD).
    dungeons.play.difficulty to allow specifying the difficulty in command. (Unnecessary for difficulty menu.)

  • /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 the plugins/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's config.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. Note: /party can be replaced with /dparty in the case of plugin conflicts.

  • /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.

  • /party spy
    Toggles being able to see the party messages of other players and parties.
    dungeonparties.spy

More Permissions

  • dungeons.bypasskeys OR dungeons.bypasskeys.[dungeon]
    Players with this permission will not require an access key to access any dungeon.

  • dungeons.bypasscost OR dungeons.bypasskeys.[dungeon]
    Players with this permission will not require a Vault-compatible currency to access any dungeon.

  • dungeons.bypasscooldown OR dungeons.bypasscooldown.[dungeon]
    Players with this permission will bypass the cooldown for all dungeons.

Clone repository

NOTE: Items marked with * are incomplete or unwritten.

General Info
  • Changelogs
  • Free vs Premium
  • Commands and Permissions
  • Plugin Config
  • How it all Works
Guides
  • Getting Started
  • Your First Dungeon
  • Importing from DXL
Dungeon Elements
  • Dungeon Config
  • Dungeon Types
  • Functions
  • Triggers
  • Conditions
Generated Dungeons [2.0+]
  • Procedural Dungeons Overview
  • Dungeon Rooms
  • Default generation.yml
  • Generator Tips & Tricks
  • Troubleshooting
Compatibility
  • Mythic Mobs
  • Placeholder API
  • BetonQuest
Developer Documentation
  • Avoiding Memory Leaks
  • Introduction to API
  • Getting Started with Elements
  • GUI Menus
  • *Custom Functions
  • *Custom Triggers
  • *Custom Conditions
  • Adding Party Support
    [Coming Soon!]
  • *Custom Dungeon Types
  • *Custom Procedural Layouts