68 lines
7.8 KiB
Markdown
68 lines
7.8 KiB
Markdown
# 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. Остальные действия банкира,
|
||
снятие комнат, крафт и сетевые постройки не меняются.
|