HyTari Studios · Officiel guide

Server Inventory Sync

Synkronisér inventories mellem servere uden at være afhængig af runtime-indekser.

Denne basisguide beskriver den allerede dokumenterede offentlige funktion: delt inventory, spillerprofil, anti-dupe-locking og semantisk ItemQuality-bevarelse mellem forskellige registries.

START GUIDEN MODSIDE

FØR DU BEGYNDER

Kom godt i gang

TRIN 01

Installer på deltagende servere

Brug samme version på de noder, der skal dele profilen.

TRIN 02

Forbind delt storage

Deltagende servere skal bruge det samme data-backend, som releasen forventer.

TRIN 03

Test en komplet transfer

Kontrollér inventory, udstyr og kvaliteter før netværket åbnes.

Denne basisguide opfinder bevidst ingen konfigurationsfeltnavne: Det nuværende mod-repository er tomt, så præcise JSON-detaljer tilføjes først efter verificering af source/release-build.

KAPITEL 01 · 1 EKSEMPLER

Hvad synkroniseres

Inventory, armor, backpack, ekstra slots og kompatible profildata.

01FLOW

Delt profil mellem servere

Modden holder understøttede profilelementer synkroniseret mellem deltagende servere.

FLOW
Server A
  ↓ gem profil
Delt database
  ↓ indlæs profil
Server B

Moddens adfærd

HVAD DET GØR

Modden holder understøttede profilelementer synkroniseret mellem deltagende servere.

VIGTIG ADFÆRD

  • Målet er inventory-kontinuitet mellem hub, survival, dungeons, arenaer og andre servere.
  • Inventory, armor, backpacks og understøttede ekstra slots er inkluderet.
  • Profildata fra kompatible mods kan synkroniseres, når integrationen understøtter det.

KAPITEL 02 · 1 EKSEMPLER

Synkroniseringsflow

Indlæsning, lagring og transfers følger et beskyttet flow.

01SEKVENS

Beskyttet indlæsning og lagring

Profilen indlæses og gemmes på kontrollerede tidspunkter for at undgå samtidige overskrivninger.

SEKVENS
JOIN / TRANSFER
→ hent lock
→ indlæs profil
→ gameplay
→ autosave / slut-save
→ frigiv lock

Runtime-adfærd

HVAD DET GØR

Profilen indlæses og gemmes på kontrollerede tidspunkter for at undgå samtidige overskrivninger.

VIGTIG ADFÆRD

  • Systemet er designet til ikke at forstyrre normale interne world-skift.
  • Autosave reducerer vinduet for muligt datatab.
  • Loading/lock-beskeder kan informere spilleren, mens profilen endnu ikke er tilgængelig.

KAPITEL 03 · 1 EKSEMPLER

Locks og anti-dupe

Profilen beskyttes mod samtidig adgang i kritiske faser.

01REGEL

Lock mod samtidig adgang

En profil må ikke ændres af to servere samtidigt.

REGEL
1 spiller-UUID
→ 1 aktiv profil
→ 1 gyldig lock
→ ingen samtidig adgang

Intern sikkerhed

HVAD DET GØR

En profil må ikke ændres af to servere samtidigt.

VIGTIG ADFÆRD

  • Locking beskytter mod duplikering og race conditions mellem servere.
  • Transferlogikken skal afslutte save og handoff, før en anden server bruger profilen.
  • Udløbne locks eller fejl behandles som sikkerhedstilstande, ikke som grund til at indlæse to kopier.

KAPITEL 04 · 1 EKSEMPLER

Sikker ItemQuality

Kvaliteter identificeres semantisk i stedet for kun via runtime-indekser.

01EKSEMPEL

Semantisk ItemQuality-bevarelse

Samme kvalitet kan have forskellige runtime-indekser på servere med forskellige mods eller registries.

EKSEMPEL
Server A: CustomEpic = runtime-indeks 12
Server B: CustomEpic = runtime-indeks 27

Sync bruger kvalitetsidentiteten, ikke kun 12/27.

ItemQuality mapping

HVAD DET GØR

Samme kvalitet kan have forskellige runtime-indekser på servere med forskellige mods eller registries.

VIGTIG ADFÆRD

  • Hvis destinationen kender den oprindelige kvalitet, genskabes den korrekt.
  • Hvis den ikke kan opløses, bruges en sikker Common-fallback, mens original identitet bevares når muligt.
  • Når kvaliteten bliver tilgængelig igen, kan den gendannes.

KAPITEL 05 · 1 EKSEMPLER

Diagnostik

ItemQuality-mapping kan logges, når to servere ikke opløser samme kvaliteter.

01BRUG

Mapping-diagnostik

Ved forskellige registries hjælper mappinglogs med at sammenligne ItemQuality-navne og indekser.

BRUG
ItemQuality-mappingdiagnostik
→ aktivér kun til undersøgelse
→ sammenlign server A / server B
→ deaktivér efter test

Valgfri diagnostik

HVAD DET GØR

Ved forskellige registries hjælper mappinglogs med at sammenligne ItemQuality-navne og indekser.

VIGTIG ADFÆRD

  • Diagnostik hjælper med at forklare registry-forskelle; det kræves ikke i normal drift.
  • Lad ikke detaljeret logging være aktiv uden grund.
  • Siden får præcise konfigurationsfelter, når mod-repository er justeret.

Før du bruger et eksempel

Hovedmålet er profilsikkerhed, ikke blot at kopiere slots.

ItemQuality-bevarelse er designet specifikt til netværk med forskellige registries.

De beskrivende diagrammer kan erstattes af den rigtige konfiguration, når mod-repository er justeret.

TIL TOPPEN