Inventar-Sync, Item-Tracking & Sperren

Drei aufeinander aufbauende Module:

Einschalten

• Module auf jedem Spielserver einschalten, z. B. per Preset survival oder economy (siehe Module & Presets).
• inventory-sync zusätzlich auf dem Proxy einschalten: /invsee läuft dort, löst Offline-Ziele und Spieler auf anderen Servern auf und öffnet das GUI auf dem Server des Betrachters.
• Alle Server und die REST-API brauchen dieselbe MySQL-Datenbank.
• Alles steht im Abschnitt inventory-sync der config.yml (gleiche Datei auf Spigot und Proxy).

Inventar-Sync

inventory-sync:
  enabled: true
  mode: separate          # separate = jeder Server eigenes Inventar, global = eines fürs ganze Netz
  groups: {}              # nur bei separate: Server mit gemeinsamem Inventar
  #  survival: [survival-1, survival-2]
  parts:
    inventory: true
    armor: true
    offhand: true
    enderchest: true
    experience: true
    health: true
    hunger: true
    effects: true
    gamemode: false
  autosave-seconds: 60       # Snapshot-Takt für Online-Spieler; Quit speichert immer sofort
  join-load-timeout-ms: 3000 # so lange wartet der neue Server auf den Quit-Save des alten

Scope heißt der Schlüssel eines gespeicherten Inventars: der Servername (separate), der Gruppenname oder global. Dashboard und /invsee <Spieler> <Scope> zeigen alle Scopes, die ein Spieler je hatte.

Serverwechsel bei global/Gruppen: Der alte Server schreibt beim Quit den Snapshot und gibt die Sync-Sitzung frei. Der neue Server friert den Spieler so lange ein (kein Inventar-Zugriff, kein Aufheben), lädt dann und wendet den Stand an. Nach einem Absturz gibt jeder Server beim Start seine hängenden Sitzungen frei.

Ingame-Befehle

Schutz-Bypass für Mods (Modul inventory-sync, kein Befehl): Mods interagieren ganz normal. Verbietet etwas einen Rechtsklick – eine Kisten-Sperre, PlotSquared, WorldGuard, GriefPrevention –, hebt Eternal das Verbot nur für die Kategorien auf, für die der Spieler ein Recht hat. Vanilla macht dann den Rest (Tür geht auf, Kiste öffnet sich live mit Animation). Was der Mod sowieso darf, bleibt unverändert.

eternal.inspect.* vergibt alles. Ein gesperrtes Drachenei wird nie freigegeben (ein Klick würde es teleportieren). Fällt ein gesperrter Block mit Schwerkraft (Drachenei, Amboss, Sand …), weil die Stütze fehlt, fällt er ganz normal – die Sperre wandert mit an die Landestelle. Würde er dabei zu einem Item zerbrechen (Fackel-Trick), springt er an seinen Platz zurück.

Wird ein Offline-Inventar bearbeitet, hält das GUI eine Sperre. Joint der Spieler, schließt es sich; der Spieler bekommt eine Info über die Änderung. Kann die Sperre nicht genommen werden (Spieler ist online, jemand anderes bearbeitet), bleibt das GUI schreibgeschützt.

Rang-Schutz

Wie bei Strafen braucht der Betrachter eine höhere Stufe als das Ziel (Stufe = Maximum aus eternal.tier.N und Rang-Priorität). Das gilt ingame und im Dashboard, für Inventare und Item-Historien (dort zählt der aktuelle Besitzer). eternal.sync.bypass oder eternal.bypass heben den Schutz auf.

Zwischenlager

Das Zwischenlager (Teil von inventory-sync) fängt auf, was bei vollem Inventar nicht mehr hineinpasst. Jeder Spieler schaltet es selbst ein: /settings → Zwischenlager (expandedinv.collect, Standard aus; der Eintrag erscheint mit eternal.expandedinv.use, siehe Spieler-Einstellungen).

• Einsammeln: Ist es an und das Inventar voll, landen Items, über die du läufst, im Zwischenlager. Auch Auto-Aufsammeln-Drops, die nicht mehr ins Inventar passen, kommen dorthin.
• Netzwerkweit: Das Lager liegt in der Datenbank und ist auf allen Servern dasselbe – höchstens 270 Stapel (6 Seiten à 45).
• Nur entnehmen: /expandedinv bzw. /ei öffnet es. Ein Klick legt den Stapel ins Inventar, wenn er komplett hineinpasst. Hineinlegen geht nie.
• Lager voll: Der Spieler bekommt eine Meldung, die Items bleiben am Boden liegen.
• Regeln gelten weiter: Jedes Einsammeln löst das normale Aufhebe-Ereignis aus – Item-Sperren, Lobby-Schutz, der Perk no_pickup (siehe Perks) und das Item-Tracking greifen wie beim normalen Aufheben.
• Dupe-sicher über Server hinweg: Änderungen laufen mit optimistischer Versionierung; gibt es zwischen zwei Servern einen Konflikt, wird die Änderung erneut versucht.

Fremde Zwischenlager

Jede Entnahme aus einem fremden Lager wird in der Konsole geloggt. Es gilt derselbe Rang-Schutz wie bei /invsee; eternal.sync.bypass hebt ihn auf.

Im Dashboard zeigt die Inventar-Seite eines Spielers eine Karte Zwischenlager mit allen Stapeln und ihrem Sperr-Status; ein Klick auf ein Item öffnet seine Historie (Recht eternal.web.inventory.view, API GET /players/{name}/expanded-inv).

Item-Tracking

