Skip to content

GitLab

Last edited by MarcatoSound
Page history

Mythic Dungeons 2.0

DISCLAIMER
The following features are only available in Mythic Dungeons 2.0 dev builds!!

Mythic Dungeons 2.0 is a major overhaul of the Mythic Dungeons plugin. It is primarily dedicated to introducing the dungeon types system, the procedural dungeon generator, and improving the API and code quality to make the creation of add-ons easier.

With the arrival of 2.0, the Mythic Dungeons plugin will be going up in price from $20 to $30

Dungeon Types

2.0.0 introduces "Dungeon Types", which can change the foundational behaviour of your dungeon. While this is mostly an API feature, Mythic Dungeons provides some new dungeon types of its own.

Continuous
A dungeon type that, when players attempt to play the dungeon, will send them into the first available ongoing dungeon instance. For example, if Player A starts player the dungeon, and after a while Player B tries to play the dungeon as well, Player B will be sent to Player A's dungeon.

NOTE: This is NOT a replacement for world managers like Multiverse and MyWorlds! The dungeon will be unloaded once all players have left it. This is useful for hosting scripted multiplayer events, or specialized dungeon types that are compatible with multiple parties.

An formal extension of this dungeon type for multi-party dungeons such as minigames is currently planned.

Procedural/Generated
A dungeon type that allows randomly generating a dungeon from a configurable collection of rooms. Requires FastAsyncWorldEdit! Learn more on the dungeon generator page.

Misc Features

  • Dungeons now support custom chunk generators, including those provided by other plugins.
  • Mythic Dungeons now includes a void chunk generator.
  • Mythic Dungeons now includes a single-block chunk generator for generating chunks full of a specific block.

API Changes Advisory

There are several major changes to how Mythic Dungeons are loaded and instantiated, as well as a lot of refactored classes - especially utilities. Further details will be shared here at a later date.

Dungeon & Instance Objects
The most breaking change is that dungeon and instance objects have been restructured. Most methods now return a AbstractDungeon and AbstractInstance object now as part of our type system. Furthermore, Dungeon has been renamed to ClassicDungeon, and Instance has been renamed to ClassicInstance.

The new abstract objects have utility methods in them for casting to a specific dungeon type. These methods are safe to use, but will return null if the dungeon or instance type doesn't match the requested type. (For example, if you call DungeonProcedural#asClassic(), it will return null, because DungeonProcedural is not a classic dungeon.)

Utility Classes
A lot of Mythic Dungeons utility classes and methods got moved around and renamed. This page will do its best to provide a comprehensive list of classes that were renamed and methods that have been moved. The goal with this is to make the utilities much more organized, and there's no better time for that than with version 2.0.

Utility Changes **Util.class** - Changes will go here.

FAQ

Will I need to buy Mythic Dungeons again?
No. If you have already purchased Mythic Dungeons before this update, you will not need to pay for it again.