Server documentation

Restock & Roam

Active

Hytale • Version 1.0.0

Установка, киты, сети сундуков, восстановление trip, BetterClaim, команды, конфиг и права.

Настройка сервера Restock & Roam: папки данных, вкладки GUI, восстановление trip, BetterClaim, команды и config.json.

Обзор

Restock & Roam это server-side плагин для Hytale 0.6.0+. Игроки сохраняют личные киты, привязывают сеть сундуков, активируют кит для этой базы, затем приседают и открывают привязанный сундук, чтобы подготовить trip или сдать лут и пополнить запас по возвращении.

Открыть сундук стоя это vanilla. Плагин переносит предметы только после приседа и interact с привязанным сундуком, когда кит уже активен для этой network. У игрока не больше одной базы. Гости хранят свои киты и snapshot trip на сундуках хозяина.

Данные лежат в mods/durkz_RestockAndRoam/. Если уже есть mods/durkz_ExpeditionPrep/, плагин продолжает эту папку, чтобы не потерять киты и базы.

Установка

Нужен Hytale 0.6.0+
Скачайте RestockAndRoam-1.0.0.jar на вкладке Files CurseForge
Положите JAR в mods/ (глобально UserData/Mods или mods/ сейва)
Запустите мир. Конфиг: mods/durkz_RestockAndRoam/config.json
Выполните /eprep. Лог загрузки: Restock & Roam loaded. Open /eprep to claim an Expedition Ledger.
(Опционально) Установите BetterClaim, если привязанные сундуки должны также соблюдать правила interact сундука клейма

GUI

/eprep и secondary action Expedition Ledger открывают одну и ту же CustomUI. Вкладки:

Вкладка	Назначение
Overview	Выбрать кит и доступную базу, активировать кит, получить Ledger
Kits	Сохранить, править и удалить до 12 китов
Base	Привязать или отвязать сундуки, пригласить или убрать гостей, удалить network
Chest rules	Роль, приоритет и фильтры на сундук
Trip status	Последний отчёт turnaround, pending лут, abandon или recovery админа

Разрушительные действия (замена кита, удаление кита, удаление network, abandon trip, admin reset) требуют второго клика. Первый только спрашивает подтверждение и не двигает предметы.

Цикл из 13 шагов для игрока на странице мода.

Киты

Кит это snapshot hotbar, брони, utility, tools, инвентаря и backpack плюс опциональные записи supplies total (не привязаны к слоту).

Правило	Деталь
Имя	1-24 символа: буквы, цифры, пробелы, `-`, `_`
Число	До 12 китов на игрока на мир
Save	Save full kit сохраняет раскладку. Предметы остаются у игрока
Replace	То же имя: кликните дважды для подтверждения
Исключены	Expedition Ledger и предметы `EditorTool_*` никогда не сохраняются
Пустой	Пустой кит сохранить нельзя

Add held supplies берёт активный стек hotbar и сохраняет целевое количество. Restock потом кладёт этот итог в инвентарь или backpack, не в конкретный слот экипировки.

База и гости

Правило	Деталь
Primary	Link primary, меню закрывается, откройте сундук за 30 секунд
Additional	Link additional, то же окно 30 секунд, в 16 блоках от primary (3D: `dx²+dy²+dz² ≤ 256`)
Размер	1 primary плюс дополнительные, максимум 17 сундуков
Владелец	Одна network на игрока. Сундук не может принадлежать двум network
Гости	Имя должно однозначно указать известного игрока (заходил хотя бы раз). Максимум 128 гостей
Доступ	Владелец или гость. Гости не правят сундуки, правила и список гостей
Unlink extra	Выберите не-primary сундук, Unlink selected
Delete	Delete network требует второго клика. Удаляет всю базу

/expedition cancel сбрасывает ожидание привязки на 30 секунд.

Chest rules

Поле	Деталь
`SUPPLY`	Выдаёт предметы при пополнении кита
`LOOT`	Принимает предметы, полученные с момента выхода
`BOTH`	Оба. Primary стартует как `BOTH` с пустыми фильтрами (fallback)
Приоритет	`-1000` до `1000`. Выше первым среди фильтрованных сундуков
Фильтры	Список OR: `item:ID`, `category:ID`, `resource:ID`. Пусто = fallback

Порядок: фильтрованные сундуки раньше fallback, затем выше приоритет, затем порядок ссылок. Primary всегда первый в списке. Move earlier / Move later меняют местами только дополнительные сундуки.

