Pterohost docs

Наказание за выход из боя в Minecraft: CombatLogX

CombatLogX для Minecraft: установка, настройка тега боя, наказание за выход, NPC-труп и интеграция с PvP-плагинами. Полный гайд 2026.

Кратко: CombatLogX добавляет тег боя и наказывает игроков за выход во время PvP - персонаж остаётся в игре или гибнет мгновенно. Установите плагин, настройте таймер 10-20 секунд и заблокируйте /home и /spawn в бою.

Наказание за выход из боя в Minecraft: CombatLogX

Combat logging - одна из главных проблем PvP-серверов Minecraft с 2012 года. Игрок, которого вот-вот убьют, просто закрывает клиент и теряет ноль предметов. Противник тратит время, ресурсы, потенциально рискует своей экипировкой - и не получает ничего. CombatLogX решает эту проблему радикально: после выхода из клиента персонаж либо умирает мгновенно, либо остаётся на сервере в виде управляемого NPC, которого можно добить. В 2026 году плагин поддерживает Minecraft до 1.21.x, имеет модульную архитектуру и активно обновляется под Paper API.

Pterohost - игровой хостинг для Minecraft с NVMe-дисками, DDoS-защитой и поддержкой 24/7. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг

Что такое тег боя и как он работает

Тег боя (combat tag) - временная метка, которую CombatLogX назначает игроку при получении или нанесении урона от другого игрока. Пока метка активна, игрок считается “в бою” и подпадает под все ограничения плагина.

Жизненный цикл тега:

  1. Игрок A атакует игрока B - оба получают тег боя.
  2. Таймер обратного отсчёта (по умолчанию 15 секунд) начинает тикать.
  3. Каждый новый удар сбрасывает таймер и начинает его заново.
  4. Как только прошло нужное количество секунд без урона - тег снимается.
  5. Если игрок выходит с тегом - срабатывает наказание.

Важно понимать, что тег боя обоюдный. Если вы атаковали кого-то, тег получаете тоже вы - даже если убегаете. Это исключает манипуляции вроде “я первым ударил, потом убежал и вышел”.

Помимо выхода из клиента плагин также отслеживает:

  • Переход между мирами через порталы
  • Использование /tp, /tpa, /warp и аналогичных команд
  • Выход через /quit или потерю соединения по таймауту

Установка CombatLogX на Paper/Spigot

Требования

  • Minecraft 1.16+ (рекомендуется 1.20+)
  • Paper или Spigot (на Bukkit не тестировался)
  • Java 17+ для версий плагина 11.x

Шаг 1: Скачать плагин

CombatLogX распространяется через SpigotMC. На 2026 год актуальна версия 11.x. Скачайте основной jar-файл и отдельно jar-файл аддонов (CombatLogX-Addons или Premium Addons).

# Структура папки после загрузки
plugins/
  CombatLogX.jar
  CombatLogX/
    addons/
      NPC-Addon.jar
      Notify-Addon.jar
      Kill-Addon.jar

Поместите CombatLogX.jar в папку plugins/ сервера и перезапустите. Плагин создаст конфигурационные файлы автоматически.

Шаг 2: Разместить аддоны

Аддоны кладутся в plugins/CombatLogX/addons/. После перезагрузки сервера каждый аддон создаёт свой подкаталог с настройками.

Стандартный набор аддонов:

АддонФункция
NPCСоздаёт NPC-манекен при выходе игрока
KillУбивает игрока мгновенно при выходе
NotifyУведомляет игрока о теге боя
Prevent-TotemБлокирует использование тотема бессмертия в бою
Newbie-HelperИсключает новых игроков из PvP на N минут
Region-ProtectИнтеграция с WorldGuard для зон без PvP

Выберите один из двух основных аддонов наказания: NPC или Kill. Использовать оба одновременно не нужно - они конфликтуют.

Основной конфиг: config.yml

После первого запуска откройте plugins/CombatLogX/config.yml:

CombatLogX:
  Settings:
    # Длительность тега боя в секундах
    timer: 15

    # Тегировать ли атакующего (не только жертву)
    tag-attacker: true

    # Разрешить выход в зонах без PvP без наказания
    ignore-pve-in-disabled-pvp-zones: true

    # Логировать события в консоль
    log-to-console: true

  Commands:
    # Команды, заблокированные в бою
    blocked-commands:
      enabled: true
      commands:
        - spawn
        - home
        - tp
        - tpa
        - tpahere
        - warp
        - rtp
        - back
        - enderchest
        - ec
        - workbench

    # Сообщение при попытке использовать заблокированную команду
    blocked-message: "&cВы не можете использовать эту команду во время боя!"

  Bossbar:
    # Показывать bossbar с таймером
    enabled: true
    title: "&cВы в бою! Осталось: {time} сек."
    color: RED
    style: SOLID

  Actionbar:
    enabled: false

