HyTari Studios · Offizielle Anleitung

Server Inventory Sync

Synchronisiere Inventare zwischen Servern, ohne dich auf Runtime-Indizes zu verlassen.

Diese Basisanleitung beschreibt das bereits dokumentierte Verhalten der Mod: gemeinsames Inventar, Spielerprofil, Anti-Duplikations-Locking und semantische ItemQuality-Erhaltung zwischen unterschiedlichen Registries.

ANLEITUNG STARTEN MOD-SEITE

BEVOR DU BEGINNST

Erste Schritte

SCHRITT 01

Auf beteiligten Servern installieren

Nutze dieselbe Version auf allen Knoten, die das Profil teilen sollen.

SCHRITT 02

Gemeinsamen Speicher verbinden

Beteiligte Server mĂŒssen dasselbe von der Release erwartete Daten-Backend nutzen.

SCHRITT 03

Kompletten Transfer testen

PrĂŒfe Inventar, AusrĂŒstung und QualitĂ€tswerte vor Öffnung des Netzwerks.

Diese Basisanleitung erfindet bewusst keine Konfigurationsfeldnamen: Das aktuelle Mod-Repository ist leer; exakte JSON-Details werden erst nach PrĂŒfung von Source/Release-Binary ergĂ€nzt.

KAPITEL 01 · 1 BEISPIELE

Was synchronisiert wird

Inventar, RĂŒstung, Backpack, zusĂ€tzliche Slots und kompatible Profildaten.

01ABLAUF

Geteiltes Profil zwischen Servern

Die Mod hĂ€lt unterstĂŒtzte Profilelemente auf den teilnehmenden Servern synchron.

ABLAUF
Server A
  ↓ Profil speichern
Gemeinsame Datenbank
  ↓ Profil laden
Server B

Mod-Verhalten

WAS ES MACHT

Die Mod hĂ€lt unterstĂŒtzte Profilelemente auf den teilnehmenden Servern synchron.

WICHTIGES VERHALTEN

  • Ziel ist InventarkontinuitĂ€t zwischen Hub, Survival, Dungeons, Arenen und anderen Servern.
  • Inventar, RĂŒstung, Backpacks und unterstĂŒtzte Zusatzslots sind enthalten.
  • Profildaten kompatibler Mods können synchronisiert werden, wenn die Integration dies unterstĂŒtzt.

KAPITEL 02 · 1 BEISPIELE

Synchronisationsablauf

Laden, Speichern und Transfers folgen einem geschĂŒtzten Ablauf.

01SEQUENZ

GeschĂŒtztes Laden und Speichern

Das Profil wird an kontrollierten Punkten im Spieler-Lifecycle geladen und gespeichert, um parallele Überschreibungen zu vermeiden.

SEQUENZ
JOIN / TRANSFER
→ Lock ĂŒbernehmen
→ Profil laden
→ Spiel
→ Autosave / finales Speichern
→ Lock freigeben

Laufzeitverhalten

WAS ES MACHT

Das Profil wird an kontrollierten Punkten im Spieler-Lifecycle geladen und gespeichert, um parallele Überschreibungen zu vermeiden.

WICHTIGES VERHALTEN

  • Normale interne Weltwechsel sollen nicht unterbrochen werden.
  • Automatisches Speichern verkleinert das mögliche Datenverlustfenster.
  • Loading-/Lock-Meldungen können Spieler informieren, solange das Profil noch nicht verfĂŒgbar ist.

KAPITEL 03 · 1 BEISPIELE

Locks und Anti-Duplikation

Das Profil wird in kritischen Phasen vor parallelem Zugriff geschĂŒtzt.

01REGEL

Lock gegen Parallelzugriff

Ein Profil darf nicht gleichzeitig von zwei Servern verÀndert werden.

REGEL
1 Spieler-UUID
→ 1 aktives Profil
→ 1 gĂŒltiger Lock
→ kein paralleler Zugriff

Interne Sicherheit

WAS ES MACHT

Ein Profil darf nicht gleichzeitig von zwei Servern verÀndert werden.

WICHTIGES VERHALTEN

  • Locking schĂŒtzt vor Duplikationen und Race Conditions zwischen Servern.
  • Die Transferlogik muss Speichern und Übergabe abschließen, bevor ein anderer Server das Profil verwendet.
  • Abgelaufene Locks oder Fehler werden als Sicherheitsbedingungen behandelt, nicht als Grund, zwei Kopien zu laden.

KAPITEL 04 · 1 BEISPIELE

Sichere ItemQuality-Behandlung

QualitĂ€ten werden semantisch identifiziert statt nur ĂŒber Runtime-Indizes.

01BEISPIEL

Semantische ItemQuality-Erhaltung

Dieselbe QualitÀt kann auf Servern mit unterschiedlichen Mods oder Registries verschiedene Runtime-Indizes besitzen.

BEISPIEL
Server A: CustomEpic = Runtime-Index 12
Server B: CustomEpic = Runtime-Index 27

Sync verwendet die QualitÀtsidentitÀt, nicht nur 12/27.

ItemQuality mapping

WAS ES MACHT

Dieselbe QualitÀt kann auf Servern mit unterschiedlichen Mods oder Registries verschiedene Runtime-Indizes besitzen.

WICHTIGES VERHALTEN

  • Kennt das Ziel die ursprĂŒngliche QualitĂ€t, wird sie korrekt rekonstruiert.
  • Kann sie nicht aufgelöst werden, wird ein sicherer Common-Fallback verwendet und die ursprĂŒngliche IdentitĂ€t soweit möglich erhalten.
  • Wird die QualitĂ€t spĂ€ter verfĂŒgbar, kann sie wiederhergestellt werden.

KAPITEL 05 · 1 BEISPIELE

Diagnose

ItemQuality-Mapping kann geloggt werden, wenn zwei Server QualitÀten unterschiedlich auflösen.

01VERWENDUNG

Mapping-Diagnose

Bei unterschiedlichen Registries helfen Mapping-Logs, ItemQuality-Namen und Indizes zu vergleichen.

VERWENDUNG
ItemQuality-Mapping-Diagnose
→ nur zur Untersuchung aktivieren
→ Server A / Server B vergleichen
→ nach dem Test deaktivieren

Optionale Diagnose

WAS ES MACHT

Bei unterschiedlichen Registries helfen Mapping-Logs, ItemQuality-Namen und Indizes zu vergleichen.

WICHTIGES VERHALTEN

  • Die Diagnose erklĂ€rt Registry-Unterschiede und ist fĂŒr den Normalbetrieb nicht erforderlich.
  • Lass detailliertes Logging nicht ohne Grund aktiviert.
  • Diese Seite erhĂ€lt die exakten Konfigurationsfelder, sobald das aktuelle Mod-Repository abgeglichen ist.

Vor der Verwendung eines Beispiels

Kernziel ist Profilsicherheit, nicht nur das Kopieren von Slots.

Die ItemQuality-Erhaltung ist speziell fĂŒr Netzwerke mit unterschiedlichen Registries gedacht.

Sobald das Mod-Repository abgeglichen ist, können die beschreibenden Diagramme durch die reale Konfiguration ersetzt werden.

NACH OBEN