HyTari Studios · Officiell guide

Server Inventory Sync

Synkronisera inventories mellan servrar utan att vara beroende av runtime-index.

Den här basguiden beskriver redan dokumenterad funktion: delat inventory, spelarprofil, anti-dupe-locking och semantiskt ItemQuality-bevarande mellan olika registries.

STARTA GUIDEN MODSIDA

INNAN DU BÖRJAR

Kom igång

STEG 01

Installera på deltagande servrar

Använd samma version på noderna som ska dela profilen.

STEG 02

Anslut delad lagring

Deltagande servrar måste använda samma data-backend som releasen förväntar.

STEG 03

Testa en komplett transfer

Kontrollera inventory, utrustning och kvaliteter innan nätverket öppnas.

Basguiden hittar medvetet inte på konfigurationsfält: Nuvarande mod-repository är tomt, så exakta JSON-detaljer läggs till först efter verifiering av source/release-build.

KAPITEL 01 · 1 EXEMPEL

Vad synkroniseras

Inventory, armor, backpack, extra slots och kompatibla profildata.

01FLÖDE

Delad profil mellan servrar

Modden håller stödda profilelement synkroniserade mellan deltagande servrar.

FLÖDE
Server A
  ↓ spara profil
Delad databas
  ↓ ladda profil
Server B

Moddens beteende

VAD DET GÖR

Modden håller stödda profilelement synkroniserade mellan deltagande servrar.

VIKTIGT BETEENDE

  • Målet är inventory-kontinuitet mellan hub, survival, dungeons, arenor och andra servrar.
  • Inventory, armor, backpacks och stödda extra slots ingår.
  • Profildata från kompatibla mods kan synkroniseras när integrationen stöder det.

KAPITEL 02 · 1 EXEMPEL

Synkroniseringsflöde

Laddning, sparande och transfers följer ett skyddat flöde.

01SEKVENS

Skyddad laddning och sparning

Profilen laddas och sparas vid kontrollerade punkter för att undvika samtidiga överskrivningar.

SEKVENS
JOIN / TRANSFER
→ hämta lock
→ ladda profil
→ gameplay
→ autosave / slutsparning
→ frigör lock

Runtime-beteende

VAD DET GÖR

Profilen laddas och sparas vid kontrollerade punkter för att undvika samtidiga överskrivningar.

VIKTIGT BETEENDE

  • Systemet är designat för att inte störa vanliga interna world-byten.
  • Autosave minskar möjlig dataförlust.
  • Loading/lock-meddelanden kan informera spelaren medan profilen ännu inte är tillgänglig.

KAPITEL 03 · 1 EXEMPEL

Locks och anti-dupe

Profilen skyddas mot samtidig åtkomst under kritiska faser.

01REGEL

Lock mot samtidig åtkomst

En profil ska inte ändras av två servrar samtidigt.

REGEL
1 spelar-UUID
→ 1 aktiv profil
→ 1 giltig lock
→ ingen samtidig åtkomst

Intern säkerhet

VAD DET GÖR

En profil ska inte ändras av två servrar samtidigt.

VIKTIGT BETEENDE

  • Locking skyddar mot duplicering och race conditions mellan servrar.
  • Transferlogiken måste slutföra save och handoff innan en annan server använder profilen.
  • Utgångna locks eller fel behandlas som säkerhetslägen, inte som skäl att ladda två kopior.

KAPITEL 04 · 1 EXEMPEL

Säker ItemQuality

Kvaliteter identifieras semantiskt istället för endast via runtime-index.

01EXEMPEL

Semantiskt ItemQuality-bevarande

Samma kvalitet kan ha olika runtime-index på servrar med olika mods eller registries.

EXEMPEL
Server A: CustomEpic = runtime-index 12
Server B: CustomEpic = runtime-index 27

Sync använder kvalitetsidentiteten, inte bara 12/27.

ItemQuality mapping

VAD DET GÖR

Samma kvalitet kan ha olika runtime-index på servrar med olika mods eller registries.

VIKTIGT BETEENDE

  • Om destinationen känner originalkvaliteten återskapas den korrekt.
  • Om den inte kan lösas används en säker Common-fallback medan originalidentiteten bevaras när möjligt.
  • När kvaliteten blir tillgänglig igen kan den återställas.

KAPITEL 05 · 1 EXEMPEL

Diagnostik

ItemQuality-mapping kan loggas när två servrar inte löser samma kvaliteter.

01ANVÄNDNING

Mapping-diagnostik

Vid olika registries hjälper mappingloggar att jämföra ItemQuality-namn och index.

ANVÄNDNING
ItemQuality-mappingdiagnostik
→ aktivera endast för undersökning
→ jämför server A / server B
→ stäng av efter test

Valfri diagnostik

VAD DET GÖR

Vid olika registries hjälper mappingloggar att jämföra ItemQuality-namn och index.

VIKTIGT BETEENDE

  • Diagnostik förklarar registry-skillnader och behövs inte i normal drift.
  • Låt inte detaljerad loggning vara aktiv utan anledning.
  • Sidan får exakta konfigurationsfält när mod-repository har justerats.

Innan du använder ett exempel

Huvudmålet är profilsäkerhet, inte bara att kopiera slots.

ItemQuality-bevarande är särskilt utformat för nätverk med olika registries.

Beskrivande diagram kan ersättas av riktig konfiguration när mod-repository har justerats.

TILL TOPPEN