MSRdungeons

MSRdungeons позволяет создавать и управлять многоразовыми подземельями с системой волн, интеграцией MythicMobs и автоматическим сбросом состояния.

MSRdungeons предназначен для создания интерактивных подземелий на серверах Paper и Purpur. Плагин реализует цикл жизни подземелья, систему волн из MythicMobs, правила участия для команд и автоматическое восстановление области после завершения прохождения.

Плагин управляет состояниями подземелья: IDLE, WAITING, ACTIVE, COMPLETED, FAILED, RESETTING и COOLDOWN. В зависимости от режима работы области, правила взаимодействия меняются.

Во время активного прохождения (WAITING или ACTIVE) игроки могут использовать стандартные механики выживания: строить, использовать предметы и взаимодействовать с блоками. В остальное время строительство и взаимодействия в зоне подземелья заблокированы, при этом PvP остается разрешенным.

Система включает окно входа, в течение которого игроки собираются перед началом. После завершения таймера участники блокируются. Мобы из MythicMobs отслеживаются по UUID, а боссы могут быть включены в общую систему волн.

Плагин поддерживает строгие правила для участников: только те, кто вошел в окно доступа, могут наносить урон мобам подземелья. Если участник покинет активную область во время боя, прохождение будет провалено. Отключение от сервера в процессе боя приравнивается к смерти персонажа.

Доступны два режима сложности:

• EASY: при смерти игрока он просто удаляется из группы, остальные продолжают прохождение.
• HARDCORE: смерть одного участника приводит к немедленному провалу всей команды.

Прохождение может быть ограничено временем (timeLimitSeconds). При успешном завершении игроки получают награды в виде команд (с поддержкой плейсхолдера %player%) и токенов, которые сохраняются в players.yml.

После завершения или провала подземелья плагин выполняет полный цикл сброса:

1. Телепортация участников в безопасную зону.
2. Удаление оставшихся отслеживаемых мобов.
3. Восстановление области из схемы.
4. Очистка состояния работы.
5. Активация таймера отката (cooldown).

Для корректного восстановления области из схемы (schematic restore) необходимо предварительно установить плагины WorldEdit или FAWE.

/msrdungeons reload
/msrdungeons start <id>
/msrdungeons stop <id>
/msrdungeons reset <id>
/msrdungeons cooldown <id>
/msrdungeons info <id>
/msrdungeons tokens [player]

Доступны сокращенные псевдонимы: /msrd и /msrdungeon.

Список необходимых прав доступа (permissions):

• msrdungeons.admin.reload
• msrdungeons.admin.start
• msrdungeons.admin.stop
• msrdungeons.admin.reset
• msrdungeons.admin.cooldown
• msrdungeons.admin.info
• msrdungeons.tokens

Основной файл config.yml содержит структуру подземелий. Каждый объект описывает уникальные параметры прохождения:

Для настройки волн используется числовой порядок ключей (1, 2, 3...). Каждая волна определяет задержку (delaySeconds) и список мобов с указанием количества и точек спавна.

Рекомендуется использовать spawnPoints (список названных координат) для распределения мобов по принципу round-robin. Старый формат одиночной точки spawnPoint также поддерживается.

• Обычное публичное подземелье: tier: EASY, окно входа 45-90 сек, лимит времени 900+ сек, до 10 игроков.
• Отрядное испытание: tier: EASY, окно входа 20-40 сек, лимит времени 480-720 сек, 3-5 игроков, сильные элиты во 2-й и последующих волнах.
• Хардкорный рейд: tier: HARDCORE, окно входа 15-30 сек, лимит времени 300-480 сек, 4-6 игроков, малый счет мобов с высоким уроном.

При выполнении команды /msrdungeons start <id> плагин сначала выполняет восстановление схемы перед открытием окна входа.

Если участник покидает регион подземелья во время боя, прохождение проваливается мгновенно. При истечении лимита времени, если враги еще живы, прохождение также считается проваленным.

Частые ошибки: проверьте соответствие ID мобов в конфиге и файлах MythicMobs, убедитесь, что ID региона в WorldGuard совпадает символ в символ, и не забудьте положить файлы схем в папку plugins/MSRDungeons/schematics/.