Перейти к основному содержимому

Конфигурация и права ResurrectionChest

Права

ПравоНазначениеПо умолчанию
resurrectionchest.useПозволяет игроку зарегистрировать сундук и отправлять в него дроп после смертиtrue
resurrectionchest.model.freeПозволяет игроку использовать бесплатные визуалы сундука из FreeMinecraftModelstrue
resurrectionchest.model.premiumПозволяет игроку использовать премиум-визуалы сундука из FreeMinecraftModelsop

resurrectionchest.use — главное право для фактического поведения сундука. Права моделей влияют только на необязательные визуальные эффекты.

Поверхность конфигурации

Сейчас config.yml предоставляет пользователю такие настройки:

  • текст триггера на табличке
  • сообщения о создании сундука, разрушении, отсутствии сундука, смерти и удалении
  • чёрный список миров
  • storeXP
  • xpPercentageKept
  • текст неймтега сундука смерти для визуалов FreeMinecraftModels
  • настройки имени бесплатной и премиум-модели
  • настройки эффектов частиц
  • режим высокой совместимости
  • настройки потери прочности

Обработка XP

Когда storeXP включён:

  • ResurrectionChest отслеживает текущий общий XP игрока во время игры
  • при смерти он сохраняет отслеженный общий XP * xpPercentageKept
  • выставляет выпадающий XP в 0
  • возвращает сохранённый XP, когда владелец в следующий раз откроет свой зарегистрированный сундук

Важные исключения:

  • Если активен keepInventory, ResurrectionChest ничего не делает.
  • Если активен keepLevel, ветка сохранения XP завершается раньше и оставляет стандартную обработку уровня без изменений.

Обработка переполнения

Если в сундуке нет свободного слота для предмета:

  • этот предмет остаётся в обычном списке дропа после смерти
  • игрок получает предупреждение, что сундук был заполнен

Интеграция с FreeMinecraftModels

Если установлен FreeMinecraftModels, ResurrectionChest может создавать визуальный prop-сундук поверх настоящего сундука.

Текущее поведение:

  • премиум-визуалы имеют приоритет, если у игрока есть resurrectionchest.model.premium
  • в противном случае используется бесплатный визуал, если у игрока есть resurrectionchest.model.free
  • визуальная модель переключается между одинарным и двойным вариантом в зависимости от размера сундука
  • настоящий сундук по-прежнему остаётся backend-хранилищем

Если FreeMinecraftModels отсутствует или модель не удаётся создать, базовый сундук всё равно работает нормально.

Подтверждённые исходниками оговорки

Текущий исходный код также показывает несколько записей конфигурации, которые присутствуют в config.yml, но их использование не очень ясно видно в других местах этого репозитория:

  • режим высокой совместимости
  • настройки потери прочности
  • particleEffect1
  • particleEffect2

В отличие от них, particleEffect3 — это настройка частиц с очевидным живым использованием в текущем коде.