HyTari Studios · Offisiell guide

Server Inventory Sync

Synkroniser inventories mellom servere uten å være avhengig av runtime-indekser.

Denne basisguiden beskriver den allerede dokumenterte funksjonen: delt inventory, spillerprofil, anti-dupe-locking og semantisk ItemQuality-bevaring mellom ulike registries.

START GUIDEN MODSIDE

FØR DU BEGYNNER

Kom i gang

TRINN 01

Installer på deltakende servere

Bruk samme versjon på nodene som skal dele profilen.

TRINN 02

Koble til delt lagring

Deltakende servere må bruke samme data-backend som releasen forventer.

TRINN 03

Test en full transfer

Kontroller inventory, utstyr og kvaliteter før nettverket åpnes.

Denne basisguiden finner bevisst ikke på konfigurasjonsfeltnavn: Nåværende mod-repository er tomt, så eksakte JSON-detaljer legges til først etter verifisering av source/release-build.

KAPITTEL 01 · 1 EKSEMPLER

Hva synkroniseres

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

01FLYT

Delt profil mellom servere

Modden holder støttede profilelementer synkronisert mellom deltakende servere.

FLYT
Server A
  ↓ lagre profil
Delt database
  ↓ last profil
Server B

Moddens oppførsel

HVA DET GJØR

Modden holder støttede profilelementer synkronisert mellom deltakende servere.

VIKTIG ATFERD

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

KAPITTEL 02 · 1 EKSEMPLER

Synkroniseringsflyt

Lasting, lagring og transfers følger en beskyttet flyt.

01SEKVENS

Beskyttet lasting og lagring

Profilen lastes og lagres på kontrollerte tidspunkt for å unngå samtidige overskrivinger.

SEKVENS
JOIN / TRANSFER
→ hent lock
→ last profil
→ gameplay
→ autosave / sluttsave
→ frigjør lock

Runtime-oppførsel

HVA DET GJØR

Profilen lastes og lagres på kontrollerte tidspunkt for å unngå samtidige overskrivinger.

VIKTIG ATFERD

  • Systemet er laget for å ikke avbryte vanlige interne world-bytter.
  • Autosave reduserer mulig datatap.
  • Loading/lock-meldinger kan informere spilleren mens profilen ennå ikke er tilgjengelig.

KAPITTEL 03 · 1 EKSEMPLER

Locks og anti-dupe

Profilen beskyttes mot samtidig tilgang i kritiske faser.

01REGEL

Lock mot samtidig tilgang

En profil skal ikke endres av to servere samtidig.

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

Intern sikkerhet

HVA DET GJØR

En profil skal ikke endres av to servere samtidig.

VIKTIG ATFERD

  • Locking beskytter mot duplisering og race conditions mellom servere.
  • Transferlogikk må fullføre save og handoff før en annen server bruker profilen.
  • Utløpte locks eller feil behandles som sikkerhetstilstander, ikke som grunn til å laste to kopier.

KAPITTEL 04 · 1 EKSEMPLER

Sikker ItemQuality

Kvaliteter identifiseres semantisk i stedet for bare via runtime-indekser.

01EKSEMPEL

Semantisk ItemQuality-bevaring

Samme kvalitet kan ha ulike runtime-indekser på servere med forskjellige mods eller registries.

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

Sync bruker kvalitetsidentiteten, ikke bare 12/27.

ItemQuality mapping

HVA DET GJØR

Samme kvalitet kan ha ulike runtime-indekser på servere med forskjellige mods eller registries.

VIKTIG ATFERD

  • Hvis destinasjonen kjenner original kvalitet, gjenopprettes den riktig.
  • Hvis den ikke kan løses, brukes en sikker Common-fallback samtidig som original identitet bevares når mulig.
  • Når kvaliteten blir tilgjengelig igjen, kan den gjenopprettes.

KAPITTEL 05 · 1 EKSEMPLER

Diagnostikk

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

01BRUK

Mapping-diagnostikk

Ved ulike registries hjelper mappinglogger med å sammenligne ItemQuality-navn og indekser.

BRUK
ItemQuality-mappingdiagnostikk
→ aktiver bare for undersøkelse
→ sammenlign server A / server B
→ deaktiver etter test

Valgfri diagnostikk

HVA DET GJØR

Ved ulike registries hjelper mappinglogger med å sammenligne ItemQuality-navn og indekser.

VIKTIG ATFERD

  • Diagnostikk forklarer registry-forskjeller og er ikke nødvendig i normal drift.
  • La ikke detaljert logging stå på uten grunn.
  • Siden får eksakte konfigurasjonsfelter når mod-repository er justert.

Før du bruker et eksempel

Hovedmålet er profilsikkerhet, ikke bare å kopiere slots.

ItemQuality-bevaring er laget spesielt for nettverk med ulike registries.

Beskrivende diagrammer kan erstattes av faktisk konfigurasjon når mod-repository er justert.

TIL TOPPEN