Turnaround

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

Случай	Что происходит
Первое приседание (нет trip)	Пополняет кит из `SUPPLY`/`BOTH`, пишет snapshot выхода
Возврат на ту же базу	Сдаёт прирост относительно snapshot в `LOOT`/`BOTH`, затем пополняет кит
Interact стоя	Vanilla сундук. Без переноса
Другая база или другой мир	Блок, пока не вернётесь к источнику или Abandon trip
Смена кита в середине trip	Snapshot остаётся на ките, с которым вышли
Полный лут-сундук	Остаток остаётся у игрока и виден как pending в Trip status
Сбой	Trip помечается на recovery. Проверьте инвентарь, затем abandon. Recovery никогда не повторяет переносы

Лут берётся из инвентаря, backpack, hotbar, utility, tools, затем брони, в этом порядке. Лутом считается только прирост с момента выхода.

BetterClaim

Опциональная зависимость durkz:BetterClaim. Если BetterClaim есть и включён, каждый привязанный сундук также требует право interact сундука. Если BetterClaim установлен, но запрос падает, доступ запрещается. Без BetterClaim Restock & Roam клеймы не проверяет.

Возможности

Личные киты с раскладкой слотов и опциональными итогами припасов
Сеть сундуков, гости и trip на игрока на общей базе
Сдаёт только прирост с момента выхода; пополняет из SUPPLY/BOTH
Overflow остаётся у игрока; Trip status показывает pending типы
Expedition Ledger (анимация spellbook) или /eprep
Опциональная проверка interact сундука BetterClaim
Уведомления об обновлении для операторов или expeditionprep.admin (checkForUpdates)

Команды

Главная команда: /expedition (алиасы: /eprep, /restock, /rr). Для GUI право не нужно.

Команда	Доступ	Описание
`/eprep`	Все	Открыть Overview
`/expedition bind`	Все	Включить ожидание привязки primary (или additional) сундука на 30 секунд
`/expedition save <name>`	Все	Сохранить текущую экипировку как кит без GUI
`/expedition prepare <name>`	Все	Активировать кит и включить prepare на 30 секунд у привязанного сундука
`/expedition cancel`	Все	Отменить ожидание действия с сундуком на 30 секунд

/eprep
/expedition bind
/expedition save Ranger
/expedition prepare Ranger
/expedition cancel

Обычный путь это GUI. Чат-ярлыки не заменяют Use this kit плюс приседание у привязанного сундука.

Права

Право	Описание
`expeditionprep.admin`	Смотреть trip другого игрока, сбрасывать tracking, получать уведомления об обновлении

Владельцы базы управляют сундуками и гостями без дополнительного узла.

Пример:

/perm user <player> expeditionprep.admin true

Операторы сервера получают уведомления об обновлении через ту же проверку, что и expeditionprep.admin.

Конфигурация

Файл: mods/durkz_RestockAndRoam/config.json (или mods/durkz_ExpeditionPrep/config.json, если эта папка уже есть).

Поле	По умолчанию	Описание
`checkForUpdates`	`true`	При входе операторы или `expeditionprep.admin` один раз получают чат, если на сайте указан более новый `RestockAndRoam-x.y.z.jar`

{
  "checkForUpdates": true
}

В конфиге нет игровых переключателей. Размер кита, число сундуков и фильтры задаёт плагин.

Файлы данных

Путь	Назначение
`mods/durkz_RestockAndRoam/config.json`	Переключатель update-check
`mods/durkz_RestockAndRoam/profiles/<worldUuid>/<playerUuid>.json`	Киты игрока
`mods/durkz_RestockAndRoam/worlds/<worldUuid>.json`	Networks, активные киты, trip

Замените имя папки на durkz_ExpeditionPrep, если этот каталог уже существует.

Как проверить

Запустите мир. В логе есть Restock & Roam loaded. Open /eprep to claim an Expedition Ledger.
/eprep открывает Overview. Заберите Ledger. В инвентарь попадает Durkz_Expedition_Ledger, если есть свободный слот.
Сохраните кит, привяжите primary сундук за 30 секунд, нажмите Use this kit.
Присядьте и откройте этот сундук. Чат сообщает пополнение кита и trip начинается.
Подберите новый предмет, вернитесь, присядьте снова. Чат сообщает сдачу лута и supplied кита.
Trip status показывает тот же отчёт. Abandon trip (два клика) сбрасывает tracking без перемещения предметов.

Лицензия

MIT License