BlossomPVP

BlossomPVP — мод для команды /pvp

BlossomPVP — это мод для Minecraft на загрузчиках Fabric и Quilt, который добавляет серверную команду /pvp. Он позволяет администраторам сервера включать или отключать PvP для игроков с помощью команды. Мод является частью серии Blossom и требует наличия BlossomLib для установки.

Основная механика и команда /pvp

BlossomPVP — это серверный мод для Minecraft, входящий в серию Blossom, который добавляет управление состоянием PvP через консольную команду /pvp. Мод полностью работает на стороне сервера и не требует установки на клиент. Поведение команды гибко настраивается через файл конфигурации: если параметр defaultActionIsQuery установлен в true, выполнение команды без параметров возвращает текущее состояние PvP (включено/выключено), а не переключает его. В противном случае команда работает как переключатель.

Команда поддерживает несколько режимов работы:

• true — принудительно включает PvP;
• false — принудительно отключает PvP;
• query — возвращает глобальное состояние PvP;
• — возвращает состояние PvP конкретного игрока по никнейму.

Для выполнения последнего варианта требуется дополнительное право доступа blossom.pvp.query-player, в то время как базовое управление (blossom.pvp) по умолчанию разрешено всем пользователям.

Система сообщений об ошибках

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

Ключевые сообщения:

• blossom.pvp.fail.both.attacker и blossom.pvp.fail.both.defender — возникают, когда PvP отключено у обоих игроков. Первое сообщение показывает ник защищающегося, второе — атакующего.
• blossom.pvp.fail.attacker.attacker и blossom.pvp.fail.attacker.defender — отправляются, если отключено PvP только у атакующего. Аргументы соответственно указывают на защищающегося и самого атакующего.
• blossom.pvp.fail.defender.attacker и blossom.pvp.fail.defender.defender — возникают, если PvP отключено только у защищающегося. Аргументы указывают на защищающегося и атакующего.

Администраторы могут отключить вывод этих сообщений, установив соответствующие ключи в конфигурации в пустую строку ("").

Настройка конфигурации

Файл конфигурации BlossomPVP.json генерируется автоматически в папке config/BlossomMods/ после первого запуска сервера с установленным модом. Здесь можно управлять поведением команды по умолчанию и глобальным состоянием PvP.

Основные параметры:

• enabledByDefault (boolean) — определяет, будет ли PvP включено автоматически для всех игроков при старте сервера. Если установлено false, игроки не смогут атаковать друг друга, пока не включат PvP через команду.
• defaultActionIsQuery (boolean) — меняет логику команды /pvp без аргументов. При значении true команда работает как справка (выводит статус), при false — как переключатель (меняет статус).

Локализация и техническая информация

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

Технически мод представляет собой небольшой архив (около 20.8 КБ), содержащий 24 файла и использующий миксины для интеграции с игрой. Лицензия MIT позволяет свободно распространять и модифицировать код. Мод доступен для загрузки и распространения.

Автор: CodedSakura · Лицензия: MIT