Сохраните файл и выполните /combatlogx reload в консоли или /clx reload - сокращённый алиас.

Настройка NPC-аддона

NPC-аддон - наиболее “честный” вариант наказания. После выхода игрока сервер создаёт его копию - безмозглый манекен с той же экипировкой, здоровьем и именем. Другие игроки могут его убить.

Откройте plugins/CombatLogX/addons/NPC/config.yml:

NPC:
  Settings:
    # Тип сущности для манекена
    entity-type: PLAYER

    # Сколько секунд NPC живёт максимум (0 = вечно до убийства)
    time-until-death: 30

    # Убить NPC, если его создатель вернулся на сервер
    kill-npc-on-reconnect: false

    # Показывать здоровье создателя у NPC
    use-creator-health: true

    # NPC дропает предметы как при обычной смерти
    drop-items-on-death: true

    # NPC может двигаться (преследовать ближайшего игрока)
    can-move: false

    # Радиус, в котором NPC агрится на игроков (0 = стоит на месте)
    aggro-radius: 0

Рекомендуемые настройки для PvP-сервера:

  • time-until-death: 30 - NPC исчезает через 30 секунд, если его не убили
  • can-move: false - манекен стоит на месте, не убегает
  • drop-items-on-death: true - дроп обязателен, иначе наказание теряет смысл

Настройка Kill-аддона

Kill-аддон проще NPC: игрок просто умирает в момент выхода. Подходит для серверов, где NPC-механика кажется избыточной или конфликтует с другими плагинами.

Файл plugins/CombatLogX/addons/Kill/config.yml:

Kill:
  Settings:
    # Причина смерти в логах
    death-reason: "combat_log"

    # Сообщение в чат сервера при смерти от combat log
    broadcast-death: true
    death-message: "&e{player} &cвышел из боя и был уничтожен."

    # Задержка перед убийством (мс, 0 = мгновенно)
    kill-delay: 0

Сообщение о смерти транслируется в чат всему серверу - это публичный стыд и дополнительный социальный стимул не combat-логиться.

Уведомления: Notify-аддон

Без уведомлений игроки не будут знать, что на них висит тег. Notify-аддон отвечает за сообщения при получении тега, его снятии и при попытке выйти.

Файл plugins/CombatLogX/addons/Notify/config.yml:

Notify:
  Settings:
    # Сообщение при получении тега
    on-tag: "&cВы в бою! Не выходите {timer} секунд."

    # Сообщение при снятии тега
    on-untag: "&aВы вышли из боя."

    # Звуковой сигнал при получении тега
    sound-on-tag:
      enabled: true
      sound: ENTITY_EXPERIENCE_ORB_PICKUP
      volume: 1.0
      pitch: 0.5

    # Предупреждение при попытке выйти в бою
    warn-on-quit:
      enabled: true
      message: "&c[!] Если вы выйдете сейчас, вы умрёте!"

Блокировка команд и телепортации

Один из ключевых аспектов CombatLogX - запрет команд во время боя. Без этой настройки игроки обходят смерть через /home, /spawn или /tp.

Список команд для блокировки

Минимальный рекомендуемый набор для Paper-сервера с EssentialsX:

blocked-commands:
  commands:
    - spawn
    - home
    - sethome
    - tp
    - tpa
    - tpahere
    - tpaccept
    - tpdeny
    - warp
    - setwarp
    - rtp
    - randomteleport
    - back
    - enderchest
    - ec
    - workbench
    - wb
    - craft
    - suicide
    - kill
    - logout

Обратите внимание на /suicide и /kill - некоторые игроки намеренно используют самоубийство, чтобы телепортироваться на точку возрождения и избежать потери предметов от PvP. Блокировка этих команд закрывает лазейку.

Блокировка аддон-плагинов

Если сервер использует плагины с нестандартными командами телепортации (CMI, Essentials-X fork, MyWarp), добавьте их команды вручную. Проверьте список через:

/combatlogx help commands

Интеграция с PvP-плагинами

WorldGuard - зоны без боя

Если на сервере есть сейф-зоны (spawn, магазин, деревни), CombatLogX должен знать о них. Через аддон RegionProtect:

RegionProtect:
  WorldGuard:
    enabled: true
    # Флаги региона, в которых тег боя не ставится
    flag-name: "pvp"
    # Если флаг pvp=deny - тег не ставится
    ignore-deny: true

После настройки установите флаг в регионе spawn:

/region flag spawn pvp deny

Игроки в этой зоне не будут получать тег боя. Важно: если игрок уже вошёл в бой за пределами зоны и забежал в spawn - тег не снимается автоматически. Для этого существует отдельная настройка remove-tag-on-safe-zone: false (рекомендуется оставить false, иначе это станет новой лазейкой).

Towny и Factions

