HyTari Studios · Hivatalos útmutató

Server Inventory Sync

Szinkronizáld az inventorykat szerverek között runtime indexektől függetlenül.

Ez az alapútmutató a már dokumentált működést írja le: közös inventory, játékosprofil, anti-dupe locking és szemantikus ItemQuality-megőrzés eltérő registryk között.

ÚTMUTATÓ INDÍTÁSA MOD OLDALA

MIELŐTT ELKEZDED

Első lépések

LÉPÉS 01

Telepítés a résztvevő szerverekre

Ugyanazt a verziót használd azokon a node-okon, amelyek megosztják a profilt.

LÉPÉS 02

Közös storage csatlakoztatása

A résztvevő szervereknek ugyanazt, a release által várt data backendet kell használniuk.

LÉPÉS 03

Teljes transfer tesztelése

A hálózat megnyitása előtt ellenőrizd az inventoryt, felszerelést és minőségeket.

Az alapútmutató szándékosan nem talál ki konfigurációs mezőneveket: a jelenlegi mod repository üres, ezért a pontos JSON-részletek csak source/release-build ellenőrzés után kerülnek be.

FEJEZET 01 · 1 PÉLDÁK

Mi szinkronizálódik

Inventory, armor, backpack, további slotok és kompatibilis profildata.

01FOLYAMAT

Megosztott profil szerverek között

A mod a támogatott profilelemeket szinkronban tartja a résztvevő szerverek között.

FOLYAMAT
Szerver A
  ↓ profil mentése
Közös adatbázis
  ↓ profil betöltése
Szerver B

Mod működése

MIT CSINÁL

A mod a támogatott profilelemeket szinkronban tartja a résztvevő szerverek között.

FONTOS MŰKÖDÉS

  • A cél az inventory folytonossága hub, survival, dungeon, aréna és más szerverek között.
  • Inventory, armor, backpacks és támogatott extra slotok is részei.
  • Kompatibilis modok profildataja szinkronizálható, ha az integráció támogatja.

FEJEZET 02 · 1 PÉLDÁK

Szinkronizációs folyamat

Betöltés, mentés és transfer védett ciklust követ.

01SORREND

Védett betöltés és mentés

A profil ellenőrzött pontokon töltődik és mentődik a párhuzamos felülírás elkerülésére.

SORREND
JOIN / TRANSFER
→ lock megszerzése
→ profil betöltése
→ játék
→ autosave / végső mentés
→ lock feloldása

Runtime működés

MIT CSINÁL

A profil ellenőrzött pontokon töltődik és mentődik a párhuzamos felülírás elkerülésére.

FONTOS MŰKÖDÉS

  • A rendszer nem zavarja a normál belső world-váltásokat.
  • Az autosave csökkenti az esetleges adatvesztési ablakot.
  • A loading/lock üzenetek jelezhetik, ha a profil még nem érhető el.

FEJEZET 03 · 1 PÉLDÁK

Locks és anti-dupe

A profil kritikus fázisokban védett a párhuzamos hozzáféréstől.

01SZABÁLY

Lock párhuzamos hozzáférés ellen

Egy profilt nem módosíthat egyszerre két szerver.

SZABÁLY
1 játékos UUID
→ 1 aktív profil
→ 1 érvényes lock
→ nincs párhuzamos hozzáférés

Belső biztonság

MIT CSINÁL

Egy profilt nem módosíthat egyszerre két szerver.

FONTOS MŰKÖDÉS

  • A locking véd a duplikációtól és szerverek közti race conditionöktől.
  • A transfer logikának be kell fejeznie a save és handoff folyamatot, mielőtt másik szerver használná a profilt.
  • Lejárt lock vagy hiba biztonsági állapotnak számít, nem ok két példány betöltésére.

FEJEZET 04 · 1 PÉLDÁK

Biztonságos ItemQuality

A minőségek szemantikusan azonosítódnak, nem csak runtime index alapján.

01PÉLDA

Szemantikus ItemQuality-megőrzés

Ugyanaz a minőség különböző runtime indexet kaphat eltérő modokat vagy registryket használó szervereken.

PÉLDA
Szerver A: CustomEpic = runtime index 12
Szerver B: CustomEpic = runtime index 27

A Sync a minőség identitását használja, nem csak a 12/27 értéket.

ItemQuality mapping

MIT CSINÁL

Ugyanaz a minőség különböző runtime indexet kaphat eltérő modokat vagy registryket használó szervereken.

FONTOS MŰKÖDÉS

  • Ha a cél ismeri az eredeti minőséget, helyesen állítja vissza.
  • Ha nem oldható fel, biztonságos Common fallback használható az eredeti identitás megtartásával, amikor lehet.
  • Ha a minőség újra elérhető, visszaállítható.

FEJEZET 05 · 1 PÉLDÁK

Diagnosztika

ItemQuality mapping naplózható, ha két szerver eltérően oldja fel ugyanazt a minőséget.

01HASZNÁLAT

Mapping diagnosztika

Eltérő registryk esetén a mapping logok segítenek összehasonlítani az ItemQuality neveket és indexeket.

HASZNÁLAT
ItemQuality mapping diagnosztika
→ csak vizsgálathoz kapcsold be
→ hasonlítsd össze A / B szervert
→ teszt után kapcsold ki

Opcionális diagnosztika

MIT CSINÁL

Eltérő registryk esetén a mapping logok segítenek összehasonlítani az ItemQuality neveket és indexeket.

FONTOS MŰKÖDÉS

  • A diagnosztika a registry-különbségek megértésére szolgál, normál működéshez nem kell.
  • Ne hagyd ok nélkül aktívan a részletes logolást.
  • A pontos konfigurációs mezők a mod repository rendezése után kerülnek be.

Példa használata előtt

A fő cél a profil biztonsága, nem pusztán slotok másolása.

Az ItemQuality-megőrzés kifejezetten eltérő registryket használó hálózatokhoz készült.

A leíró diagramok valós konfigurációra cserélhetők, amikor a mod repository rendezve lesz.

VISSZA FEL