ProceduralDungeon

ProceduralDungeon - это серверный плагин для Minecraft на базе Bukkit, который собирает подземелья процедурно из заранее заготовленных комнат. Проще говоря, вы строите комнаты один раз, а плагин сам компонует из них связную последовательность помещений с настраиваемыми вероятностями. Такой подход снимает боль ручной постройки десятков вариаций одного и того же данжа: игроки каждый раз проходят новую цепочку, а вы экономите часы на маппинге.

Заметная штука: проект часто берут не как готовую систему приключений, а как библиотеку. Автор прямо пишет, что плагин лучше всего интегрируется как аддон к вашему скрипту или плагину генерации комнат. Это не полноценная roguelike-система с готовыми тематическими данжами, а именно инструмент генерации. По тегам на Modrinth он относится к Adventure, Utility, World Generation и Library Management - ещё одно подтверждение, что тут упор на механику, а не на контент. Если вы привыкли к готовым авантюрам вроде тех, что пихают в сборки с готовыми модами на подземелья, будьте готовы: тут придётся сначала сделать комнаты самому.

Как это работает

Вы регистрируете комнаты в датапак-подобном виде, задаёте для каждой вероятность выпадения и решаете, можно ли переиспользовать помещение внутри забега. При генерации плагин строит их в линию - буквально коридор из комнат по порядку. Лабиринты на данный момент не поддерживаются, это в планах. То есть ждать от ProceduralDungeon ветвящихся пещерных хорроров не стоит, пока что это прямые цепочки.

Есть важный нюанс для админов серверов: для работы обязательно нужен WorldEdit или FastAsyncWorldEdit. Без него плагин просто не поставится. И ещё - после установки нужен перезапуск сервера, а не /reload. Многие на этом спотыкаются и потом думают, что плагин сломан.

Возможности

• Неограниченное число комнат - лимит в 36 комнат, который был раньше, сняли в версии 1.1.0
• Одна комната может генерироваться вплоть до 64 раз - это теоретический максимум плагина
• Настраиваемые шансы генерации для каждой комнаты
• Можно запретить или разрешить переиспользование комнат внутри одного подземелья
• Генерация запускается игроком или из консоли (для консоли параметры не настраиваются)
• Командная конфигурация подземелья или комнаты
• GUI обновляется без перезагрузки сервера

Права и команды

• proceduraldungeon.dungeon - команды /dungeon и /dungeon help
• proceduraldungeon.admin.reload - перезагрузка конфига и данжей через /dungeon reload
• proceduraldungeon.admin.create - создать или импортировать подземелье: /dungeon create {folder}
• proceduraldungeon.admin.remove - убрать данж из конфига, файлы остаются: /dungeon remove {dungeon}
• proceduraldungeon.admin.delete - удалить данж вместе с файлами: /dungeon delete {dungeon}
• proceduraldungeon.admin.addroom - создать комнату: сначала /dungeon setexit, потом /dungeon addroom {dungeon} (customname)
• proceduraldungeon.admin.generate - сгенерировать данж по координатам: /dungeon generate {dungeon} {x} {y} {z} (world)
• proceduraldungeon.admin.edit - настроить свойства данжа или комнаты: /dungeon edit {dungeon} (roomnumber)
• proceduraldungeon.admin.edit.deleteroom - удалить комнату из данжа (через GUI)
• proceduraldungeon.admin.list - список импортированных и доступных для импорта данжей: /dungeon list

Фигурные скобки {} - обязательные аргументы, круглые () - опциональные. folder - имя папки данжа, dungeon - имя импортированного данжа, customname - своё имя комнаты, roomnumber - идентификатор комнаты (обновляется автоматически), x, y, z - координаты появления данжа (можно ~ для позиции игрока), world - мир для генерации.

Установка

1. Убедитесь, что на сервере свежая версия игры.
2. Закиньте последнюю версию плагина в папку /plugins.
3. Проверьте, что стоит WorldEdit или FastAsyncWorldEdit.
4. Перезапустите сервер, не /reload.

Совместимость и версии

Актуальная версия ProceduralDungeon - 1.1.1, вышла 4 августа 2025 года. Заявлена совместимость с Minecraft Java 1.18-1.21.8 и ядром Bukkit, а значит работает на Paper, Purpur и Spigot. В 1.1.1 починили баг с "призрачными блоками" - после генерации могли оставаться фрагменты старого мира. В 1.1.0 переработали GUI, добавили редактирование комнаты по номеру, обновили TeamEdit и подтянули производительность. Если вы сидите на старых сборках 1.16-1.17, тут не прокатит - ставьте что-то под вашу версию.

Что в планах

• Реализация для Skript
• Генерация комнат-лабиринтов, а не линия
• Финальная комната со случайными наградами
• Автоматическая генерация
• Поддержка MythicMobs

Пункт про MythicMobs особенно интересен, если вы делаете PvE-контент с кастомными боссами. Пока что прямой поддержки нет, но когда-то будет.

Важный нюанс

Плагин серверный, игрокам на клиент ставить ничего не нужно. Всё работает на стороне сервера через команды и GUI. Это удобно для публичных серверов: не заставляете людей что-то докачивать.

Если вы поднимаете свой сервер и хотите, чтобы ProceduralDungeon заработал сразу - учитывайте, что ядро и WorldEdit должны стоять корректно. На BungeeHost плагин встаёт без плясок с бубном, комнаты регистрируются, генерация запускается как из консоли, так и игроком. Для тестов хватит и бесплатного тарифа, а для публичного релиза лучше сразу брать что-то посерьёзнее по оперативке - генерация ест ресурсы, особенно если комнат много.

Практический совет

Начните с 3-4 простых комнат и одной связки, чтобы понять логику /dungeon setexit и /dungeon addroom. Многие новички пропускают setexit и потом удивляются, почему часть не генерируется. И да - сохраняйте свои комнаты в отдельные папки с понятными названиями, иначе через месяц сами запутаетесь в структуре. Плагин рассчитан на тех, кто готов сам строить контент и потом наслаждаться автоматической сборкой. Если же вам нужны готовые данжи из коробки - это не сюда, тут вы получаете движок, а не приключение.}

Кому подойдёт

ProceduralDungeon - это в первую очередь инструмент для админов и разработчиков, которые хотят автоматизировать генерацию подземелий на своём сервере. RPG-серверы, выживание с квестами, шутеры с волнами - везде, где нужны повторяемые локации с рандомной компоновкой. Скачать ProceduralDungeon и настроить его под свою механику вполне реально за вечер, если понимать базу WorldEdit.