pvpOption - Добровольный PvP на сервере

pvpOption - серверный мод для Майнкрафт, который превращает PvP из выключателя "вкл/выкл для всех" в персональный флаг для каждого игрока. Ты наносишь и получаешь урон от других игроков только если сам выбрал PvP - и только против тех, кто тоже его включил. Все остальные остаются в полной безопасности.

Зайдёт для смешанных выживач-серверов, где строители, исследователи и PvP-игроки сидят рядом. Больше никаких случайных ударов по своим, никаких "я не хотел замахнуться", никакого ганка, когда ты просто строил дом.

Что нового и почему это важно

• Один jar под все версии Minecraft 26.x - 26.1, 26.1.1, 26.1.2, 26.2 и 26.3 (загрузчик один и тот же).
• Для ветки Minecraft 1.21.x актуальна версия 1.5.3 - она покрывает 1.21.1-1.21.10 и 1.21.11.
• Интеграция с expRepair: пока флаг PvP активен, ремонт предметов за опыт можно отключить - не получится подлатать броню прямо посреди дуэли.

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

Основная механика простая, но продумана до мелочей:

• Одна команда для включения. /pvp переводит твой флаг в активное состояние. Сначала идёт короткий прогрев (по умолчанию 5 секунд) - это грейс-период, чтобы никто не напал на тебя в ту же секунду. После отсчёта флаг становится живым.
• Обе стороны должны согласиться. Удар проходит только когда и атакующий, и защитник помечены флагом. Махнёшь по игроку без флага - удар отменится, а тебе придёт сообщение с причиной.
• Боевой кулдаун держит бой честным. Каждый валидный удар запускает боевой таймер на обоих. Нельзя снять флаг и убежать в безопасность посреди драки - ты заперт, пока таймер не истечёт (по умолчанию 30 секунд).
• Авто-снятие флага (опционально). Админ может настроить тихое снятие флага после определённого времени бездействия, чтобы забывчивые игроки не гуляли с активным PvP вечно.
• HUD на action bar. Текущее состояние всегда перед глазами: отсчёт прогрева, ⚔ PvP Active и остаток боевого кулдауна.
• Серверные уведомления (опционально). Когда игрок входит или выходит из PvP-режима, сервер об этом сообщит - все знают, кто сейчас "в игре".
• Полный админ-контроль. Включение и выключение системы целиком, настройка прогрева / кулдауна / авто-снятия на лету, принудительная установка флага и блокировка нарушителей от PvP вообще.
• Состояние хранится по UUID. Флаги и админ-блокировки выживают перезапуски. Никаких новых блоков, предметов и никаких клиентских модов не нужно.

Команды

Корневая команда - /pvpoption, короткий алиас - /pvp. Запуск без аргументов переключает твой собственный флаг.

Команды для игроков

Команда	Что делает
/pvp	Переключить свой флаг PvP вкл/выкл.
/pvp on	Включить PvP - начинается прогрев, затем флаг активируется.
/pvp off	Выключить PvP - отменяет незавершённый прогрев или снимает флаг (блокируется во время боевого кулдауна).
/pvp status	Показать состояние своего флага и остаток боевого кулдауна.
/pvp list	Список всех игроков с активным флагом PvP (и тех, кто сейчас в бою).

Админ-команды

Все админ-подкоманды живут под /pvp admin ... и требуют прав оператора / game-master (уровень 2+).

Команда	Что делает
/pvp admin	Показать текущие настройки.
/pvp admin enable | disable	Включить или выключить всю PvP-систему на сервере.
/pvp admin warmup [секунды]	Показать или задать прогрев в секундах (0 = мгновенно).
/pvp admin cooldown [секунды]	Показать или задать боевой кулдаун в секундах (0 = отключён).
/pvp admin autoUnflag [минуты]	Показать или задать время авто-снятия флага по бездействию (0 = отключено).
/pvp admin broadcast on | off	Переключить уведомления о входе/выходе из PvP-режима.
/pvp admin disableRepair on | off	Переключить подавление ремонта expRepair для игроков с флагом.
/pvp admin reload [silent]	Перезагрузить конфиг с диска (silent - сообщит только тебе).
/pvp admin set <player> on | off	Принудительно установить флаг игрока.
/pvp admin status <player>	Посмотреть флаг, кулдаун и состояние блокировки другого игрока.
/pvp admin lock <player>	Снять флаг и запретить игроку включать PvP.
/pvp admin unlock <player>	Снять запрет и вернуть игроку доступ к PvP.

Настройка

Конфиг лежит в config/pvpoption.json и создаётся со стандартными значениями при первом запуске. Каждое значение можно менять на лету через /pvp admin ..., а /pvp admin reload перечитывает файл без перезапуска сервера. Персональные флаги и блокировки хранятся отдельно в config/pvpoption/playerdata.json.

| Ключ | По умолчанию | Что делает | |:--|:--| | pvpEnabled | true | Главный переключатель всей системы (также синхронизирует pvp= в server.properties). | | disableRepairInPvP | false | Подавляет ремонт за опыт expRepair, пока игрок с флагом (нужен expRepair 1.7+). | | cooldownSeconds | 30 | Боевой кулдаун после валидного удара; нельзя снять флаг, пока не истечёт (0 = отключён). | | warmupSeconds | 5 | Отсчёт грейс-периода перед тем, как /pvp on действительно активирует флаг (0 = мгновенно). | | broadcastToggle | true | Уведомлять, когда игрок входит или выходит из PvP-режима. | | autoUnflagMinutes | 0 | Авто-снятие флага после стольких минут бездействия (0 = никогда). |

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

Если установлен expRepair (1.7+), pvpOption регистрирует хук подавления ремонта. С включённым disableRepairInPvP любой игрок с активным флагом PvP не может ремонтировать вещи за опыт - так что не получится подлатать снаряжение прямо в дуэли. Хук подключается только когда expRepair реально присутствует; без него команда disableRepair просто сообщит, что expRepair не установлен.

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

Загрузчики	Fabric и NeoForge - один jar
Minecraft	26.1 - 26.3 - один jar, v1.5.5 · 1.21.11 и 1.21.1 - 1.21.10 - v1.5.3
Fabric API	Нужен на Fabric · не нужен на NeoForge
Сторона	Серверная - ванильные клиенты поддерживаются, одиночная игра тоже
Дополнительные библиотеки	Нет

---

Если поднимаешь сервер на BungeeHost, плагин ставится в один клик и сразу готов к работе. Для мультиплеера с друзьями - самое то: никто случайно не ударит своего, а те, кто хочет честную дуэль, просто включат флаг.

Скачать pvpOption для Майнкрафт 26.x или 1.21.x можно под Fabric и NeoForge - один файл, без клиентских модов и лишних библиотек.