Для серверов с Towny CombatLogX поддерживает встроенную логику через конфиг:

CombatLogX:
  Settings:
    ignore-town-pvp: false
    ignore-faction-pvp: false

Если ignore-town-pvp: true, игроки внутри своего города не будут тегироваться. Для Factions-серверов обычно оставляют false.

EssentialsX

Если используете EssentialsX, убедитесь что его собственная блокировка команд в бою не конфликтует с CombatLogX. В essentials/config.yml найдите:

# EssentialsX тоже умеет блокировать команды в бою
pvp:
  enable-combat-tagging: false

Лучше отключить встроенный тег EssentialsX и делегировать всё CombatLogX - так не будет двойного тегирования.

Команды и права доступа

Основные команды

КомандаОписаниеПрава
/combatlogx или /clxБазовая команда плагина-
/clx statusПоказать текущий статус тега бояcombatlogx.status
/clx status <игрок>Статус другого игрокаcombatlogx.status.others
/clx reloadПерезагрузить конфигcombatlogx.reload
/clx tag <игрок>Вручную тегировать игрокаcombatlogx.tag
/clx untag <игрок>Снять тег с игрокаcombatlogx.untag
/clx addonsСписок активных аддоновcombatlogx.admin

Обход для администраторов

Чтобы администраторы могли выходить без смерти при тестировании:

Permissions:
  bypass:
    permission: "combatlogx.bypass"
    check-operator: true  # OP автоматически получает bypass

Назначить через LuckPerms:

/lp user <имя> permission set combatlogx.bypass true

Тонкая настройка для разных режимов

PvP-сервер или выживание с PvP

Рекомендуемые значения:

timer: 15
tag-attacker: true
blocked-commands:
  - home
  - spawn
  - tp
  - warp
  - rtp

NPC-аддон: time-until-death: 30, drop-items-on-death: true

Мини-игры (KitPvP, BedWars)

На серверах мини-игр смерть от combat log чаще решается через Kill-аддон - нет смысла в NPC, когда игра подразумевает быстрые бои:

timer: 10  # Короче, игра динамичная
Kill:
  broadcast-death: true
  death-message: "&e{player} &cпокинул поле боя."

Ролевые серверы (RPG)

На RP-серверах часто нужен мягкий режим:

timer: 20
ignore-pve-in-disabled-pvp-zones: true
Newbie-Helper:
  enabled: true
  protection-minutes: 120  # 2 часа защиты для новичков

Диагностика и типичные проблемы

Проблема: NPC не создаётся при выходе игрока. Решение: Проверьте, что NPC-аддон лежит в папке plugins/CombatLogX/addons/ и отображается в /clx addons. Убедитесь, что не включён одновременно Kill-аддон.

Проблема: Команды не блокируются. Решение: Убедитесь, что команды в конфиге записаны без слеша (home, а не /home). После изменения конфига выполните /clx reload.

Проблема: Игрок получает тег при атаке мобов. Решение: CombatLogX по умолчанию тегирует только PvP (игрок против игрока). Если тег ставится при PvE - проверьте аддон PvE-Only и параметр tag-on-pve: false в основном конфиге.

Проблема: Тег не снимается после выхода из зоны боя. Решение: Тег снимается только по таймеру, не по геолокации. Это намеренное поведение - используйте timer: 10 для более короткого окна.

Проблема: Конфликт с CMI или другим плагином управления. Решение: CMI имеет собственную систему combat log. Отключите одну из них. Рекомендуется оставить CombatLogX как специализированный инструмент, а в CMI отключить combat-log: false.

Связанные материалы

Для полноценного PvP-сервера CombatLogX работает в связке с другими плагинами. Список проверенных инструментов для управления сервером собран в обзоре лучших плагинов. Настройку прав доступа для команд /clx удобно делать через LuckPerms - базовые принципы описаны в гайде по командам EssentialsX. Параметры сервера, влияющие на PvP (pvp=true, gamemode и т.д.), рассмотрены в руководстве по server.properties.

Заключение

CombatLogX - обязательный плагин для любого сервера с активным PvP. Без него честная PvP-система невозможна: игроки будут злоупотреблять выходом при угрозе смерти. Плагин решает проблему через тег боя, блокировку телепортации и NPC-манекен или мгновенную смерть. Настройте таймер под динамику своего сервера (10-15 секунд для динамичных режимов, 15-20 для выживания), обязательно заблокируйте команды /home и /spawn в бою, и выберите аддон наказания - NPC для максимальной честности или Kill для простоты. Регулярно проверяйте обновления плагина на SpigotMC, особенно после выхода новых версий Minecraft.

Pterohost - хостинг для Minecraft с защитой от DDoS, быстрыми NVMe-дисками и живой поддержкой 24/7. Запустите PvP-сервер с CombatLogX уже сегодня. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг