Настройка ResurrectionChest

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

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

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

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

/resurrectionchest setup

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

• просматривать все паки контента ResurrectionChest (Wooden Chest, Angelic Chest)
• устанавливать или удалять паки (это перемещает файлы моделей между папками models и models_disabled плагина FreeMinecraftModels)
• фильтровать паки по Free или Premium
• проверять и загружать обновление плагина через пункт Plugin Update
• открывать список 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 обнаруживает изменение через один тик после установки блока, помечает вновь присоединённую половину (и любые таблички на ней) и заменяет модель на модель двойного сундука.
• Если вновь присоединённая половина уже принадлежит регистрации другого игрока, вся регистрация отбрасывается, а не поглощает сундук другого игрока.
• Предметы смерти могут заполнять обе стороны инвентаря двойного сундука.
• При смерти каждая половина сундука должна по-прежнему нести маркер владения этого игрока. Если одна из половин была подменена в обход плагина, сундук считается отсутствующим.

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

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

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

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

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

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

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

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

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

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

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

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