DynamicKeepInv

DynamicKeepInv заменяет стандартное глобальное правило keepInventory сложной системой правил, позволяющей сохранять вещи в зависимости от контекста игры.

DynamicKeepInv предлагает администраторам серверов решение проблемы выбора между слишком простым режимом (keepInventory true) и слишком сложным (keepInventory false). Плагин позволяет найти баланс, автоматически применяя разные правила сохранения предметов в зависимости от условий игры.

Основные возможности

Плагин предоставляет несколько уровней настройки механики смерти:

• Правила по времени суток: автоматическое включение keepInventory днем и его отключение ночью с уведомлениями в виде звуков и заголовков.
• Разграничение PvP и PvE: настройка сохранения предметов и опыта в зависимости от того, убил ли игрока другой человек или моб.
• Мировые настройки: возможность задания уникальных правил для Overworld, Nether и End.
• Экономика и GUI: система оплаты за сохранение инвентаря при смерти через интерактивное меню.
• Интеграция с защитой земель: поддержка плагинов Lands и GriefPrevention для сохранения вещей на территории игрока.
• Поддержка Folia: полная потокобезопасная работа с регионами.

Иерархия логики обработки смерти

При смерти игрока плагин определяет судьбу инвентаря, следуя приоритетному порядку (от высшего к низшему):

• Право доступа bypass (dynamickeepinv.bypass): если есть, инвентарь всегда сохраняется.
• Защита территорий (Lands / GriefPrevention): проверка нахождения игрока в своей зоне.
• Причина смерти (PvP / PvE): правила зависят от того, совершил ли убийство игрок.
• Настройки дикой природы: правила для территорий без защиты.
• Правила по времени: если вышестоящие условия не сработали, проверяется цикл день/ночь.

Экономическая система и статистика

Для платных функций требуется наличие Vault и плагина на экономику. При смерти игроку открывается GUI с выбором: оплатить сохранение или сбросить вещи. Если игрок выходит с сервера во время ожидания решения, данные сохраняются в базе данных и GUI открывается снова при входе.

Плагин ведет историю смертей и предоставляет подробную статистику через команду /dki stats. Доступные данные включают общее количество смертей, количество спасенных и потерянных инвентарей, затраты на сохранение и разбивку по причинам смерти.

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

Основные команды управления и взаимодействия:

Дополнительные права доступа:

• dynamickeepinv.bypass: игрок всегда сохраняет инвентарь.
• dynamickeepinv.stats.others: просмотр статистики других игроков.

Конфигурация и примеры

Пример настройки продвинутого режима экономики в config.yml:

advanced:
  enabled: true
  
  # Economy Settings
  economy:
    enabled: true
    cost: 100.0
    mode: "gui" # Options: charge-to-keep, charge-to-bypass, gui
    gui:
      timeout: 30 # Seconds to decide
      expire-time: 300 # Seconds to save data on disconnect

  # Death Cause Rules
  death-cause:
    enabled: true
    pvp:
      keep-items: false
      keep-xp: false
    pve:
      keep-items: true
      keep-xp: true

Интеграции и плейсхолдеры

Плагин поддерживает интеграцию с GravesX и AxGraves: если игрок выбирает сброс вещей или не может заплатить, предметы помещаются в могилу вместо разбрасывания по земле.

Для отображения данных на Scoreboard или в чате требуется PlaceholderAPI. Доступные переменные:

• %dynamickeepinv_isday% — true/false
• %dynamickeepinv_period% — Day/Night
• %dynamickeepinv_stats_save_rate% — процент сохранения игроком
• %dynamickeepinv_economy_cost% — текущая стоимость сохранения

Для работы функции оплаты и GUI необходимо установить Vault и любой плагин на экономику.