Терминал сундуков (ChestTerminal) 0.4.0

Мод для Valheim: постройка «Терминал сундуков», которая открывает все сундуки в заданном радиусе как один большой сундук, с поиском и категориями.

Установка

Нужны BepInExPack_Valheim и Jotunn. Thunderstore Mod Manager ставит их сам.

Через Thunderstore Mod Manager (r2modman устроен так же):

1. Выберите Valheim и свой профиль.
2. Слева Settings → вкладка Profile → Import local mod.
3. Укажите ChestTerminal-0.4.0.zip и подтвердите импорт.
4. Если Jotunn не подтянулся сам, найдите его в Online и установите.
5. Запускайте игру кнопкой Start modded.

Вручную: поставить BepInExPack_Valheim и Jotunn, затем скопировать ChestTerminal.dll в Valheim\BepInEx\plugins\ChestTerminal\ChestTerminal.dll.

Как пользоваться

1. Молот → вкладка «Мебель» → «Терминал сундуков». Нужен верстак рядом. Стоимость по умолчанию: 20 дерева и 4 смолы, доступно с самого начала игры. У терминала своя модель: каменно-деревянная тумба с наклонным пультом, светящимися рунами и парящим кристаллом над мачтой. Из Valheim взяты только материалы, сами модели игры не используются.
2. Поставьте терминал рядом с сундуками и нажмите E.
3. Откроется обычное окно сундука вместе с инвентарём, только в нём лежит содержимое всех сундуков в радиусе. Одинаковые предметы показываются одной ячейкой с общим количеством (например, «Дерево 1240»). За одно действие из такой ячейки берётся не больше одной полной стопки: перетаскивание, Shift-клик, окно разделения и выброс на землю работают со стопкой, а «Взять всё» забирает всё, что поместится. Положенные в терминал предметы добавляются в ту же ячейку.
   • Перекладывайте предметы как в обычном сундуке: перетаскивание, клики, разделение стопки, «Взять всё», «Сложить». Всё, что вы берёте, забирается из настоящих сундуков, а всё, что кладёте, раскладывается по ним: сначала в сундуки, где такой предмет уже есть, потом в любые свободные.
   • Окно рисует сама игра или SeneaL UI, поэтому подсказки, стиль и горячие клавиши те же, что у обычного сундука.
   • Поиск и категории встроены прямо в окно сундука SeneaL UI, над ячейками, и используют его собственные поле поиска и кнопки-фильтры. Без SeneaL UI (или если его окно не найдено) показывается отдельная панель сверху экрана, как в 0.2. Поиск работает по названию предмета, по английскому имени (Wood, Bronze) и по названию категории. Пока курсор в поле поиска, горячие клавиши игры не срабатывают; Enter, Esc или клик мимо панели выходят из поля.
   • Если в сундуках нет места для положенного предмета, он возвращается в инвентарь.

Настройки

Файл BepInEx\config\asinit.ChestTerminal.cfg создаётся после первого запуска:

Через SeneaL UI: радиус, ширина окна, «Одна ячейка на предмет» и телеги/корабли есть в окне настроек SeneaL UI, в разделе модов («Терминал сундуков»), меняются без перезапуска.

Размер и положение окна: само окно сундука двигается и растягивается в редакторе HUD SeneaL UI (элемент «Chest panel»). Ширина в ячейках задаётся настройкой UI.Columns.

Радиус больше ~60 м мало что даёт: игра держит загруженными только сундуки рядом с игроком.

Совместимость

• SeneaL UI: терминал открывается как обычный сундук, поэтому SeneaL UI рисует его своим окном со своими пресетами, подсказками и окном разделения стопки. Перенос между терминалом и настоящими сундуками идёт через обычные функции игры (Inventory.AddItem, RemoveItem), так что расширенный инвентарь SeneaL и его патчи на эти функции продолжают работать.
• Содержимое терминала существует только пока он открыт и никогда не сохраняется в мир, поэтому автосохранение или вылет игры не может размножить предметы. Когда терминал закрыт, он пустой, и «крафт из сундуков» SeneaL UI ничего из него не берёт.
• Сундуки других модов работают, если они используют обычный компонент Container.
• Пропускаются: могилы игрока, чужие приватные сундуки, сундуки под чужим охранным камнем, другие терминалы.
• Патчи Inventory.MoveItemToThis, MoveAll, Humanoid.DropItem и окна перетаскивания/разделения срабатывают только когда предмет идёт из терминала или в терминал. Harmony-патчи Container.Interact, GetHoverText, Save, Load меняют поведение только у терминала (по имени префаба). Ещё один патч на ZInput гасит горячие клавиши игры, пока курсор стоит в поле поиска.

Сборка из исходников

Нужен .NET SDK 8+. Ссылки на игру берутся из NuGet (ValheimGameLibs, UnityEngine.Modules, JotunnLib), BepInEx и Harmony лежат в libs/.

dotnet build -c Release
# с автокопированием в игру:
dotnet build -c Release -p:ValheimDir="C:\Program Files (x86)\Steam\steamapps\common\Valheim"

Готовая DLL: bin/Release/net462/ChestTerminal.dll.

Changelog / История изменений

0.4.1

• EN: New bilingual description (English and Russian), changelog. No gameplay changes.
• RU: Новое описание на двух языках и история изменений. Игровых изменений нет.

0.4.0

• EN: Items of the same kind are shown as one slot with the total amount (UI.MergeStacks). Up to one full stack is taken out at a time.
• RU: Одинаковые предметы показываются одной ячейкой с общим количеством (UI.MergeStacks). За раз берётся до одной полной стопки.

0.3.0

• EN: Search and category chips built into the SeneaL UI chest panel. New custom terminal model. UI.Columns window width setting. Settings added to SeneaL UI's settings window.
• RU: Поиск и категории встроены в окно сундука SeneaL UI. Новая собственная модель терминала. Настройка ширины окна UI.Columns. Настройки добавлены в окно настроек SeneaL UI.

0.2.x

• EN: The terminal opens as a real chest window next to your inventory: drag and drop, split stacks, Take all. Cheaper recipe (20 Wood, 4 Resin). Fixes for Valheim 1.0.20.
• RU: Терминал открывается как настоящее окно сундука рядом с инвентарём: перетаскивание, разделение стопки, «Взять всё». Дешёвый рецепт (20 дерева, 4 смолы). Исправления под Valheim 1.0.20.

0.1.0

• EN: First version.
• RU: Первая версия.