Configuration RU

Настройки

Для Runic Storage Network 0.8.8. English version.

Файл конфигурации: BepInEx/config/local.runicstoragenetwork.cfg. Он появляется после первого запуска мода. При использовании менеджера модов редактируйте файл того профиля, с которым играете.

Параметры Network, Containers и Building в мультиплеере доступны администратору и синхронизируются через Jötunn. Их значения для сессии определяет сервер. Изменения через систему конфигурации применяются во время игры; простое редактирование файла на диске не гарантирует его немедленной перечитки. Самый простой способ применить правки файла — сделать их при закрытой игре/остановленном сервере, затем запустить снова.

Разделы Experimental и Diagnostics настраиваются отдельно в каждой установке. Изменение экспериментальной настройки только на сервере не включает её у клиентов.

Экспериментальные удалённые хранилища

Функция экспериментальная, выключена по умолчанию и может вызывать ошибки, в том числе с инвентарём. Перед тестом сохраните резервную копию мира.

[Experimental]
ExperimentalUnloadedNetworks = false

Значение ExperimentalUnloadedNetworks = true разрешает работу подключённой сети и подходящих хранилищ вне области загрузки игрока. Оно также включает API для других модов.

Для мультиплеера установите одинаковую версию RSN у хоста или на выделенном сервере и у всех игроков, затем включите параметр в каждой установке. После изменения полностью перезапустите все клиенты и хост/сервер. Для отключения верните false везде и перезапустите. Если параметр выключен на сервере, клиенты используют обычную сеть в загруженной области, а экспериментальный API недоступен.

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

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

Сеть

Расстояния указаны в метрах. Увеличение радиусов может добавить в сеть больше узлов и сундуков и увеличить объём работы при её проверке.

Параметр в [Network]	По умолчанию	Допустимо	Назначение
SupplyEnabled	true	true / false	Включает снабжение из сети. При отключении постройки остаются доступны, но новые списания через API также прекращаются.
StorageRadius	20	1–100	Радиус подключения хранилищ к ядру.
SupplyRadius	20	1–100	Радиус снабжения крафта, строительства и доступа к хранилищу вокруг ядра.
RelayLinkRange	50	1–100	Максимальное расстояние между соединёнными узлами сети.
RelayStorageRadius	20	1–100	Радиус подключения хранилищ к реле.
RelaySupplyRadius	20	1–100	Радиус снабжения вокруг подключённого реле.
RescanIntervalSeconds	2	0.5–30	Интервал обычного пересчёта связей сети. Это не таймер каждого обновления инвентаря или запроса API.

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

Хранилища

Параметр в [Containers]	По умолчанию	Назначение
AllowedContainers	пусто	Пусто: подключаются все подходящие хранилища. Заполнено: только перечисленные префабы.
DeniedContainers	piece_trashcan	Перечисленные префабы хранилищ исключаются.
DeniedComponents	См. ниже	Исключает хранилище, если в его префабе есть хотя бы один из перечисленных компонентов.

Стандартное значение DeniedComponents:

Incinerator,Turret,Catapult,Vagon,Ship,ItemStand,ArmorStand,Smelter,CookingStation,Fermenter,Beehive,SapCollector

Используйте внутренние имена префабов и компонентов, а не переведённые названия предметов. Разделяйте элементы запятыми. Пробелы вокруг имён и регистр букв не учитываются. Исключение важнее разрешения: хранилище из обоих списков останется исключённым. Эти списки фильтруют контейнеры, а не категории ресурсов.

Список разрешений не добавляет поддержку нестандартного инвентаря: сохраняются требования к неподвижному публичному хранилищу игрока и проверки доступа. Удаление исключённых компонентов не обеспечивает совместимость с собственной логикой инвентаря устройства. Стандартные исключения не позволяют сети забирать содержимое машин, которые расходуют его или используют как боеприпасы.

Строительные инструменты

Параметр в [Building]	По умолчанию	Назначение
AllowedBuildTools	пусто	Пусто: любой инструмент с меню строительства использует сеть. Заполнено: только перечисленные префабы предметов.
DeniedBuildTools	пусто	Эти префабы инструментов никогда не строят из сетевых запасов.
DeniedPieceComponents	TerrainOp,TerrainModifier	Постройки с такими компонентами используют только материалы в инвентаре.

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

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

Диагностика и совместимость

[Diagnostics] DebugLogging = false — значение по умолчанию. Включите параметр для подробной диагностики операций; полное содержимое инвентарей в лог не выводится.

Консольная команда rsn_status (также rsn status) показывает состояние сети и количество поддерживаемых и исключённых типов контейнеров. Журнал мода перечисляет их по именам. Для разбора проблемы нужен лог используемого профиля; для мультиплеера по возможности приложите логи проблемного клиента и сервера.

SupplyEnabled = true не отменяет проверку несовместимых модов. См. ограничения совместимости. При использовании Quick Stack без MultiUserChest параметр AllowAreaStackingInMultiplayerWithoutMUC должен быть выключен в конфиге самого Quick Stack.