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
  • Your First Dungeon

Last edited by MarcatoSound Nov 13, 2023
Page history

Your First Dungeon

Mythic Dungeons is an incredibly powerful and flexible plugin. It's been designed to be approachable and to minimize your need to use a wiki like this one. However, this startup guide will give a more thorough tutorial on how to start making dungeons that will blow the minds of your players!

(VIDEO COMING SOON)

The Dungeon Map
Before we can start building our dungeon, we need to create the map. This can be done in one of two ways:

  • /md create <dungeon name> - This will create a new dungeon with a name you provide. The map it creates will be a superflat world with no structures. It's a perfect blank slate for you to start building in.
  • /md import <world> [type] - This will copy the world specified from your server folder and create a dungeon from it. If you're importing a Nether or End world, you MUST tell it a type, which can be NETHER or THE_END.

Once you've created your dungeon map, you can use /md edit [dungeon] to open the dungeon editor and begin building and scripting your dungeon!

The Dungeon Editor

Welcome to the dungeon editor. This is where you can build the dungeon itself and set up all your scripts and events. By default, the dungeon will be autosaved every 5 minutes, but this can be changed in the plugin's config.yml. It will also save when you /md leave the dungeon, or when you use the command /md save.

Setting the Start Point
Let's say we've built a pretty nice looking dungeon, but we want to change where players go when the dungeon starts. This is very simple, and can be done with /md setspawn.

OPTIONAL: Dungeon Lobby
An optional feature your dungeons can make use of is a lobby. You can create an area where the players will first appear in the dungeon before it begins. You can set the lobby spawn point to where you're standing with /md setlobby. This will also enable the lobby. NOTE: If the lobby is enabled, none of your functions will work until a Dungeon Start function has been activated. (See below to learn more about functions.)

The Function Editor

Once you open your dungeon in edit mode, you'll be given a Function Builder item. As its name implies, this item is used to set up dungeon functions - your bread and butter for dungeon scripting. If you ever lose the function builder, you can always get it back with /md functiontool.

Making a Function

Functions perform actions in your dungeons, including spawning monsters, sending messages, and teleporting players. All functions have a set of configurable options on them.

By right-clicking a block with the function builder, you'll see a list of function types. These categories will each contain different functions for your dungeon. You can find a list of functions here.

Adding a Trigger

After selecting a function to build, you'll be prompted to choose a trigger. Triggers are effectively your "objectives", running the function when activated. Functions can be triggered by mob deaths, player actions (such as right-clicking or entering an area), and other events. Like functions, triggers will have configurable options on them. You can find a list of triggers here.

The Hotbar Menu

Once you've selected a function and a trigger, your hotbar will be temporarily swapped with a menu containing the function and trigger options. You can right-click with the various items here to modify these options or see more.

You can exit the hotbar menu at any time by holding crouch.

Adding Trigger Conditions

If you want even more control over your trigger, you can add Conditions to it using the hotbar menu. Conditions can be attached to triggers to prevent them from running until the conditions are met. This can include players being nearby, player count, or a custom Mythic Mobs condition. You can find a list of conditions here.

Playing Your Dungeon

Once you've built your dungeon and set up your functions, you can safely use /leave to exit edit mode. From there, all you have to do is run the command /md play [dungeon name] and it will take you to the dungeon.

Note: You can also use /md play [dungeon name] [player] to send a player and their party to a dungeon.


And you're good to go! From here, you can take a look at the different functions, triggers and conditions available here on this wiki, as well as take a look at the dungeon config and commands to learn even more about what you can do with your dungeons.

Next: Dungeon Config -->

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