- Поддерживаемые версии
- 1.16
- 1.17
- 1.18
- 1.19
- 1.20
- 1.21
- Ядра и Прокси
- Bukkit
- Spigot
- Paper
- Минимальная версия Java
- 17
hCaptureEvent
Гибкие ивенты захвата территорий для Minecraft-серверов
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
hCaptureEvent — это плагин для создания ивентов захвата на базе WorldGuard-регионов.
С его помощью можно создавать активные PvP-зоны, где игроки или кланы сражаются за контроль территории, получают прогресс захвата и награды за участие или победу.
Плагин отлично подойдёт для PvP-серверов, клановых проектов, survival-серверов, серверов с регулярными ивентами и проектов, которым нужна активность вокруг специальных зон.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Основные возможности
Зоны захвата на базе WorldGuard
hCaptureEvent использует WorldGuard-регионы как территории для захвата.
Вы создаёте регион через WorldGuard, указываете его в конфиге зоны, и плагин начинает отслеживать игроков внутри этой области во время активного ивента.
Каждая зона настраивается отдельным файлом:
Код:
plugins/hCaptureEvent/captures/default.yml
plugins/hCaptureEvent/captures/clan.yml
Название файла является ID зоны.
Пример:
Код:
default.yml -> default
clan.yml -> clan
Это позволяет удобно создавать и настраивать несколько разных ивентов.
────────────────────────────────────────
Несколько зон захвата
Вы можете создать столько зон, сколько нужно вашему серверу.
Для каждой зоны можно отдельно настроить:
- WorldGuard-регион
- Мир
- Время захвата
- Минимальный онлайн для запуска
- Расписание запуска
- Bossbar
- Частицы вокруг зоны
- Награды
- Действия при старте и остановке
- Действия при входе и выходе игрока
- Награды за прогресс
- Награды за итоговые места
- Клановый режим
Например, можно создать одну обычную PvP-зону для игроков, вторую зону для кланов и третью зону для особого ивента с повышенными наградами.
────────────────────────────────────────
Обычный режим захвата
В обычном режиме каждый игрок участвует индивидуально.
Когда игрок заходит в активную зону, плагин начинает считать его прогресс. Чем дольше игрок удерживает позицию внутри региона, тем больше прогресс захвата.
Плагин может отслеживать:
- Текущего лидера
- Прогресс каждого игрока
- Время захвата
- Итоговые места
- Топ игроков
- Победителя ивента
Этот режим отлично подходит для King of the Hill, PvP-ивентов и соревновательных зон.
────────────────────────────────────────
Клановый режим захвата
hCaptureEvent поддерживает клановые ивенты через hClans.
В клановом режиме игроки участвуют вместе со своим кланом, а плагин считает общий прогресс клана.
Возможности кланового режима:
- Участие только для игроков с кланом
- Подсчёт прогресса клана
- Определение лидирующего клана
- Определение победившего клана
- Выдача опыта клану
- Использование лучшего игрока победившего клана в наградах
Этот режим подойдёт для серверов с кланами, фракциями, гильдиями и командным PvP.
────────────────────────────────────────
Автоматический запуск по расписанию
Каждая зона может запускаться автоматически в указанное время.
Пример настройки:
Код:
time:
enable: true
start:
- "00:00"
- "00:30"
zone: "Europe/Moscow"
format: "HH:mm"
Можно настроить часовой пояс, формат времени и несколько точек запуска в течение дня.
Это удобно для серверов, где ивенты должны проходить регулярно без ручного запуска администрацией.
────────────────────────────────────────
Ручное управление ивентами
Администраторы могут запускать и останавливать ивенты вручную.
Можно запустить все зоны сразу или только конкретную зону.
Примеры:
Код:
/hcaptureevent start
/hcaptureevent start all
/hcaptureevent start default
/hcaptureevent stop
/hcaptureevent stop all
/hcaptureevent stop default
Это даёт администрации полный контроль над активными ивентами.
────────────────────────────────────────
Минимальный онлайн
Для каждой зоны можно указать минимальный онлайн, необходимый для запуска.
Если игроков на сервере недостаточно, ивент не начнётся, а плагин может выполнить отдельные действия из конфига.
Это помогает не запускать захваты в пустое время, когда на сервере нет достаточной конкуренции.
────────────────────────────────────────
Bossbar во время ивента
Во время активного захвата плагин может показывать bossbar с актуальной информацией.
В bossbar можно использовать данные о лидере, прогрессе, времени до конца ивента и клане.
Доступные плейсхолдеры:
Код:
{leader}
{progress}
{timeLeft}
{clan}
{clanProgress}
Можно настроить:
- Текст bossbar
- Цвет bossbar
- Стиль bossbar
- Флаги bossbar
- Миры, в которых bossbar будет отображаться
Bossbar помогает игрокам сразу видеть состояние ивента без команд и меню.
────────────────────────────────────────
Отображение зоны частицами
Зону захвата можно визуально выделить с помощью REDSTONE-частиц.
Настраивается:
- Включение или отключение отображения
- Цвет частиц
- Размер частиц
- Плотность отображения
Так игрокам проще понять, где находится активная территория захвата.
────────────────────────────────────────
Гибкая система действий
hCaptureEvent имеет систему действий, которая позволяет настраивать поведение ивента без изменения кода.
Действия могут выполняться при разных событиях:
- Старт ивента
- Остановка ивента
- Вход игрока в зону
- Выход игрока из зоны
- Получение прогресса
- Смена лидера
- Недостаточный онлайн
- Отсутствие прав
- Отсутствие клана у игрока
- Достижение определённого прогресса
- Выдача наград за итоговые места
Доступные секции действий:
Код:
actions.start
actions.stop
actions.enter
actions.exit
actions.progress
actions.leaderChange
actions.minPlayers
actions.noPermission
actions.clanNoClan
actions.seconds
actions.places
────────────────────────────────────────
Поддерживаемые типы действий
Плагин поддерживает разные типы действий для сообщений, команд, звуков, визуальных эффектов и наград.
Доступные типы:
Код:
[Message]
[Broadcast]
[Console]
[Player]
[Sound]
[Title]
[ActionBar]
[BossBar]
[Particle]
[Firework]
[Vault]
Пример:
Код:
actions:
start:
- "[Broadcast] &6Ивент захвата начался!"
- "[Sound] ENTITY_ENDER_DRAGON_GROWL"
enter:
- "[Message] &aВы вошли в зону захвата."
exit:
- "[Message] &cВы покинули зону захвата."
seconds:
15:
- "[Console] eco give {player} 2500"
- "[Sound] ENTITY_PLAYER_LEVELUP:0.2:1.0"
places:
1:
- "[Console] eco give {player} 15000"
- "[Broadcast] &e{player} победил в ивенте захвата!"
────────────────────────────────────────
Награды за прогресс
Можно выдавать награды игрокам при достижении определённого прогресса захвата.
Например, можно выдать награду за 15, 30 или 60 секунд удержания зоны.
Пример:
Код:
actions:
seconds:
15:
- "[Console] eco give {player} 1000"
30:
- "[Console] give {player} diamond 3"
Это позволяет мотивировать игроков участвовать в ивенте даже до его завершения.
────────────────────────────────────────
Награды за итоговые места
После завершения ивента можно выдать награды по местам.
Пример:
Код:
actions:
places:
1:
- "[Console] eco give {player} 15000"
2:
- "[Console] eco give {player} 10000"
3:
- "[Console] eco give {player} 5000"
Так можно награждать лучших участников и делать ивенты более соревновательными.
────────────────────────────────────────
Защита от нечестного участия
Плагин может ограничивать участие игроков, которые находятся в нечестных условиях.
Для игроков без bypass-права могут проверяться и блокироваться:
- Creative mode
- Spectator mode
- Полёт
- Essentials god mode
- Essentials vanish
Это помогает сохранить честность захвата и не допустить участия игроков с преимуществами.
Право для обхода ограничений:
Код:
hcaptureevent.bypass
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Команды
Код:
/hcaptureevent
/hcaptureevent reload
/hcaptureevent start
/hcaptureevent start all
/hcaptureevent start <zoneId>
/hcaptureevent stop
/hcaptureevent stop all
/hcaptureevent stop <zoneId>
Описание команд:
Код:
/hcaptureevent - показать меню помощи
/hcaptureevent reload - перезагрузить конфиг и зоны
/hcaptureevent start - запустить все зоны
/hcaptureevent start all - запустить все зоны
/hcaptureevent start <zoneId> - запустить конкретную зону
/hcaptureevent stop - остановить все активные зоны
/hcaptureevent stop all - остановить все активные зоны
/hcaptureevent stop <zoneId> - остановить конкретную зону
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Права
Код:
hcaptureevent.admin - доступ к административным командам
hcaptureevent.capture - разрешение участвовать в захвате
hcaptureevent.bypass - обход ограничений честного участия
Важно: выдайте право hcaptureevent.capture игрокам или группам, которые должны участвовать в захватах.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PlaceholderAPI
Если установлен PlaceholderAPI, плагин регистрирует собственные плейсхолдеры.
Формат зависит от ID зоны.
ID зоны берётся из названия файла в папке captures.
Пример:
Код:
default.yml -> default
Плейсхолдеры для зоны default:
Код:
%hcaptureevent_default_winnerPlayerName%
%hcaptureevent_default_timeForNext%
%hcaptureevent_default_captureTime%
%hcaptureevent_default_place_1%
%hcaptureevent_default_place_2%
%hcaptureevent_default_place_3%
Их можно использовать в scoreboard, tab, меню, holograms и других плагинах с поддержкой PlaceholderAPI.
────────────────────────────────────────
Список PlaceholderAPI-плейсхолдеров
Код:
%hcaptureevent_<zone>_winnerPlayerName% - текущий лидер зоны
%hcaptureevent_<zone>_timeForNext% - время до следующего запуска
%hcaptureevent_<zone>_captureTime% - прогресс текущего игрока
%hcaptureevent_<zone>_place_1% - игрок на первом месте
%hcaptureevent_<zone>_place_2% - игрок на втором месте
%hcaptureevent_<zone>_place_3% - игрок на третьем месте
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Внутренние плейсхолдеры
Эти плейсхолдеры можно использовать в сообщениях и действиях плагина:
Код:
{prefix} - префикс плагина
{player} - имя игрока
{progress} - прогресс игрока
{timeLeft} - оставшееся время ивента
{leader} - текущий лидер
{clan} - название клана
{clanProgress} - прогресс клана
{clanExp} - награда опытом клана
{place} - итоговое место игрока
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Зависимости
Обязательные:
- Java 17 или новее
- WorldGuard
- WorldEdit
Опциональные интеграции:
- PlaceholderAPI
- hClans
- EssentialsX
- Vault-экономика
Paper или Purpur рекомендуется использовать как основное серверное ядро, так как плагин использует современные компоненты для title, actionbar и bossbar.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Установка
- Установите WorldEdit и WorldGuard.
- Поместите hCaptureEvent.jar в папку plugins.
- Перезапустите сервер.
- Создайте или настройте WorldGuard-регионы для зон захвата.
- Настройте файлы зон в папке plugins/hCaptureEvent/captures/.
- Выдайте игрокам право hcaptureevent.capture.
- Запустите зону вручную или настройте автоматический запуск по расписанию.
Пример ручного запуска:
Код:
/hcaptureevent start default
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Примеры файлов зон
После установки плагин создаёт примеры конфигураций:
Код:
default.yml
clan.yml
default.yml — пример обычной зоны захвата для игроков.
clan.yml — пример клановой зоны захвата с использованием hClans.
Их можно использовать как основу для создания собственных ивентов.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Для чего можно использовать hCaptureEvent
- King of the Hill-ивенты
- PvP-зоны с наградами
- Клановые захваты
- Регулярные серверные события
- Сезонные ивенты
- Активные зоны в survival-мире
- Соревновательные арены
- Ивенты с автоматическим расписанием
hCaptureEvent не ограничивает вас одним сценарием.
Вы можете создать простую зону с наградами, полноценный клановый захват, ежедневный PvP-ивент или несколько разных зон с уникальными правилами.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Почему hCaptureEvent
hCaptureEvent даёт серверу полноценную систему захватов с гибкой настройкой через YAML.
Плагин поддерживает обычные и клановые события, автоматическое расписание, визуальное отображение зоны, bossbar, награды, PlaceholderAPI и систему действий.
Всё настраивается через конфиги, поэтому вы можете адаптировать ивенты под стиль своего сервера без изменения кода.
- Зависимости
- Обязательные - WorldGuard, WorldEdit. Необязательные - EssentialsX, PlaceholderAPI
- Команды и права
Команда Право Описание /hcaptureevent reload hcaptureevent.admin Доступ к перезагрузке конфига /hcaptureevent start hcaptureevent.admin Доступ к запуску ивента /hcaptureevent stop hcaptureevent.admin Доступ к остановке ивента