HyTari Studios · Officiële handleiding

Server Inventory Sync

Synchroniseer inventarissen tussen servers zonder afhankelijk te zijn van runtime-indexen.

Deze basisgids beschrijft het al gedocumenteerde publieke gedrag: gedeelde inventaris, spelersprofiel, anti-duplicatielocking en semantisch behoud van ItemQuality tussen verschillende registries.

START DE HANDLEIDING MODPAGINA

VOORDAT JE BEGINT

Aan de slag

STAP 01

Installeer op deelnemende servers

Gebruik dezelfde versie op de nodes die het profiel moeten delen.

STAP 02

Verbind gedeelde opslag

Deelnemende servers moeten dezelfde data-backend gebruiken die de release verwacht.

STAP 03

Test een volledige transfer

Controleer inventaris, uitrusting en kwaliteiten voordat je het netwerk opent.

Deze basisgids verzint bewust geen configuratieveldnamen: de huidige modrepository is leeg, dus exacte JSON-details worden pas toegevoegd na verificatie van source/release-build.

HOOFDSTUK 01 · 1 VOORBEELDEN

Wat wordt gesynchroniseerd

Inventaris, armor, backpack, extra slots en compatibele profieldata.

01STROOM

Gedeeld profiel tussen servers

De mod houdt ondersteunde profielelementen gesynchroniseerd tussen deelnemende servers.

STROOM
Server A
  ↓ profiel opslaan
Gedeelde database
  ↓ profiel laden
Server B

Gedrag van de mod

WAT HET DOET

De mod houdt ondersteunde profielelementen gesynchroniseerd tussen deelnemende servers.

BELANGRIJK GEDRAG

  • Doel is inventariscontinuïteit tussen hub, survival, dungeons, arena's en andere servers.
  • Inventaris, armor, backpacks en ondersteunde extra slots zijn inbegrepen.
  • Profieldata van compatibele mods kan worden gesynchroniseerd als de integratie dit ondersteunt.

HOOFDSTUK 02 · 1 VOORBEELDEN

Synchronisatiestroom

Laden, opslaan en transfers volgen een beschermd proces.

01VOLGORDE

Beschermd laden en opslaan

Het profiel wordt op gecontroleerde momenten geladen en opgeslagen om gelijktijdig overschrijven te voorkomen.

VOLGORDE
JOIN / TRANSFER
→ lock verkrijgen
→ profiel laden
→ gameplay
→ autosave / definitief opslaan
→ lock vrijgeven

Runtime-gedrag

WAT HET DOET

Het profiel wordt op gecontroleerde momenten geladen en opgeslagen om gelijktijdig overschrijven te voorkomen.

BELANGRIJK GEDRAG

  • Het systeem is ontworpen om normale interne wereldwissels niet te onderbreken.
  • Automatisch opslaan verkleint het mogelijke gegevensverliesvenster.
  • Loading/lock-berichten kunnen spelers informeren zolang het profiel nog niet beschikbaar is.

HOOFDSTUK 03 · 1 VOORBEELDEN

Locks en anti-duplicatie

Het profiel wordt tijdens kritieke fasen tegen gelijktijdige toegang beschermd.

01REGEL

Lock tegen gelijktijdige toegang

Een profiel mag niet tegelijk door twee servers worden aangepast.

REGEL
1 speler-UUID
→ 1 actief profiel
→ 1 geldige lock
→ geen gelijktijdige toegang

Interne beveiliging

WAT HET DOET

Een profiel mag niet tegelijk door twee servers worden aangepast.

BELANGRIJK GEDRAG

  • Locking beschermt tegen duplicatie en race conditions tussen servers.
  • Transferlogica moet save en handoff voltooien voordat een andere server het profiel gebruikt.
  • Verlopen locks of fouten worden als veiligheidscondities behandeld, niet als reden om twee kopieën te laden.

HOOFDSTUK 04 · 1 VOORBEELDEN

Veilige ItemQuality

Kwaliteiten worden semantisch geïdentificeerd in plaats van alleen via runtime-indexen.

01VOORBEELD

Semantisch ItemQuality-behoud

Dezelfde kwaliteit kan verschillende runtime-indexen hebben op servers met andere mods of registries.

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

Sync gebruikt de kwaliteitsidentiteit, niet alleen 12/27.

ItemQuality mapping

WAT HET DOET

Dezelfde kwaliteit kan verschillende runtime-indexen hebben op servers met andere mods of registries.

BELANGRIJK GEDRAG

  • Als de bestemming de oorspronkelijke kwaliteit kent, wordt die correct gereconstrueerd.
  • Kan die niet worden opgelost, dan wordt een veilige Common-fallback gebruikt terwijl de oorspronkelijke identiteit waar mogelijk behouden blijft.
  • Wanneer de kwaliteit weer beschikbaar is, kan ze worden hersteld.

HOOFDSTUK 05 · 1 VOORBEELDEN

Diagnostiek

ItemQuality-mapping kan worden gelogd als twee servers kwaliteiten anders oplossen.

01GEBRUIK

Mappingdiagnostiek

Bij verschillende registries helpen mappinglogs om ItemQuality-namen en indexen te vergelijken.

GEBRUIK
ItemQuality-mappingdiagnostiek
→ alleen voor onderzoek inschakelen
→ server A / server B vergelijken
→ na de test uitschakelen

Optionele diagnostiek

WAT HET DOET

Bij verschillende registries helpen mappinglogs om ItemQuality-namen en indexen te vergelijken.

BELANGRIJK GEDRAG

  • Diagnostiek helpt registryverschillen verklaren; normaal gebruik vereist dit niet.
  • Laat gedetailleerde logging niet zonder reden aan staan.
  • Deze pagina krijgt exacte configuratievelden zodra de huidige modrepository is uitgelijnd.

Voordat je een voorbeeld gebruikt

Het hoofddoel is profielveiligheid, niet simpelweg slots kopiëren.

ItemQuality-behoud is speciaal ontworpen voor netwerken met verschillende registries.

De beschrijvende diagrammen kunnen door de echte configuratie worden vervangen zodra de modrepository is uitgelijnd.

NAAR BOVEN