- Для версий
- 1.17.✘
- 1.18.✘
- 1.19.✘
- 1.20.✘
- 1.21.✘
- 26.✘
- Зависимости
- WorldEdit, WorldGuard
⚔ SamuraiEvent — Полная документация
Версия: 1.0.0 | Автор: PchelaDev | Discord: discord.gg/UnvXpUJTVe
Совместимость: Paper 1.17+ | Зависимости: WorldEdit, WorldGuard
📖 Описание плагина
SamuraiEvent — это ивент, в котором игроки сообща ломают главный шалкер чем больше игрок сломал — тем сильнее становятся волны стражей-мобов. По всей арене расставлены дополнительные чёрные шалкеры, которые при уничтожении дают лут и через 2 минуты респавнятся.
Постройка (схематика temple.schem) автоматически вставляется в мир при старте и убирается при завершении. Ведётся топ игроков по числу ударов, лучшие получают призы.
🔌 Зависимости
| Плагин | Тип | Назначение |
|---|---|---|
| WorldEdit | Обязательный | Вставка и удаление схематики арены |
| WorldGuard | Обязательный | Защита зоны ивента от ломания/строительства |
| PlaceholderAPI | Опциональный | Плейсхолдеры для табличек, скорбоарда и т.д. |
| Vault + Economy | Опциональный | Денежные награды топ-игрокам |
| PlayerPoints | Опциональный | Награды в очках PlayerPoints |
| DecentHolograms | Опциональный | Голограмма HP над шалкером |
| HolographicDisplays | Опциональный | Альтернатива DecentHolograms |
⚙️ Как работает ивент
- Ивент запускается вручную (/se start) или автоматически по таймеру.
- Схематика temple.schem вставляется в мир в случайном подходящем месте (или в фиксированной точке).
- На арене появляются: один красный шалкер (главный) и несколько чёрных шалкеров (дополнительные).
- Игроки ломают шалкеры голой рукой или инструментом. Блок не ломается — засчитывается ломание и восстанавливается.
- Каждые X ударов по главному шалкеру появляется волна стражей. Чем больше сломали — тем больше мобов
- Цвет главного шалкера меняется по мере убывания прочности: 🔴 → 🟡 → 🟢.
- При уничтожении главного шалкера — лут дропается, топ объявляется, постройка убирается через 5 минут.
- Чёрные шалкеры при уничтожении дропают лут и возрождаются через 2 минуты.
💬 Команды и права
Главная команда: /samuraievent | Алиасы: /se, /event, /sevt/se help — список команд
Право: samuraievent.command.help | По умолчанию: все игрокиПоказывает список команд, доступных текущему игроку (видны только те, на которые есть право).
/se start — запустить ивент
Право: samuraievent.command.start | По умолчанию: opЗапускает ивент с проверкой минимального онлайна (general.min-players из config.yml).
Если игроков меньше минимума — сообщит об ошибке и предложит /se forcestart.
/se forcestart — принудительный запуск
Право: samuraievent.command.forcestart | По умолчанию: opЗапускает ивент без проверки минимума игроков. Полезно для тестирования.
/se stop — остановить ивент
Право: samuraievent.command.stop | По умолчанию: opНемедленно завершает ивент: убирает постройку, удаляет стражей, снимает регион WG, объявляет завершение.
/se status — статус ивента
Право: samuraievent.command.status | По умолчанию: opПоказывает:
- Запущен / не запущен
- Прогресс главного шалкера (ударов сделано / всего, % выполнения, осталось)
- Количество участников
- Количество живых стражей
- Через сколько ударов следующая волна
- Координаты и мир арены
/se top — топ участников
Право: samuraievent.command.top | По умолчанию: opВыводит топ игроков текущего ивента по количеству ударов по главному шалкеру (до 5 мест с медалями)
/se tp — телепорт к ивенту
Право: samuraievent.command.tp | По умолчанию: opТелепортирует игрока к центру текущего ивента. Работает только если ивент запущен.
/se setlocation — зафиксировать точку спавна
Право: samuraievent.command.setlocation | По умолчанию: opУстанавливает текущую позицию игрока как фиксированную точку спавна ивента.
Автоматически включает spawn.fixed-location.enabled: true в config.yml и сохраняет координаты.
После этого ивент будет всегда спавниться в этой точке, а не искать случайное место.
/se additem <black|red> <шанс> — добавить предмет в лут
Право: samuraievent.command.additem | По умолчанию: opДобавляет предмет из руки игрока в таблицу лута шалкера.
- black — лут дополнительных чёрных шалкеров (rewards.extra-shulker-drop)
- red — лут главного шалкера (rewards.drop-items)
- <шанс> — число от 1 до 100 (процент выпадения)
/se clearloot <black|red> — очистить лут
Право: samuraievent.command.clearloot | По умолчанию: opПолностью очищает список лута указанного шалкера в config.yml.
/se listloot <black|red> — показать лут
Право: samuraievent.command.listloot | По умолчанию: opВыводит нумерованный список предметов в луте указанного шалкера: материал, количество, шанс выпадения.
/se info — информация о плагине
Право: samuraievent.command.info | По умолчанию: opПоказывает версию плагина, интервал автозапуска, мир ивента, статус интеграций PAPI и Vault.
/se reload — перезагрузить конфиг
Право: samuraievent.command.reload | По умолчанию: opПеречитывает config.yml без перезапуска сервера. Изменения вступают в силу немедленно.
⚠️ Не перезапускает активный ивент — только обновляет настройки для следующего.
🔐 Все права (permissions)
| Право | Описание | По умолчанию |
|---|---|---|
| samuraievent.* | Все права сразу | false |
| samuraievent.admin | Всё: управление + участие + уведомления | op |
| samuraievent.moderator | Просмотр, TP, участие, уведомления | false |
| samuraievent.use | Базовый доступ к /se | true (все) |
| samuraievent.command.help | /se help | true (все) |
| samuraievent.command.start | /se start | op |
| samuraievent.command.stop | /se stop | op |
| samuraievent.command.forcestart | /se forcestart | op |
| samuraievent.command.reload | /se reload | op |
| samuraievent.command.status | /se status | op |
| samuraievent.command.top | /se top | op |
| samuraievent.command.tp | /se tp | op |
| samuraievent.command.setlocation | /se setlocation | op |
| samuraievent.command.additem | /se additem | op |
| samuraievent.command.clearloot | /se clearloot | op |
| samuraievent.command.listloot | /se listloot | op |
| samuraievent.command.info | /se info | op |
| samuraievent.participate | Может наносить удары по шалкерам | true (все) |
| samuraievent.bypass.region | Обходит ограничения WG в зоне ивента | op |
| samuraievent.notify.start | Получает сообщение о начале ивента | true (все) |
| samuraievent.notify.end | Получает сообщение о конце ивента | true (все) |
| samuraievent.notify.wave | Получает сообщение о волне стражей | true (все) |
| samuraievent.notify.top | Получает итоговый топ | true (все) |
| samuraievent.reward.top | Может получать топ-награды | true (все) |
| samuraievent.reward.bypass | Получает награду вне зависимости от места | false |
| samuraievent.cooldown.bypass | Не попадает под кулдаун автозапуска | op |
📊 PlaceholderAPI плейсхолдеры
Требует установленный PlaceholderAPI.
| Плейсхолдер | Описание | Пример |
|---|---|---|
| %samuraievent_status% | Статус ивента | активен / неактивен |
| %samuraievent_hits% | Ударов нанесено по главному шалкеру | 127 |
| %samuraievent_remaining% | Осталось ударов | 373 |
| %samuraievent_participants% | Количество участников | 8 |
| %samuraievent_guardians% | Количество живых стражей | 31 |
| %samuraievent_my_hits% | Удары текущего игрока | 15 |
| %samuraievent_my_place% | Место игрока в топе | 3 или - |
| %samuraievent_top_1_name% | Имя игрока на 1 месте | Steve |
| %samuraievent_top_1_hits% | Удары игрока на 1 месте | 87 |
| %samuraievent_top_2_name% | Имя игрока на 2 месте | Alex |
| %samuraievent_top_2_hits% | Удары игрока на 2 месте | 54 |
| %samuraievent_top_3_name% | Имя игрока на 3 месте | Notch |
| %samuraievent_top_3_hits% | Удары игрока на 3 месте | 32 |
| %samuraievent_top_4_name% | 4 место — имя | — |
| %samuraievent_top_4_hits% | 4 место — удары | — |
| %samuraievent_top_5_name% | 5 место — имя | — |
| %samuraievent_top_5_hits% | 5 место — удары | — |
🏗️ Создание своей схематики
- Постройте арену в WorldEdit
- Выделите постройку (//wand)
- Поставьте один RED_SHULKER_BOX — это будет главный шалкер
- Поставьте несколько BLACK_SHULKER_BOX — дополнительные шалкеры
- Скопируйте: //copy
- Сохраните: //schem save temple (или любое другое имя)
- Скопируйте файл в plugins/SamuraiEvent/schematics/
- Пропишите имя файла в config.yml → spawn.schematic-file
