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

68 lines
7.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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. Остальные действия банкира,
снятие комнат, крафт и сетевые постройки не меняются.