Jedes Item bekommt eine unsichtbare ID (eternal_item_id im PersistentDataContainer; auf 1.8–1.13 in einer versteckten Lore-Zeile, siehe Versionen). Geloggt wird, wer es wann hatte, in welcher Kiste es liegt (mit Koordinaten und wer es hineingelegt hat) und Serverwechsel.

inventory-sync:
  item-tracking:
    enabled: true
    stack-mode: id                 # id = jeder Stapel hat eine Stack-ID, log = nur Verlauf pro Material
    stack-log-materials: []        # immer im log-Modus, z. B. [COBBLESTONE, DIRT, NETHERRACK]
    log-stack-hopper-moves: false  # Hopper-Merges von Stack-ID-Items loggen (viele Zeilen)
    container-flush-ticks: 10      # Live-Kisteninhalt alle X Ticks schreiben, 0 = nur beim Schließen
    container-exclude-types: []    # z. B. [HOPPER] bei riesigen Farmen
    tracked-blocks: [SPAWNER, DRAGON_EGG, BEACON, ...]  # behalten beim Platzieren ihre ID
    track-frames: true             # Items in Rahmen loggen
    log-hopper-moves: true
    scan-interval-seconds: 3       # Scan nach neuen Items ohne Ereignis (/give, andere Plugins)
    lock-refresh-seconds: 5        # Sperren aus der DB nachladen

Stack-IDs: Ein geteilter Stapel behält die ID nur auf dem größeren Teil, der andere bekommt sofort eine neue (Ereignis SPLIT, im Kreativmodus CLONED). Kommen Items zusammen (Klick, Shift-Klick, Doppelklick, Aufheben, Hopper, Ofen, Crafting), übernehmen sie die ID des Ziel-Stapels (MERGE); geht ein ganzer Stapel in einem anderen auf, wird seine ID geschlossen (STACKED).

Ereignisse (Auswahl): REGISTER, PICKUP, DROP, DEATH_DROP, DESPAWN, CONTAINER_PUT/CONTAINER_TAKE, HOPPER_MOVE, CONTAINER_BROKEN, SERVER_SWITCH, LOCK/UNLOCK, MERGE, SPLIT, STACKED, DESTROYED (mit Ursache: Lava, Feuer, Explosion, Kaktus, Void, Blitz, Haltbarkeit, verbraucht), DELETED (Vernichtet durch das Team), FRAME_PUT/FRAME_TAKE, PLACED/BROKEN, TRADE (siehe Party, Freunde & Clans).

Kisten-Register: Jede Kiste, jeder Rahmen und jeder platzierte Spezialblock bekommt eine Kisten-ID (#12). Inhalte werden live mitgeschrieben – Spieler-Klicks, Hopper, Werfer, Öfen, Braustände, Platzieren, Abbauen, Explosionen – und alle container-flush-ticks in einer Transaktion gespeichert. Nicht erfasst werden Inventare von Entities (Lore mit Kiste, Esel, Lama).

Bekannte Lücken: Ergebnisse aus Steinsäge, Amboss, Schleifstein, Webstuhl und Villager-Handel landen als eigener Stapel und übernehmen die ID erst beim nächsten Scan.

Vernichten (/deleteitem)

/deleteitem öffnet ein GUI: Items hineinlegen, schließen, dann fragt der Chat 10 Sekunden lang nach dem Grund (keine Antwort = ohne Grund). Jeder Stapel wird als DELETED mit Spieler, Zeit und Grund geloggt; ungetrackte Items bekommen vorher eine ID. Herausnehmen geht nur mit eternal.sync.delete.item.take – ohne dieses Recht ist Hineinlegen endgültig.

Sperren

Doppelkisten: Eine Sperre auf einer Hälfte schützt beide. Abgetrennte Teile eines gesperrten Stapels erben die Sperre. eternal.sync.lock.bypass ignoriert alle Sperren. Sperren aus dem Dashboard oder von anderen Servern greifen nach spätestens lock-refresh-seconds.

Auto-Sperren (Dashboard, Recht eternal.web.thresholds.manage): Regeln „ab Menge X sperren“ pro Stapel, Kiste, Inventar oder Spieler, für ein Material oder *, optional nur für einen Spieler, bei Kisten optional die Kiste selbst (Soft). Die API prüft alle 15 s. Besitzer mit eternal.sync.lock.bypass werden übersprungen.

Dashboard

Jedes Item mit ID hat einen Besitzer (der letzte Spieler, der es in der Hand hatte). Liegt es in einer geteilten Kiste, bleibt es ihm zugeordnet.

Rechte

Ingame gelten zusätzlich die plugin.yml-Standards (z. B. eternal.sync.delete.item: op), solange Eternal Perms nichts festlegt. Siehe Rechte-Referenz.

Typische Stolperfallen

• /invsee findet Offline-Spieler nicht: inventory-sync fehlt auf dem Proxy.
• Inventar „springt zurück“ bei global: Der alte Server speichert zu langsam – join-load-timeout-ms erhöhen, Datenbank-Latenz prüfen.
• Riesige Tabellen durch Farmen: Massenware in stack-log-materials, log-stack-hopper-moves: false lassen, ggf. container-exclude-types: [HOPPER].
• Item-Icons fehlen im Dashboard: Die Icons kommen von assets.mcasset.cloud. In eternal-web/src/app/core/api.config.ts lässt sich textureUrl auf einen eigenen Host umstellen oder leeren (dann nur Material-Text).
• Bearbeitete Offline-Inventare kommen nicht an: Der Spieler muss auf einem Server des passenden Scopes joinen.