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

Разрешения

Разрешение	Назначение	По умолчанию
resurrectionchest.*	Предоставляет администраторам доступ к командам setup, content, update, reload и clear	op
resurrectionchest.setup	Предоставляет администраторам доступ к командам /resurrectionchest setup, recommendedplugins, downloadallcontent и updatecontent	op
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 recommendedplugins	resurrectionchest.setup	Открывает (или, для консоли, выводит списком) рекомендуемые сопутствующие плагины для ResurrectionChest
/resurrectionchest downloadall	resurrectionchest.*	Загружает обновление плагина (если есть) и все доступные паки контента с Nightbreak
/resurrectionchest downloadallcontent	resurrectionchest.setup	Загружает все доступные паки контента с Nightbreak
/resurrectionchest updatecontent (псевдоним updateallcontent)	resurrectionchest.setup	Повторно загружает только устаревшие установленные паки контента
/resurrectionchest downloadpluginupdate	resurrectionchest.*	Загружает обновление плагина ResurrectionChest, если оно доступно
/resurrectionchest reload	resurrectionchest.*	Перезагружает ResurrectionChest
/resurrectionchest clear	resurrectionchest.*	Очищает все отслеживаемые блоки ResurrectionChest; выбрасывает инвентарь каждого отслеживаемого сундука и удаляет блоки сундука и таблички

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

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

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

Ключ конфигурации	Тип	По умолчанию
setupDone	boolean	false
nightbreak.autoDownloadPluginUpdates	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

Автоматические обновления плагина и контента

nightbreak.autoDownloadPluginUpdates — это общая настройка Nightbreak/MagmaCore, которая поставляется внутри ResurrectionChest. По умолчанию она имеет значение false.

• Когда значение false (по умолчанию), ничего не загружается автоматически. ResurrectionChest всё равно проверяет наличие обновления плагина при запуске (и примерно раз в час), чтобы внутриигровая кнопка обновления могла показать результат, но любую фактическую загрузку вы запускаете сами.
• Когда значение true, ResurrectionChest загружает доступное обновление плагина и устаревшие паки контента при запуске. Загруженные обновления плагина и контента используются только после перезапуска сервера.
• Автоматическая загрузка плагина требует действительного токена аккаунта Nightbreak и активного членства сторонника.

Вы можете изменить эту настройку в игре через переключатель Automatic Updates на панели инструментов внутри /resurrectionchest setup или отредактировать config.yml напрямую.

Меню настройки также предоставляет пункт Plugin Update (показывает установленную/доступную версию и загружает обновление по клику) и пункт Recommended Plugins (тот же список, что и /resurrectionchest recommendedplugins).

Обработка 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
• freeSingleDeathChestModelName
• freeDoubleDeathChestModelName и premiumDoubleDeathChestModelName (плагин внутри жёстко зашивает префиксы имён моделей resurrectionchest_free и resurrectionchest_angelic, а затем добавляет _single или _double в зависимости от размера сундука, поэтому ключи конфигурации с "Double" в настоящее время не влияют на визуальные эффекты сундука)

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