TheDungeons

As usual, something has been fixed and something has been optimised somewhere.
The plugin will now be fully rewritten. It will be faster and more convenient than it is currently.
It will no longer depend on the PLAZMER-ENGINE and the settings menu. The dungeon editor will be removed from it.
The plugin will only be configured through configuration, but will still be as convenient as before.

• Fixed a situation where the dungeons spawn not in a random location but in the previous one

• Fixed an issue where the generator was searching for the same location.
• Fixed an issue where monsters appeared and/or teleported into blocks.
• Added optimization for location search.
• Added optimization for module search.

[If you have any problems with launching or operating the plugin, please do not hesitate to contact us via our Discord!](https://discord.gg/ajnPb3fdKq)

• Fixed an issue where the plugin would run but not work in version lower than 1.19.
• Fixed incorrect operation of schematics module

• Fixed an issue where monsters from the Mobs module would not delete.
• Fixed an issue with the asynchronous use of the FAWE (we)

### [Thank you for reporting the errors in our Discord. I am very grateful to you!](https://discord.gg/ajnPb3fdKq)

• Fixed an issue where the plugin did not have access to files.
• Added logging for holograms

• The type of click has been changed in the schematic editor. SHIFT+RIGHT replaced by SHIFT+LEFT
• Fixed a problem with creating configurations.
• Fixed a problem with creating a generation configuration that prevented the plugin from working correctly.
• Added even more logging.

### Attention! Update the [PLAZMER-ENGINE](https://github.com/getplusm/Engine/releases/latest) to the latest version!

• Thanks a lot for the help in finding the bug and testing

@rayne_10!**

Added more logging and more information in the command
/dungeons debug

• Attention!** Update the [**PLAZMER-ENGINE**](https://github.com/getplusm/Engine/releases/tag/2.4.10) to the latest version!

• Added support for **Fabled** (ProSkillAPI) and **Parties** plugins

• Added support for 1.21.4
• Optimized the plugin and fixed bugs that prevented it from working correctly.
• Added the auxiliary command /dungeons debug, which creates a pastebin with the necessary information for the developer.
• Problems related to completely incorrect asynchronous use of functions have also been fixed
• Added more error logging.

### Be careful, some functions related to version 1.21.4 may give errors. If there are any, please report them in our [discord](https://discord.gg/ajnPb3fdKq)

### Upgrade the [PLAZMER-ENGINE](https://github.com/getplusm/Engine) and remove all your rewards before upgrading!​

All known bugs have been fixed.
The multithreading is now working properly.
Modules have become faster and with debug messages so that you can track errors more easily <3

• Important:** Delete the Editor section in your /lang/message_**.yml

### FIXED:

• Fixed a situation where opening a chest would restart the stage backwards.
• Fixed a situation where it was impossible to open a chest.
• Fixed drop/spawn command and temporarily removed the option of random spawning by command.
• Fixed display of settings status in menus
• Other minor module fixes

### ADDED & REWORK:

• Announce Module:**
• Now you can create announcement templates and use them on any stage.
• Now you can set different announcements on the same stage with different times.


• Chest Module:**
• Added setting of reward limits.
• The item amount setting has been changed, now, you can set the amount to 1.
• Added a list of commands that will be executed when opening a chest.

(it doesn't matter how many the item is, the commands will be executed 1 time)

• Improved random filling
• Other**
• Changed the display of time to the next state of the chest.

It now displays hours, minutes and seconds

• Schematic methods have been updated

Fixed modules of holograms and chests. A bug prevented creating chests and holograms above them

Happy new year!
My New Year's present is version 2.0.0!

Read the full changelog here: [GITHUB LINK](https://github.com/getplusm/Dungeons/releases/tag/2.0.0)

Fixed an issue where dungeons would not spawn in the world or could not be deleted. This was caused by improving the schematic systems, everything is now stable, but if you have problems, please report them.

FIXED:

Fixed the situation when the plugin did not spawn dungeon and at the same time, did not give errors on versions (Paper 1.20.1) 'Thanks pafema'

Fixed a situation where the plugin could output "Nag author(s): '[plazmer]'" in the console.

WARNING:

⤚ Necessary to update PLAZMER-ENGINE to version 2.4
https://github.com/getplusm/Engine

FIXED:

Minor fixes

ADDED:

Towny support

<div>
<strong><span style="color: rgb(255, 77, 77);">FIXED:</span></strong>
<ul>
<li>Fixed a situation where the plugin was creating an empty file on first run.</li>
<li>Fixed a situation where the plugin did not delete dungeon designs on shutdown.</li>
<li>Fixed changing the maximum amount of an item in the rewards menu.</li>
<li>Fixed a situation where the plugin complained about starting tasks when it was already turned off.</li>
<li>Fixed monster behavior.</li>
<li>Fixed temporary calibrations in synchronization between holograms.</li>
</ul>
</div>

<div style="text-align: center;">
<span style="color: #ff9999;">Thanks to everyone who reported bugs in <a href="https://discord.gg/ajnPb3fdKq"><span style="font-family: Georgia; color: #ff8000;"><strong>our discord</strong></span></a></span>
</div>

<div style="text-align: center;">
<strong><span style="color: #ff0000;">Love you!</span></strong>
</div>

<br>


<div style="text-align: center;">
<strong style="font-size: 36px; color: rgb(179, 89, 0);"><a href="https://discord.com/invite/ajnPb3fdKq">ideas, bugs & help</a></strong>
</div>

<div style="text-align: center;">
<strong><span style="font-size: 36px; color: rgb(179, 89, 0);">✨With wonderful support and frequent updates, each of your adventures becomes exciting and filled with fun<span style="color: red;">❤</span> Leave your enthusiastic review and become part of our magical team, creating enchanting moments together</span></strong>
</div>

WARNING:
⤚ Necessary to update PLAZMER-ENGINE to version 2.3.9+

⤚ Create a backup copy of the /lang/ folder so as not to lose your content

FIXED:

Fixed a bug where you could not customize the dungeon world

Fixed a bug where a dungeon would not appear due to the lack of a world

Fixed a situation where you have multiple chests listed, but they all appear in the same chest

Changed and optimized the code for dungeon appearance, as well as reduced the load on the main thread of the server

Minor fixes

ADDED & REWORK:

Added support for Party System. You can enable this setting in /dungeon editor and specify the number of people in a party to enter the dungeon.

Added support for KingdomX regions

Added commands for opening and closing stages. This feature will allow you to spawn your own mobs from MythicMobs & others

Added custom monster system which includes:

• Monster Type
• Monster Name
• Monster Rider
• Monster effects
• Monster Equipment
• Monster Attributes

FIXED:
Error that caused the generator to not create a location
(Thanks to Juessa for the report)

Updated localization files for versions above 1.17.1

Error that could cause the plugin not to load if you do not have WorldGuard installed

<div>
<strong style="font-size: 24px; color: #ff0000;">WARNING:</strong>
<div style="margin-left: 20px;">
<a href="https://github.com/getplusm/Engine" style="text-decoration: none;">
<strong style="color: #ff4d4d;">The plugin is completely dependent on my engine. If you do not install it, the plugin will not work.</strong>
</a>
</div>
<div style="font-size: 24px; color: #000000;">
<strong>Many localization files have been removed and reworked. Delete the /lang/ folder so that everything works correctly for you!</strong>
</div>
<div>
<strong style="color: #ff4d4d;">To optimize some problems, I had to remove support for servers before 1.17.1!</strong>
</div>
</div>

<div>
<strong style="color: #ff4d4d;">FIXED:</strong>
<ul>
<li>A bug where the dungeon was taking an infinite number of keys from players or not taking them at all</li>
<li>Other, less interesting bugs</li>
</ul>
</div>

<div>
<strong style="color: #00b300;">ADDED & REWORK:</strong>
<ul>
<li>A setting that will allow you to disable/enable a dungeon in <strong>/dungeon editor</strong></li>
<li>Reworked dungeon settings and added many new ones.</li>
<li>Reload button in the editor</li>
<li>Chest block limit settings</li>
<li>A setting that allows you to split the loot in chests. Can now be set true - different loot, false - same loot.</li>
<li>Setting that controls keys. You can now choose whether the player who activates or opens a chest will open it for all players or only for himself.</li>
<li>Time parameters have been changed, it is now different for dungeons and chests. You can customize opening, closing and waiting times for chests and dungeons.</li>
<li>A setting that prohibits players from entering a dungeon when it is closed</li>
</ul>
</div>

<div>
<strong style="color: #59b300;">Chest Rework:</strong>
<ul>
<li>Each chest block is now a separate chest block. At the moment, you cannot personalize each chest, but you can set the randomness of the loot drop. The CLICK opening type is now much more useful, as the player can open chests at different intervals.</li>
<li>Now, if a dungeon has an active chest, it will not be deleted, but now it will be deleted until the list of active chests is empty</li>
</ul>
</div>

<div>
<strong style="color: #b3b300;">Optimization:</strong>
<ul>
<li>Schematic method</li>
<li>Location generator</li>
<li>Chest block finder generator</li>
</ul>
</div>

<div style="text-align: center;">
<strong style="font-size: 36px; color: rgb(179, 89, 0);"><a href="https://discord.com/invite/ajnPb3fdKq">ideas, bugs & help</a></strong>
</div>

<div style="text-align: center;">
<strong style="font-size: 36px; color: rgb(179, 89, 0);">✨With wonderful support and frequent updates, each of your adventures becomes exciting and filled with fun<span style="color: red;">❤</span> Leave your enthusiastic review and become part of our magical team, creating enchanting moments together</strong>
</div>

<p><strong><span style="color: #b30000">~</span></strong> Fixed a bug where the hologram would not appear on the re-spawn of the dungeon.</p>
<p><strong><span style="color: #b30000">~</span></strong> Fixed a bug where the plugin would hang when checking a chest block.</p>
<p><strong><span style="color: #b30000">~</span></strong> Fixed a bug where the hologram would not be removed.</p>
<p><strong><span style="color: #b30000">~</span></strong> Minor fixes.</p>

<p><strong><span style="color: #00b300">+</span></strong> Added debug setting.</p>
<p><strong><span style="color: #00b300">+</span></strong> Added more errors to the console.</p>

<p><strong><span style="color: #00b300">+</span></strong> Rewritten chest block search generator. Now, this happens automatically from your schematic. The plugin counts their number per schematic and writes them to the cache, and at the moment the dungeon spawns, based on the value, it finds their locations. This increased the performance of the plugin by 8ms. The <strong>Blocks &amp; Search Radius</strong> setting now only sets the search radius.</p>

<p>We are currently preparing a new block search generator. It will have to increase the speed by even more ms.</p>

<div style="text-align: center;">
<strong><span style="font-size: 36px; color: #ff0080;">I wrote a detailed guide on creating and configuring dungeons, you can read it on the plugin <a href="https://github.com/getplusm/Dungeons/wiki"><span style="font-size: 18px; color: #ff0080; text-decoration: underline;">wiki</span></a></span></strong>
</div>

<div style="text-align: center;">
<strong><span style="font-size: 36px; color: rgb(179, 89, 0);"><a href="https://discord.com/invite/ajnPb3fdKq">ideas, bugs &amp; help</a></span></strong>
</div>

<div style="text-align: center;">
<span style="font-size: 18px; color: #000000;"><strong>✨With wonderful support and frequent updates, each of your adventures becomes exciting and filled with fun<span style="color: red;">❤</span> Leave your enthusiastic review and become part of our magical team, creating enchanting moments together</strong></span>
</div>

[~] Fixed a bug where the dungeon did not appear when using the command /dungeon drop <world> random <br>
[+] Added more error messages to the console to help you figure out what's wrong or report it to me

<p>[~] Fixed a bug where the dungeon might not appear.</p>
<p>[~] Fixed a bug where the dungeon time was not running.</p>
<p>[~] Fixed a bug where the dungeon could not be deleted.</p>
<p>[~] Fixed a bug where region dependency was required.</p>
<p>[~] Hologram bugs fixed.</p>
<p>[~] Fixed minor bugs.</p>
<p>[~] Fixed a bug where the bossbar did not disappear from the player when the dungeon was canceled.</p>

<p>[+] Added support for GriefDefender and GriefPrevention plugins.</p>
<p>[+] Added support for PAPI - https://github.com/getplusm/Dungeons/wiki/Placeholders</p>
<p>[+] Added a setting to ignore air blocks to the region.</p>
<p>[+] Added advanced region setting in the editor.</p>

<p>[~] Completely new location generator. Fewer false positives and higher speed. Generation occurs at the stage of preparing the dungeon, and not during its appearance. Now you can configure it in config.</p>
<p>[~] The system for searching for a chest block has been rewritten, now if any of the schematics does not contain a chest block, then it will be removed from the list of active schematics. Also, if after that, the dungeon has no active schematics left, then the dungeon will not be loaded (all this is displayed in the console).</p>

<div style="text-align: center;">
<strong><span style="font-size: 36px; color: rgb(179, 89, 0);">ideas, bugs &amp; help</span></strong>
</div> - https://discord.gg/ajnPb3fdKq

<p style="color: rgb(128, 128, 128);"><strong>✨With wonderful support and frequent updates, each of your adventures becomes exciting and filled with fun<span style="color: red;">❤</span> Leave your enthusiastic review and become part of our magical team, creating enchanting moments together<span style="color: red;">💌</span></strong></p>

<p><strong><span style="color: #b30000">~</span></strong> Fixed a bug when the minimum or maximum number of items was not saved.</p>
<p><strong><span style="color: #b30000">~</span></strong> Minor fixes.</p>
<p><strong><span style="color: #59b300">+</span></strong> Added support for multiple chests. Now, you can set the number of blocks that will be chests.</p>
<p><strong><span style="color: #59b300">+</span></strong> /dungeon editor changes. Now it has a nice design and intuitive buttons. Added chest material setting.</p>
<p><strong><span style="color: #59b300">+</span></strong> Added support for underground dungeons, now you can choose where the dungeon will spawn. <span style="color: #ff0000">Be careful</span>, because if the dungeon is underground and you are using the region plugin, then you need to add the appropriate rights so that the player can break blocks before the dungeon.</p>
<p><span style="color: #59b300"><strong>~</strong></span> Location search generator optimized.</p>
<p><span style="color: #59b300"><strong>~</strong></span> Fixed dungeon creation.</p>
<div style="text-align: center;">
<span style="font-size: 18px; color: #000000;"><strong><span style="font-size: 36px; color: rgb(179, 89, 0);"><a href="https://discord.gg/E7gJmpt2rg">ideas &amp; help</a></span></strong></span>
</div>
<div style="text-align: center;">
<span style="font-size: 18px; color: #000000;"><span style="color: rgb(128, 128, 128);">✨With wonderful support and frequent updates, each of your adventures becomes exciting and filled with fun<span style="color: red;">❤</span> Leave your enthusiastic review and become part of our magical team, creating enchanting moments together</span></span>
</div>

<p><strong><span style="color: #59b300">+</span></strong> Added FAWE support.</p>
<p><strong><span style="color: #59b300">+</span></strong> Added the command /dungeon drop <world> random - you can spawn a dungeon in a random location, previously you could only specify a location.</p>
<p><strong><span style="color: #59b300">+</span></strong> Introduced new settings:</p>
<ul>
<li><strong><span style="font-size: 18px; text-decoration: underline">Click Timer</span></strong> - Determines whether the timer for dungeon opening will be activated upon activation using the CLICK method.</li>
<li><strong><span style="font-size: 18px; text-decoration: underline">Big Chest</span></strong> - Determines whether a small chest (27 slots) or a large chest (54 slots) will be used.</li>
<li><strong><span style="font-size: 18px; text-decoration: underline">Random Slots</span></strong> - Determines how items will be placed in the dungeon chest. 'true' - in random slots, 'false' - in sequential order.</li>
</ul>
<p><strong><span style="color: #59b300">+</span></strong> Added settings for regions, including name, radius, and flags.</p>
<p><strong><span style="color: #59b300">+</span></strong> Added an option for effects.</p>
<p><strong><span style="color: #59b300">+</span></strong> Added a setting that allows you to disable notifications in the boss bar.</p>
<p><strong><span style="color: #b35900">+</span></strong> Completely overhauled the regions system. Now you can create an empty region by simply adding an empty schematic, or you can choose not to create a region at all.</p>
<p><strong><span style="color: #ff4d4d">-</span></strong> WorldEdit is now optional.</p>
<p><strong><span style="color: #b35900">+</span></strong> Improved location search system.</p>
<p><strong><span style="color: #b35900">+</span></strong> Improved schematic system.</p>
<p><strong><span style="color: #b35900">+</span></strong> All possible settings are now available in the /dungeon editor.</p>
<div style="text-align: center;">
<strong><span style="font-size: 36px; color: rgb(179, 89, 0);"><a href="https://discord.gg/E7gJmpt2rg">ideas &amp; help</a></span></strong>
</div>
<p style="color: rgb(128, 128, 128);"><strong><span style="font-size: 18px;">✨With wonderful support and frequent updates, each of your adventures becomes exciting and filled with fun<span style="color: red;">❤</span> Leave your enthusiastic review and become part of our magical team, creating enchanting moments together<span style="color: red;">💌</span></span></strong></p>
<div class="spoiler">
<p class="spoiler-header">Editor Showcase</p>
<img src="https://cdn.discordapp.com/attachments/810884357543165963/1134148371641270292/2023-07-27_20.38.38.png" alt="">
<img src="https://cdn.discordapp.com/attachments/810884357543165963/1134148372060704838/2023-07-27_20.38.10.png" alt="">
<img src="https://cdn.discordapp.com/attachments/810884357543165963/1134148372450787328/2023-07-27_20.38.12.png" alt="">
<img src="https://cdn.discordapp.com/attachments/810884357543165963/1134148372773736569/2023-07-27_20.38.18.png" alt="">
<img src="https://cdn.discordapp.com/attachments/810884357543165963/1134148373142847672/2023-07-27_20.38.22.png" alt="">
<img src="https://cdn.discordapp.com/attachments/810884357543165963/1134148373608398929/2023-07-27_20.38.35.png" alt="">
</div>

<p><span style="color:#59b300;font-weight:bold;">+</span> <span style="font-size:24px;">Added support for MMOItems and ItemsAdder plugins.</span></p>
<p style="font-size:16px;">To add items from these plugins, take the items into your inventory, go to /dungeon editor -&gt; your dungeon -&gt; rewards -&gt; and add rewards quickly by dragging the item onto the <span style="color:#006600;font-weight:bold;">+</span> icon. That's it! Afterwards, you can configure the displayed name, chance, and limit.</p>

<p><span style="color:#59b300;font-weight:bold;">+</span> <span style="font-size:24px;">Added the "use" flag for dungeon regions</span>. Now, the dungeon region can be configured to be disabled and have its name changed.</p>

<p><span style="color:#59b300;font-weight:bold;">+</span> <span style="font-size:24px;">Added the command /dungeon despawn &lt;* - all, dungeon-id&gt;.</span> <span style="font-size:16px;">Permission:</span> <u>dungeons.command.despawn</u></p>

<p><span style="color:#59b300;font-weight:bold;">+</span> <span style="font-size:24px;">Improved the dungeon spawning system.</span></p>

<p><span style="color:#59b300;font-weight:bold;">+</span> <span style="font-size:24px;">Updated location search system.</span> <span style="font-size:16px;">Now, you can customize the generator in the config.yml file. You can specify either the search radius or the barrier radius.</span></p>

<p><span style="color:#b30000;font-weight:bold;">!</span> Fixed a bug where it was possible to visually set the chance of an item above 100.</p>
<p><span style="color:#b30000;font-weight:bold;">!</span> Fixed a bug where the menu title was not updating.</p>
<p><span style="color:#b30000;font-weight:bold;">-</span> The WorldGuard plugin is now optional.</p>

MMOItems & ItemsAdder preview:
<div style="text-align:center;">
<div style="background-color:#F0F0F0;padding:10px;">
<div style="display:flex;justify-content:space-around;">
<div style="flex-basis:50%;"><img src="https://cdn.discordapp.com/attachments/810884357543165963/1132723730699796601/2023-07-23_21.19.21.png" alt="MMOItems Preview"></div>
<div style="flex-basis:50%;"><img src="https://cdn.discordapp.com/attachments/810884357543165963/1132723730263572500/2023-07-23_22.00.45.png" alt="ItemsAdder Preview"></div>
</div>
</div>
</div>

<div style="text-align: center;">
<strong><span style="color: #00b359;">+</span></strong> Updated localization files.
<br>
<strong><span style="color: #0000b3;">~</span></strong> Minor improvements and small fixes.
</div>

<div style="text-align: center;">
<strong>If you have <span style="color: #ff4d4d;">ideas</span>/<span style="color: #ff4d4d;">suggestions</span> or need <span style="color: #ff4d4d;">support</span>, feel free to <a href="https://discord.gg/CSsbbu7U"><span style="text-decoration: none;"><strong>join our Discord</strong></span></a></strong>
</div>

Fixed when all rewards were replaced with diamonds

Fixed bugs with the language (delete the lang folder if you want)

Fixed that bossbar was not deleted after disabling the plugin

Fixed display of placeholders in edit mode

Fixed the message about waiting, opening and closing

[+] Added support for DecentHolograms

[+] Added support for versions 1.18.2, 1.19.4 and 1.20.1 (and 1.17.1, etc.)

[+] Added setting of the minimum number of players for spawn dungeon

[+] Added displacement of the hologram along the Y axis

[+] Added all the necessary settings for the editor /dungeon editor

<center>!!!

Rewritten the test dungeon file test.yml to ensure everything works correctly, please delete the dungeon folder​</center>


Rewards items have been fixed. Now they can only be modified through the /dungeon editor, as they are saved in base64 format to avoid any damage.

Fixed the test schematic file. Now the plugin will load it into the folder.

Fixed the /dungeon drop command. Now the location is displayed correctly and works properly.

Fixed the region restore system, it will no longer trigger if the dungeon was not installed due to an error.