Настройка ResurrectionChest

Первый запуск

Пока настройка не завершена, ResurrectionChest отправляет напоминание о первом запуске через десять секунд после каждого входа администратора с правом resurrectionchest.*. Это сообщение подтверждает, что плагин готов к использованию, указывает на /resurrectionchest setup и напоминает, как зарегистрировать сундук: поставить его и прикрепить табличку с текстом [DeathChest] или со значением Input name for death chest.

ResurrectionChest работает «из коробки» с ванильными сундуками, поэтому здесь нет ничего, что вы обязаны делать. Напоминание перестаёт появляться, как только setupDone становится true в config.yml. Открытие /resurrectionchest setup автоматически переключает setupDone в true, что навсегда убирает это сообщение.

/resurrectionchest initialize открывает пошаговую настройку. Варианты «Рекомендуемая настройка», «Ручная настройка» и «Использовать текущий контент» отмечают настройку как завершённую. Ванильные сундуки смерти работают без загрузки паков.

Меню настройки

/resurrectionchest setup

Открывает меню настройки Nightbreak. Оттуда администраторы могут:

• просматривать все паки контента ResurrectionChest (Wooden Chest, Angelic Chest)
• устанавливать или удалять паки (это перемещает файлы моделей между папками models и models_disabled плагина FreeMinecraftModels)
• фильтровать паки по Free или Premium
• проверять и загружать обновление плагина через пункт Plugin Update
• загружать или обновлять все паки сразу через пункт загрузки всего, который выполняет за вас /resurrectionchest downloadall
• открывать список Recommended Plugins (тот же вид, что и /resurrectionchest recommendedplugins)
• включать или выключать Automatic Updates (настройка nightbreak.autoDownloadPluginUpdates — см. Конфигурация и разрешения)
• читать инструкции по установке и открывать соответствующие ссылки Nightbreak через кнопку информации

При установке или удалении пака ResurrectionChest автоматически перезагружает FreeMinecraftModels, чтобы модели сундуков обновились.

/resurrectionchest downloadall загружает обновление плагина (если есть) и все доступные паки контента ResurrectionChest с Nightbreak за один раз (требуется привязанный аккаунт Nightbreak). /resurrectionchest downloadallcontent загружает только паки контента, а /resurrectionchest updatecontent (псевдоним updateallcontent) повторно загружает только устаревшие паки контента.

Если файлы пака оказались повреждены или удалены, а номер версии по-прежнему считается актуальным, /resurrectionchest forcereinstallcontent <package|all> загрузит его заново в любом случае. Аргумент пакета автодополняется значениями all, wooden-chest и angelic-chest; используйте all, чтобы переустановить все уже загруженные паки, или укажите слаг напрямую, если файлы пака пропали полностью.

Ручной импорт

Загрузки попадают в эту папку, и туда же можно вручную положить пакеты:

plugins/ResurrectionChest/imports

Оставляйте архивы пакетов нетронутыми. ResurrectionChest распаковывает папку при запуске, направляет файлы моделей в FreeMinecraftModels и автоматически обновляет FreeMinecraftModels, когда модели были установлены. Смотрите общее руководство: Ручной импорт против управления в игре.

Регистрация сундука

1. Установите сундук.
2. Установите настенную табличку, прикреплённую к этому сундуку.
3. Напишите настроенный текст-триггер на строке 1 или строке 2 таблички. Регистр букв не важен.

Текст-триггер по умолчанию:

[DeathChest]

Когда табличка принята, ResurrectionChest:

• перезаписывает табличку (строка 1 очищается, строка 2 показывает текст-триггер фиолетовым цветом, строка 3 показывает отображаемое имя игрока, строка 4 очищается)
• сохраняет этот сундук для игрока
• удаляет предыдущую запись зарегистрированного сундука игрока, если она уже была, включая удаление старой таблички настройки (сам старый блок сундука и его содержимое остаются нетронутыми)
• помечает блоки сундука и таблички маркером владения на следующий тик, чтобы плагин впоследствии мог отличить собственные блоки от похожих

Если другой плагин отменяет установку таблички, новая регистрация не сохраняется, а прежний сундук остаётся зарегистрированным. Разрушение сундука или таблички удаляет регистрацию только после фактического разрушения блока. Отменённое разрушение её не удаляет.

Процесса регистрации сундука через команды не существует.

Правила настройки

• Игроку нужно resurrectionchest.use.
• Настройка заблокирована в мирах из чёрного списка.
• Принятая табличка должна быть настенной табличкой, прикреплённой к сундуку.
• Любой материал настенной таблички работает, потому что код проверяет типы блоков настенных табличек, а не конкретный материал таблички.
• Блок за табличкой должен быть обычным сундуком. Сундуки-ловушки, бочки и другие контейнеры отклоняются.
• Сундук не должен быть уже зарегистрирован на другого игрока. Если это так (учитывается любая половина двойного сундука), табличка остаётся обычным текстом, а игроку сообщается, что сундук принадлежит кому-то другому.
• Игроку должно быть разрешено строить в месте установки сундука. ResurrectionChest использует общий механизм запросов WorldGuard / GriefPrevention из MagmaCore и сведения о защите от провайдеров владения локациями. Отказ блокирует регистрацию и выводит Chest protected region message. Без провайдеров защиты или владения дополнительных ограничений нет — см. Конфигурация и разрешения.

Одинарные и двойные сундуки

• Обычный одинарный сундук работает сразу.
• Если зарегистрированный сундук позже становится частью двойного сундука, ResurrectionChest обнаруживает изменение через один тик после установки блока, помечает вновь присоединённую половину (и любые таблички на ней) и заменяет модель на модель двойного сундука.
• Если вновь присоединённая половина уже принадлежит регистрации другого игрока, вся регистрация отбрасывается, а не поглощает сундук другого игрока.
• Предметы смерти могут заполнять обе стороны инвентаря двойного сундука, все 54 слота.
• Двойной сундук может пересекать границу чанка. Сервер объединяет две половины в пару, только пока загружены оба чанка, поэтому, когда владелец умирает далеко, ResurrectionChest загружает чанк с другой половиной, прежде чем проверить владение и переместить предметы. Он загружает этот чанк обычным образом и не удерживает его принудительно загруженным. Если половины всё равно не объединяются в пару, консоль записывает предупреждение с именем игрока и местоположением сундука, а предметы получает только зарегистрированная половина.
• При настройках безопасности по умолчанию каждая половина сундука на момент смерти должна сохранять маркер владения этого игрока. Если одна из половин была подменена в обход плагина, сундук считается отсутствующим.

Поведение при удалении

Разрушение любого из следующего удаляет регистрацию:

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

При удалении регистрации любым способом — разрушением сундука, таблички или взаимодействием с моделью FreeMinecraftModels — плагин также удаляет прикреплённые настенные таблички, прошедшие проверку владения. Эти таблички исчезают, а не выпадают в виде предметов.

Регистрация также автоматически отбрасывается, когда плагин больше не может доказать, что блоки принадлежат ему: если какая-либо половина сундука в сохранённой позиции потеряла маркер владения или несёт чужой, регистрация отбрасывается при следующем запуске, загрузке чанка или обновлении моделей, а в консоль записывается предупреждение с UUID владельца и координатами сундука. Сам блок сундука остаётся на месте. Маркеры табличек проверяются повторно только тогда, когда плагин заново помечает свои блоки — при присоединении половины двойного сундука и при переносе более старой регистрации на текущие маркеры владения. Установите Enable high compatibility / low security mode for plugin conflicts в true, если другой плагин на вашем сервере стирает эти данные блока — см. Конфигурация и разрешения.

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

Если активна пользовательская модель сундука, левый клик по модели также удаляет регистрацию (это может сделать только владелец сундука — см. Конфигурация и разрешения).

Администраторы могут стереть все зарегистрированные сундуки сразу с помощью /resurrectionchest clear. Для каждого отслеживаемого сундука он выбрасывает инвентарь сундука на землю, затем удаляет сундук и любые прикреплённые таблички настройки и очищает сохранённую регистрацию.

Очистка соблюдает настроенные проверки владения. Блоки, не прошедшие их, остаются нетронутыми. Если мир сундука выгружен, удаляется только регистрация; блоки в этом мире остаются.

Предупреждение о защите

ResurrectionChest не является плагином защиты.

• Он не останавливает других игроков от открытия физического сундука.
• Он не останавливает других игроков от разрушения физического сундука или таблички, если настройки защиты вашего сервера это позволяют.

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

Устранение неполадок

• Предметы не попадают в сундук. Проверьте, что у игрока есть resurrectionchest.use, что на табличке использован настроенный текст-триггер и что сундук всё ещё существует и зарегистрирован на этого игрока (его разрушение снимает регистрацию). Смерти в мире из списка blacklistedWorlds или при включённом keepInventory плагин не затрагивает.
• Пользовательская модель сундука не отображается. Модель выбирается при регистрации сундука. Если FreeMinecraftModels или пак моделей были установлены позже либо изменилось право игрока на модель, разрушьте сундук и зарегистрируйте его заново. См. Интеграция с FreeMinecraftModels.
• Перед выполнением /resurrectionchest clear сделайте резервную копию playerData.yml и всего содержимого сундуков, которое хотите сохранить. Команда высыпает содержимое каждого зарегистрированного сундука на землю и удаляет сами сундуки и их таблички.

Когда просите о помощи, укажите версии ResurrectionChest и сервера, ваш config.yml, шаги, воспроизводящие проблему, и полный журнал сервера. /logify загружает журнал и возвращает ссылку.