HyTari Studios · Virallinen opas

Server Inventory Sync

Synkronoi inventaariot palvelimien välillä ilman riippuvuutta runtime-indekseistä.

Tämä perusopas kuvaa jo dokumentoidun toiminnan: jaettu inventaario, pelaajaprofiili, anti-dupe-locking ja semanttinen ItemQuality-säilytys eri registryjen välillä.

ALOITA OPAS MOD-SIVU

ENNEN KUIN ALOITAT

Aloitus

VAIHE 01

Asenna osallistuville palvelimille

Käytä samaa versiota solmuissa, joiden tulee jakaa profiili.

VAIHE 02

Yhdistä jaettu tallennus

Osallistuvien palvelimien tulee käyttää releasen odottamaa samaa data-backendiä.

VAIHE 03

Testaa täydellinen transfer

Tarkista inventaario, varusteet ja laadut ennen verkon avaamista.

Tämä perusopas ei keksi määrityskenttiä: nykyinen mod-repository on tyhjä, joten tarkat JSON-tiedot lisätään vasta source/release-buildin tarkistuksen jälkeen.

LUKU 01 · 1 ESIMERKIT

Mitä synkronoidaan

Inventaario, armor, backpack, lisäslotit ja yhteensopiva profiilidata.

01VIRTA

Jaettu profiili palvelimien välillä

Modi pitää tuetut profiilielementit synkronoituina osallistuvien palvelimien välillä.

VIRTA
Palvelin A
  ↓ tallenna profiili
Jaettu tietokanta
  ↓ lataa profiili
Palvelin B

Modin toiminta

MITÄ SE TEKEE

Modi pitää tuetut profiilielementit synkronoituina osallistuvien palvelimien välillä.

TÄRKEÄ TOIMINTA

  • Tavoite on inventaarion jatkuvuus hubin, survivalin, dungeonien, areenoiden ja muiden palvelimien välillä.
  • Inventaario, armor, backpackit ja tuetut lisäslotit sisältyvät.
  • Yhteensopivien modien profiilidata voidaan synkronoida, kun integraatio tukee sitä.

LUKU 02 · 1 ESIMERKIT

Synkronointivirta

Lataus, tallennus ja transferit noudattavat suojattua prosessia.

01JÄRJESTYS

Suojattu lataus ja tallennus

Profiili ladataan ja tallennetaan hallituissa kohdissa samanaikaisten ylikirjoitusten estämiseksi.

JÄRJESTYS
JOIN / TRANSFER
→ hanki lock
→ lataa profiili
→ gameplay
→ autosave / lopullinen tallennus
→ vapauta lock

Runtime-toiminta

MITÄ SE TEKEE

Profiili ladataan ja tallennetaan hallituissa kohdissa samanaikaisten ylikirjoitusten estämiseksi.

TÄRKEÄ TOIMINTA

  • Järjestelmä ei häiritse tavallisia sisäisiä world-vaihtoja.
  • Autosave pienentää mahdollista tietojen menetysikkunaa.
  • Loading/lock-viestit voivat ilmoittaa pelaajalle, kun profiili ei vielä ole saatavilla.

LUKU 03 · 1 ESIMERKIT

Lockit ja anti-dupe

Profiili suojataan samanaikaiselta käytöltä kriittisissä vaiheissa.

01SÄÄNTÖ

Lock samanaikaista käyttöä vastaan

Kaksi palvelinta ei saa muokata samaa profiilia yhtä aikaa.

SÄÄNTÖ
1 pelaaja-UUID
→ 1 aktiivinen profiili
→ 1 kelvollinen lock
→ ei samanaikaista käyttöä

Sisäinen turvallisuus

MITÄ SE TEKEE

Kaksi palvelinta ei saa muokata samaa profiilia yhtä aikaa.

TÄRKEÄ TOIMINTA

  • Locking suojaa duplikoinnilta ja palvelimien välisiltä race conditioneilta.
  • Transfer-logiikan tulee suorittaa save ja handoff loppuun ennen kuin toinen palvelin käyttää profiilia.
  • Vanhentuneet lockit tai virheet käsitellään turvallisuustilanteina, ei syynä ladata kahta kopiota.

LUKU 04 · 1 ESIMERKIT

Turvallinen ItemQuality

Laadut tunnistetaan semanttisesti eikä vain runtime-indekseillä.

01ESIMERKKI

Semanttinen ItemQuality-säilytys

Sama laatu voi käyttää eri runtime-indeksiä palvelimilla, joilla on eri modit tai registryt.

ESIMERKKI
Palvelin A: CustomEpic = runtime-indeksi 12
Palvelin B: CustomEpic = runtime-indeksi 27

Sync käyttää laadun identiteettiä, ei vain 12/27.

ItemQuality mapping

MITÄ SE TEKEE

Sama laatu voi käyttää eri runtime-indeksiä palvelimilla, joilla on eri modit tai registryt.

TÄRKEÄ TOIMINTA

  • Jos kohde tuntee alkuperäisen laadun, se rekonstruoidaan oikein.
  • Jos sitä ei voida ratkaista, käytetään turvallista Common-fallbackia ja alkuperäinen identiteetti säilytetään mahdollisuuksien mukaan.
  • Kun laatu tulee taas saataville, se voidaan palauttaa.

LUKU 05 · 1 ESIMERKIT

Diagnostiikka

ItemQuality-mapping voidaan lokittaa, kun kaksi palvelinta ratkaisee laadut eri tavalla.

01KÄYTTÖ

Mapping-diagnostiikka

Eri registryissä mapping-lokit auttavat vertaamaan ItemQuality-nimiä ja indeksejä.

KÄYTTÖ
ItemQuality-mapping-diagnostiikka
→ ota käyttöön vain tutkimusta varten
→ vertaa palvelin A / palvelin B
→ poista käytöstä testin jälkeen

Valinnainen diagnostiikka

MITÄ SE TEKEE

Eri registryissä mapping-lokit auttavat vertaamaan ItemQuality-nimiä ja indeksejä.

TÄRKEÄ TOIMINTA

  • Diagnostiikka auttaa ymmärtämään registry-eroja, mutta sitä ei tarvita normaalissa käytössä.
  • Älä jätä yksityiskohtaista lokitusta päälle ilman syytä.
  • Sivulle lisätään tarkat määrityskentät, kun mod-repository on yhtenäistetty.

Ennen esimerkin käyttöä

Päätavoite on profiilin turvallisuus, ei vain slottien kopiointi.

ItemQuality-säilytys on suunniteltu erityisesti verkoille, joissa registryt eroavat.

Kuvaavat kaaviot voidaan korvata oikealla määrityksellä, kun mod-repository on yhtenäistetty.

TAKAISIN YLÖS