ERWEITERUNG DES BESTEHENDEN LEVELSMP-PLUGINS
Diese Anforderungen sind zusätzlich zum bereits bestehenden LevelSMP-Prompt umzusetzen.
Wichtig: Bereits vorhandene Funktionen des Plugins sollen nicht entfernt, verändert oder neu erfunden werden. Diese Erweiterung ergänzt lediglich die folgenden Punkte.
⸻
- Multiplayer-Heart-Withdraw
Das bestehende Heart-Withdraw-System soll vollständig für Multiplayer-Nutzung ausgelegt sein.
Spieler sollen ihre eigenen Herzen sicher entnehmen und als Item erhalten können.
Beispiel:
/withdraw <anzahl>
Anforderungen:
* Ein Spieler kann nur Herzen von seinem eigenen Konto entnehmen. * Die entnommenen Herzen werden als speziell geschütztes Item ausgegeben. * Das Item muss über PersistentDataContainer (PDC) eindeutig als LevelSMP-Heart-Item erkannt werden. * Das Item darf nicht einfach durch Umbenennen oder Nachbauen gefälscht werden können. * Beim Entnehmen müssen die Daten des Spielers sofort korrekt gespeichert werden. * Die tatsächlichen Minecraft-Herzen und der gespeicherte Wert müssen immer synchron bleiben. * Es darf niemals möglich sein, durch schnelles Klicken, Lag oder gleichzeitige Aktionen mehr Herzen zu erhalten als vorhanden. * Das System muss auch bei mehreren Spielern gleichzeitig sicher funktionieren. * Alle Änderungen müssen thread-/server-sicher umgesetzt werden.
Multiplayer-Sicherheit
Besonders wichtig:
* Zwei Spieler dürfen sich nicht gegenseitig Daten überschreiben. * Jeder Spieler besitzt einen vollständig getrennten Datensatz. * UUID statt Spielername als primärer Identifier. * Spielername darf nur zur Anzeige verwendet werden. * Bei gleichzeitigen Aktionen müssen Race Conditions verhindert werden. * Daten dürfen beim Join/Quit/Reload nicht verloren gehen. * Nach jedem erfolgreichen Withdraw müssen die aktuellen Daten korrekt persistiert werden.
⸻
- Multiplier-Withdraw
Auch der bestehende Multiplier-Withdraw soll vollständig multiplayerfähig sein.
Beispiel:
/multiplier withdraw <wert>
Dabei muss der Spieler einen Teil seines eigenen Multipliers sicher entnehmen können.
Anforderungen:
* Der Wert wird vom persönlichen Multiplier des Spielers abgezogen. * Der entnommene Wert wird als spezielles LevelSMP-Item ausgegeben. * Das Item wird über PDC abgesichert. * Gefälschte Items dürfen nicht akzeptiert werden. * 0.0x darf nicht durch einen Fehler zu einem ungültigen oder negativen Zustand führen. * Der Multiplier darf niemals negativ werden. * Das System muss mit Dezimalwerten korrekt umgehen. * Floating-Point-Fehler müssen vermieden werden. * Die Anzeige und der gespeicherte Wert müssen immer identisch sein. * Bei gleichzeitigem Zugriff mehrerer Spieler dürfen keine Daten vermischt werden.
⸻
- Multiplier-Transfer zwischen Spielern
Das Multiplayer-System soll außerdem den Transfer von Multipliern zwischen Spielern unterstützen.
Beispielsweise:
/multiplier give <spieler> <wert>
oder entsprechend der bereits vorhandenen Command-Struktur.
Anforderungen:
* Der Zielspieler wird sicher über UUID identifiziert. * Der Multiplier wird ausschließlich dem vorgesehenen Spieler gutgeschrieben. * Der Sender darf niemals mehr verlieren als tatsächlich vorhanden ist. * Der Empfänger darf niemals einen falschen oder doppelten Betrag erhalten. * Der Transfer muss atomar behandelt werden. * Bei einem Fehler darf nicht nur eine Seite des Transfers durchgeführt werden. * Der Transfer muss sofort in der Actionbar/PlaceholderAPI-Anzeige sichtbar sein. * Die Daten müssen dauerhaft gespeichert werden.
⸻
- PlaceholderAPI-Unterstützung
Das Plugin soll eine saubere und vollständige PlaceholderAPI-Integration besitzen.
Es soll ein eigener PlaceholderAPI-Expansion-Mechanismus verwendet werden, sofern dies architektonisch sinnvoll ist.
Mindestens folgende Placeholder sollen verfügbar sein:
* %levelsmp_level% * %levelsmp_xp% * %levelsmp_xp_to_next% * %levelsmp_hearts% * %levelsmp_max_hearts% * %levelsmp_multiplier% * %levelsmp_lives% * %levelsmp_deathban%
Zusätzlich können sinnvolle bereits vorhandene Werte des Plugins als Placeholder bereitgestellt werden.
Anforderungen:
* Placeholder funktionieren auch für andere Spieler, sofern der Kontext dies unterstützt. * Unbekannte oder nicht verfügbare Daten dürfen keinen Fehler verursachen. * Dezimalwerte müssen korrekt formatiert werden. * Die Placeholder müssen den tatsächlichen aktuellen Plugin-Wert verwenden. * Änderungen an Level, XP, Herzen, Leben oder Multiplier sollen ohne Serverneustart korrekt dargestellt werden. * Keine unnötigen Datenbank-/Dateizugriffe bei jedem Placeholder-Aufruf. * Caching darf verwendet werden, solange dadurch keine veralteten Werte angezeigt werden.
⸻
- Actionbar-Synchronisation
Die bestehende Actionbar soll mit allen relevanten Systemen synchron bleiben.
Insbesondere:
* Level * XP * XP bis zum nächsten Level * Herzen * Multiplier * Leben * Deathban-Status
Wenn sich ein Wert ändert, muss die Anzeige zeitnah aktualisiert werden.
Beispiele:
* Spieler erhält XP → Actionbar aktualisiert sich. * Spieler verliert Multiplier → Actionbar aktualisiert sich. * Spieler erhält/entnimmt Herzen → Herz-Anzeige aktualisiert sich. * Spieler wird deathgebanned → entsprechender Status wird korrekt angezeigt.
⸻
- Zentrale Datenverwaltung
Alle Spielerdaten müssen zentral verwaltet werden.
Jeder Spieler besitzt einen eigenen Datensatz, beispielsweise anhand seiner UUID:
player-uuid: name: "PlayerName" level: 10 xp: 250 hearts: 20 max-hearts: 20 multiplier: 1.5 lives: 3 deathban: false
Die tatsächliche Struktur darf angepasst werden, wenn sie technisch besser ist.
Wichtig ist:
* UUID als eindeutiger Schlüssel. * Keine Vermischung von Spielerdaten. * Sichere Speicherung. * Sichere Änderungen. * Keine Datenverluste. * Keine Race Conditions. * Änderungen müssen zentral über Manager/Services laufen.
Beispielsweise:
* PlayerDataManager * HeartManager * MultiplierManager * LevelManager * DeathBanManager
Die genaue Architektur darf sinnvoll angepasst werden.
⸻
- PDC-Sicherheit für alle speziellen Items
Alle vom Plugin erzeugten Items müssen über den PersistentDataContainer eindeutig identifizierbar sein.
Das betrifft insbesondere bestehende:
* Heart-Items * Multiplier-Items * XP-/Level-bezogene Items * sonstige LevelSMP-Spezialitems
Nicht ausreichend sind:
* Itemname * Lore * Material * CustomModelData allein
Ein Spieler darf ein Item nicht durch einfaches Umbenennen oder Nachbauen fälschen können.
Beim Einlösen eines Items muss immer der PDC geprüft werden.
⸻
- Commands und Multiplayer-Validierung
Alle bestehenden Commands müssen multiplayerfähig und sicher sein.
Bei Spieler-Argumenten:
* Online-Spieler korrekt erkennen. * UUID verwenden. * Offline-Spieler nur unterstützen, wenn die jeweilige Funktion dies erlaubt. * Spieler darf nicht versehentlich seine eigenen Daten verändern, wenn ein anderer Spieler angegeben wurde. * Fehlende Spieler müssen eine verständliche Meldung erhalten. * Ungültige Zahlen/Dezimalwerte müssen sauber abgefangen werden. * Negative Werte müssen verhindert werden. * Zu große Werte müssen verhindert werden. * Keine Serverfehler bei falschen Eingaben.
⸻
- Permissions
Alle bestehenden Permissions sollen sauber umgesetzt werden.
Beispielsweise:
* levelsmp.admin * levelsmp.withdraw * levelsmp.multiplier * levelsmp.multiplier.withdraw * levelsmp.multiplier.give * levelsmp.reload * levelsmp.deathban * levelsmp.bypass
Die genaue Permission-Struktur darf an die bereits vorhandenen Commands angepasst werden.
⸻
- Messages
Alle neuen Meldungen müssen über messages.yml konfigurierbar sein.
Keine fest im Java-Code eingebrannten sichtbaren Spielertexte.
Dazu gehören beispielsweise:
* erfolgreicher Withdraw * nicht genügend Herzen * erfolgreicher Multiplier-Withdraw * erfolgreicher Transfer * unbekannter Spieler * ungültiger Wert * fehlende Permission * PDC-/Item-Fehler * allgemeine Fehlermeldungen
⸻
- Performance
Das Plugin muss für einen Multiplayer-Server ausgelegt sein.
Daher:
* Keine unnötigen synchronen Dateioperationen bei jedem Event. * Keine unnötigen Schleifen über alle Spieler. * Keine dauerhaften Tasks ohne Zweck. * Keine unnötigen Berechnungen bei jedem Tick. * Daten möglichst im Speicher verwalten und kontrolliert speichern. * Bukkit-/Paper-API nur dort synchron verwenden, wo es erforderlich ist. * Asynchrone Speicherung darf genutzt werden, sofern keine Bukkit-API unsicher asynchron aufgerufen wird.
⸻
- Fehler- und Datenverlustschutz
Besonders kritisch:
Wenn ein Spieler gleichzeitig:
* Herzen entnimmt, * Multiplier entnimmt, * Multiplier transferiert, * XP erhält, * Level aufsteigt, * stirbt, * einen Deathban erhält
dürfen sich diese Aktionen nicht gegenseitig überschreiben.
Jede Änderung muss auf dem aktuellsten Datensatz basieren.
Beispiel:
Ein Spieler besitzt 2.0x.
Er kann nicht durch zwei gleichzeitig ausgelöste Aktionen jeweils 1.5x entnehmen und dadurch insgesamt 3.0x erhalten.
Der maximale verfügbare Wert muss atomar geprüft und anschließend verändert werden.
⸻
- Reload-Kompatibilität
/levelsmp reload darf keine Spielerdaten zurücksetzen.
Nach einem Reload müssen weiterhin korrekt funktionieren:
* Hearts * Level * XP * Multiplier * Lives * Deathban * Withdraw-System * Multiplier-System * PlaceholderAPI * Actionbar * alle bestehenden Systeme
Falls Manager neu geladen werden, müssen bereits geladene Spielerdaten korrekt übernommen bzw. neu geladen werden.
⸻
WICHTIGE ABSCHLUSSANWEISUNG
Diese Anforderungen sind eine Erweiterung des bereits bestehenden LevelSMP-Projekts.
Nicht bereits vorhandene Features erneut erfinden oder doppelt implementieren.
Die bestehenden Funktionen sollen erhalten bleiben.
Der Fokus dieser Erweiterung liegt insbesondere auf:
Multiplayer-Sicherheit, Heart-Withdraw, Multiplier-Withdraw, Multiplier-Transfers, PlaceholderAPI, Actionbar-Synchronisation, PDC-Sicherheit, zentraler Datenverwaltung, Performance und Schutz vor Datenverlust/Race Conditions.
Die bereits vorhandenen Recipes-/Recipe-GUI-Funktionen und Beacon-of-Life-Funktionen werden hier NICHT erneut beschrieben, da diese bereits im bestehenden Prompt enthalten sind.
Keine zusätzlichen Features hinzufügen, die nicht in diesem bestehenden Prompt oder dem ursprünglichen LevelSMP-Prompt gefordert wurden.