Files
LonaRPG-Online-Games/ModScripts/_Mods/LonaCraft/ONLINE_RU.md
T
2026-10-29 21:59:06 +04:00

7.8 KiB
Raw Blame History

LonaCraft 1.1.0 — совместный режим на уровне мода

Эта версия использует существующий канал deistvia из ModScripts/multiplayer (клиент game_online от 2026-10-09). Game.exe и сам Ruby не изменяются.

Серверное сохранение

С отдельным ModPersistencePlugin-1.0.0.jar общий мир LonaCraft больше не зависит от присутствия второго игрока на карте. Сервер сохраняет основания баз, строительные детали, мебель и удаления, а при входе возвращает их через штатный запрос lonacraft_world_v1.

Личные предметы, содержимое сундуков, навыки, наёмники и сюжет намеренно не переезжают в общий мир: они остаются в профиле персонажа (cloud), а не в lonacraft_world_v1.

Личное cloud-сохранение LonaCraft (клиент multiplayer):

  • покупки «Старая хижина» и «Каменный дом» — флаги в $story_stats (LonaCraftHome_noer_shack / LonaCraftHome_noer_stonehouse), как у NoerHome;
  • содержимое сундуков/шкафов лагеря — поле lc_chests внутри банковского bank_blob (тот же канал, что у хранилища банка). Между игроками содержимое по-прежнему не шарится.

Live UI (без паузы мира): экран крафта (Scene_LonaCraft) и переименование базы (Scene_LonaCraftBaseName) в онлайне используют тот же живой Spriteset_Map, что ESC/банк/сундуки. Сундуки мебели уже покрыты ванильным Scene_ItemStorage. Оффлайн — обычная snapshot-пауза.

Установка

  1. Все участники ставят одинаковую LonaCraft 1.1.0, включают её в Mods и ставят последней по порядку загрузки.
  2. Скопируйте ModPersistencePlugin-1.0.0.jar в папку plugins сервера и перезапустите сервер (или выполните PLUGINS RELOAD).
  3. Используется онлайн-клиент 2026-10-09 с Ruby 3.1.0 / Ruby310Compat и RUS2. Входите на один и тот же сервер.
  4. Для совместного строительства войдите на одну и ту же карту, желательно одновременно с карты мира, и дождитесь загрузки. Пока подключение и worldsync не готовы, предметы остаются локальными.
  5. Стройте и ставьте мебель как в обычном LonaCraft. Изменения по активной карте автоматически отсылаются участникам с этой версией мода и сохраняются плагином.
  6. Если объект не появился, выйдите и снова войдите на ту же карту; мод делает запрос состояния при входе и затем периодически.

Что синхронизируется между модами

  • Поставленная и убранная мебель, станки, костры и украшения: вид и положение, без содержимого.
  • Стены, каменные стены, полы, двери, удаление и прочность деталей на общей карте с одной и той же идентичностью/номером.
  • Создание новой базы игроком, пока другие игроки находятся в том же экземпляре исходной местности (передаётся номер и привязка карты).
  • Для входа на один мировой тайл в онлайн-режиме используется одинаковый выбор случайной карты местности. В офлайне механизм выбора не меняется.
  • При входе на карту отправляется запрос и текущая картинка объектов; сообщения имеют версии, чтобы запоздалый пакет не восстановил уже удалённый предмет.
  • На карте мира моды могут обменяться описаниями уже созданных баз.

Ограничения (важно)

  • Сервер хранит общий внешний мир LonaCraft в plugins/ModPersistencePlugin/lonacraft-world.tsv. Резервные копии этого файла всё равно рекомендуются.
  • Личные инвентари и крафт, содержимое сундуков, торговля, найм, ИИ набегов, прислуга, экономика, личные дома и рейды НЕ становятся общесерверными. Для станков синхронизируются внешний вид и доступность на соответствующей карте, а не прогресс крафта в чужом инвентаре.
  • У других игроков может быть сохранена база с тем же внутренним номером, но на другом мировом тайле. При таком конфликте мод не заменяет её, и синхронизация новой базы может не состояться.
  • Если игроки используют разные версии LonaCraft или сервер не загружает плагин, долговременного общего состояния нет. Встроенное меню Mods другого игрока не определяет, установлен ли у него мод.
  • Плагин строго ограничивает формат и объём сетевых записей, но это не защищённая экономика. Не храните ценные вещи в общих сундуках — их содержимое не синхронизируется.

Если в Console.bat есть записи [LonaCraft Online] entered ... и registered shared base ..., мост загружен. Это не доказывает, что сервер пересылает пакеты; для этого нужен тест между двумя игровыми клиентами.

Совместимость с NoerHome — версия 1.1.2

В банке Ноэра у Маани выберите «Купить дом». В новом подменю доступны до трёх пунктов: «Частный дом» из NoerHome, «Старая хижина» и «Каменный дом» из LonaCraft. Уже купленные варианты не показываются. Если куплены все три, пункт «Купить дом» исчезает из главного меню банка.

NoerHome сам обрабатывает оплату/сетевое сохранение своего частного дома. Покупки LonaCraft (хижина и каменный дом) пишутся в $story_stats и восстанавливаются при cloud bootstrap. Остальные действия банкира, снятие комнат, крафт и сетевые постройки не меняются.