Конфигурация и Разрешения ResurrectionChest

Разрешения

Разрешение	Назначение	По умолчанию
resurrectionchest.*	Предоставляет администраторам доступ к командам setup, initialize, downloadall, updatecontent и reload	op
resurrectionchest.setup	Предоставляет администраторам доступ к команде /resurrectionchest setup	op
resurrectionchest.initialize	Предоставляет администраторам доступ к команде /resurrectionchest initialize	op
resurrectionchest.use	Позволяет игроку зарегистрировать сундук и направлять в него выпавшие при смерти предметы	true
resurrectionchest.model.free	Позволяет игроку использовать бесплатные визуальные модели сундука FreeMinecraftModels (Wooden Chest)	true
resurrectionchest.model.premium	Позволяет игроку использовать премиум визуальные модели сундука FreeMinecraftModels (Angelic Chest)	op

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

Команды

Команда	Разрешение	Назначение
/resurrectionchest	resurrectionchest.*	Выводит краткое информационное сообщение со ссылкой на процесс настройки
/resurrectionchest setup	resurrectionchest.setup	Открывает меню настройки контента (просмотр и переключение паков сундуков)
/resurrectionchest initialize	resurrectionchest.initialize	Открывает меню первоначальной настройки
/resurrectionchest downloadall	resurrectionchest.setup	Загружает все доступные паки с Nightbreak
/resurrectionchest updatecontent (псевдоним updateall)	resurrectionchest.setup	Повторно загружает только устаревшие установленные паки
/resurrectionchest reload	resurrectionchest.*	Перезагружает ResurrectionChest

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

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

Ключ конфигурации	Тип	По умолчанию
setupDone	boolean	false
Input name for death chest	string	[DeathChest]
Enable high compatibility / low security mode for plugin conflicts	boolean	false
Lower worn armor's durability on death	boolean	true
Amount of durability to lower on death	int	100
Chest creation message	string	&8[ResurrectionChest] &aYou've created your Death Chest!
Chest destruction message	string	&8[ResurrectionChest] &cYour Death Chest has been destroyed!
Chest missing message	string	&8[ResurrectionChest] &4Your Death Chest is missing!
Death message	string	&8[ResurrectionChest] &aYour items have been moved to your Death Chest!
deathChestRemovedMessage	string	&8[ResurrectionChest] &cYour Death Chest has been removed!
Enable particle effects for death chests	boolean	true
Particle effect 1	string	ENCHANTMENT_TABLE
Particle effect 2	string	ENCHANTMENT_TABLE
Particle effect 3	string	PORTAL
blacklistedWorlds	list	[none]
storeXP	boolean	true
xpPercentageKept	double	0.75
deathChestNameTag	string	$playerName's &fResurrection Chest
freeSingleDeathChestModelName	string	resurrectionchest_free_single
freeDoubleDeathChestModelName	string	resurrectionchest_free_double
premiumSingleDeathChestModelName	string	resurrectionchest_angelic_single
premiumDoubleDeathChestModelName	string	resurrectionchest_angelic_double

Обработка XP

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

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

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

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

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

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

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

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

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

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

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

Когда активна пользовательская модель, игроки могут взаимодействовать с ней напрямую:

• правый клик по модели открывает инвентарь базового сундука
• присесть + левый клик по модели удаляет регистрацию (только владелец может это сделать)
• левый клик без приседания показывает жёлтое предупреждение вместо уничтожения сундука

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

Паки Контента

ResurrectionChest поставляется с двумя паками контента, которые оборачивают модели сундуков FreeMinecraftModels:

• Wooden Chest (бесплатный): предоставляет resurrectionchest_free_single / resurrectionchest_free_double. Используется через resurrectionchest.model.free.
• Angelic Chest (премиум): предоставляет resurrectionchest_angelic_single / resurrectionchest_angelic_double. Используется через resurrectionchest.model.premium.

Каждый пак находится в папке models плагина FreeMinecraftModels, когда установлен, и в models_disabled, когда удалён. Переключение их через /resurrectionchest setup перемещает файлы между этими папками и автоматически перезагружает FreeMinecraftModels.

Оговорки на основе исходного кода

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

• Enable high compatibility / low security mode for plugin conflicts
• Lower worn armor's durability on death и Amount of durability to lower on death
• Particle effect 1
• Particle effect 2
• freeDoubleDeathChestModelName и premiumDoubleDeathChestModelName (плагин внутри жёстко зашивает префиксы имён моделей resurrectionchest_free и resurrectionchest_angelic, а затем добавляет _single или _double в зависимости от размера сундука, поэтому ключи конфигурации с "Double" в настоящее время не влияют на визуальные эффекты сундука)

Напротив, Particle effect 3 — это настройка частиц с очевидным активным использованием в текущем коде (создаётся каждый тик, пока чанк сундука загружен). freeSingleDeathChestModelName и premiumSingleDeathChestModelName используются для проверки существования файла модели перед назначением премиум-префикса.