# MC.SMP PvP TIMER
## Professionelle Fabric-Mod mit Countdown, Bossbar, eigenen Sounds und automatischer PvP-Steuerung
### 1. PROJEKTZIEL
Entwickle eine vollständige, professionelle und zuverlässige Minecraft-Server-Mod für meinen Multiplayer-Server MC.SMP.
Die Mod soll es Administratoren ermöglichen, PvP zeitgesteuert zu aktivieren, zu deaktivieren, zu planen und zu verwalten.
Spieler sollen jederzeit erkennen können, ob PvP aktiv ist, wann sich der Status ändert und wie viel Zeit bis zur nächsten Änderung verbleibt.
Zusätzlich soll die Mod einen separaten Erinnerungs-Timer besitzen, der zu einem festgelegten Zeitpunkt eine Benachrichtigung ausgibt, ohne den PvP-Status zu verändern.
Das gesamte System soll hochwertig gestaltet sein und sich optisch sowie akustisch wie eine professionelle Erweiterung für MC.SMP anfühlen.
Die Mod darf das normale Minecraft-Gameplay nicht unnötig verändern.
### 2. TECHNISCHE ANFORDERUNGEN
* Minecraft Java Edition 1.21.11.
* Fabric als Modloader.
* Java als Programmiersprache.
* Fabric Dedicated Server als Zielplattform.
* Eindeutige Mod-ID, beispielsweise `mcsmp_pvp_timer`.
* Kompatibilität mit der tatsächlich verwendeten Minecraft- und Fabric-Version.
* Serverseitige Verwaltung sämtlicher Timer und PvP-Statusänderungen.
* Kompatibilität mit LuckPerms, sofern installiert.
* Keine verpflichtenden Client-Mods, wenn die gewünschte Funktion mit einem Vanilla-Client realisierbar ist.
* Effiziente Verarbeitung ohne unnötige Aufgaben pro Tick.
* Dauerhafte Speicherung relevanter Daten.
* Keine unnötigen Änderungen an Inventaren, Blöcken, Items oder Weltgenerierung.
Liefere vollständigen Quellcode, eine baubare Gradle-Projektstruktur, die benötigten Ressourcen und eine fertig kompilierte JAR-Datei.
Verwende ausschließlich APIs, die für die tatsächlich verwendete Minecraft-Version geeignet sind. Erfinde keine Klassen, Methoden oder Fabric-Funktionen.
---
# 3. HAUPTSYSTEM: PVР AKTIVIEREN UND DEAKTIVIEREN
Das zentrale System muss zwei Zustände verwalten:
* PvP aktiviert.
* PvP deaktiviert.
Zusätzlich muss das System wissen, ob eine zeitgesteuerte Statusänderung geplant ist.
## 3.1 PvP für eine bestimmte Zeit deaktivieren
Beispiel:
`/pvp disable 3h`
Die Mod muss folgende Schritte durchführen:
1. PvP sofort deaktivieren.
2. Einen Timer mit einer Dauer von drei Stunden erstellen.
3. Als Zielzustand „PvP aktiviert“ speichern.
4. Die Statusanzeige aktualisieren.
5. Die konfigurierte Statusnachricht ausgeben.
6. Den Sound für die PvP-Deaktivierung abspielen.
7. Nach Ablauf der drei Stunden PvP automatisch aktivieren.
8. Den Sound für die PvP-Aktivierung abspielen.
9. Die konfigurierte Abschlussmeldung ausgeben.
10. Den abgeschlossenen Countdown entfernen.
## 3.2 PvP für eine bestimmte Zeit aktivieren
Beispiel:
`/pvp enable 1h`
Die Mod muss:
1. PvP sofort aktivieren.
2. Einen Timer von einer Stunde erstellen.
3. Als Zielzustand „PvP deaktiviert“ speichern.
4. Die Statusanzeige aktualisieren.
5. Die Aktivierungsmeldung ausgeben.
6. Den Aktivierungssound abspielen.
7. Nach Ablauf der Stunde PvP automatisch deaktivieren.
8. Den Deaktivierungssound abspielen.
9. Die Abschlussmeldung ausgeben.
10. Den abgeschlossenen Countdown entfernen.
Beide Richtungen müssen vollständig unterstützt werden.
## 3.3 Dauerhafte Zustände
Folgende Befehle dürfen keinen automatischen Rückwechsel auslösen:
`/pvp enable`
`/pvp disable`
Sie setzen den gewünschten Zustand dauerhaft, bis er erneut geändert wird.
Ein vorhandener Timer muss bei einer solchen manuellen Änderung kontrolliert beendet werden, sofern kein ausdrücklich anders definierter Modus verwendet wird.
Der Administrator erhält eine Rückmeldung darüber, was mit dem bisherigen Timer passiert ist.
## 3.4 Zeitformate
Unterstütze mindestens folgende Zeitangaben:
* `30s`
* `10m`
* `1h`
* `3h`
* `1d`
* `2h30m`
* `1d12h`
Die Eingaben müssen validiert werden.
Negative Werte, Nullzeiten, ungültige Formate und unzulässig lange Zeiträume müssen verständlich abgelehnt werden.
Die maximale Timerdauer muss konfigurierbar sein.
---
# 4. HOTBAR-ACTIONBAR
Die Actionbar oberhalb der Hotbar ist die primäre Statusanzeige.
Sie muss übersichtlich, gut lesbar und auf den MC.SMP-Stil abgestimmt sein.
## 4.1 Beispiel: PvP deaktiviert
`⚔ PvP AUS | Aktivierung in 02:59:59`
## 4.2 Beispiel: PvP aktiviert
`⚔ PvP AN | Deaktivierung in 00:59:59`
## 4.3 Gestaltung
Verwende ein klares Farbsystem:
* Rot für deaktiviertes PvP.
* Grün für aktiviertes PvP.
* Gelb für eine bevorstehende Statusänderung.
* Orange oder Rot für die letzten Sekunden eines Countdowns.
Die Farben sollen dezent und professionell eingesetzt werden.
Die Darstellung darf nicht unnötig lang sein und soll auf üblichen Minecraft-Auflösungen gut lesbar bleiben.
## 4.4 Anzeigeverhalten
Die Actionbar muss folgende Modi unterstützen:
**Modus A:** Status und Countdown werden dauerhaft angezeigt.
**Modus B:** Der Status bleibt sichtbar, aber der Countdown erscheint nur bei einem laufenden Timer.
**Modus C:** Die Anzeige erscheint nur bei Statusänderungen und wichtigen Warnungen.
Der Administrator kann den gewünschten Modus über die Konfiguration auswählen.
Neue Spieler müssen nach dem Beitritt automatisch den richtigen Zustand erhalten.
Bei dauerhaftem PvP-Status darf kein Countdown vorgetäuscht werden.
## 4.5 Effizienz
Der Timer muss anhand eines absoluten Zeitstempels berechnet werden.
Die Mod darf nicht für jeden Spieler einen unabhängigen, unnötig aufwendigen Countdown betreiben.
Aktualisiere die Actionbar effizient und vermeide unnötige identische Aktualisierungen.
---
# 5. OPTIONALE BOSSBAR
Zusätzlich zur Actionbar muss eine Bossbar verfügbar sein.
Sie ist standardmäßig deaktiviert und kann von Administratoren in der Konfiguration aktiviert werden.
## 5.1 Beispiel
Bossbartitel:
`MC.SMP | PvP aktiviert in 00:15:32`
Die Bossbar zeigt den aktuellen Status und die verbleibende Zeit an.
## 5.2 Fortschrittsanzeige
Der Balken soll den Fortschritt der aktuellen zeitgesteuerten Phase darstellen.
Beispiel:
Bei einem dreistündigen Timer entspricht der volle Balken dem Beginn der Phase. Mit fortschreitender Zeit nimmt der Balken proportional ab.
Die Berechnung muss auf dem ursprünglichen Zeitfenster und dem tatsächlichen Endzeitpunkt beruhen.
Der Balken darf bei einem Serverneustart nicht wieder auf 100 Prozent springen, sofern der Timer weiterläuft.
## 5.3 Gestaltung
Verwende passende Farben:
* Rot für deaktiviertes PvP.
* Grün für aktiviertes PvP.
* Eine konfigurierbare Bossbar-Farbe für Erinnerungs-Timer, sofern diese separat dargestellt werden.
Die Bossbar soll sich bei einem Statuswechsel aktualisieren.
Sie darf keine unnötigen zusätzlichen Bossbars erzeugen.
Es muss genau eine Bossbar pro vorgesehener Anzeige geben, die zuverlässig verwaltet und entfernt wird.
## 5.4 Steuerung
Implementiere folgende Konfigurationsoptionen:
* Bossbar aktivieren oder deaktivieren.
* Titel der Bossbar.
* Farben.
* Sichtbarkeit.
* Anzeige des Countdowns.
* Anzeige nur während laufender Timer.
* Anzeige des dauerhaften PvP-Status.
Die Bossbar ist eine zusätzliche Darstellung. Sie darf nicht die eigentliche PvP-Logik steuern.
---
# 6. WARNUNGEN UND COUNTDOWN
Die Mod soll Spieler rechtzeitig über bevorstehende Statusänderungen informieren.
Die Warnungen müssen konfigurierbar sein.
## 6.1 Standardwarnungen
Vorgeschlagene Zeitpunkte:
* 30 Minuten verbleibend.
* 10 Minuten verbleibend.
* 5 Minuten verbleibend.
* 1 Minute verbleibend.
* 30 Sekunden verbleibend.
* 10 Sekunden verbleibend.
Nicht jeder Timer muss jede Warnung auslösen.
Wenn beispielsweise ein Timer nur 20 Sekunden dauert, dürfen keine Warnungen für 30 Minuten, 10 Minuten oder 5 Minuten ausgelöst werden.
Bereits verstrichene Warnzeitpunkte dürfen nach einem Serverneustart nicht erneut abgespielt werden.
## 6.2 Letzte zehn Sekunden
Während der letzten zehn Sekunden einer regulären Statusänderung soll eine optionale Countdown-Anzeige erscheinen.
Beispiel:
`PvP startet in 10 ...`
Danach wird die verbleibende Zeit sekündlich angezeigt.
Bei der letzten Sekunde erscheint eine besonders markante, aber kompakte Anzeige.
Bei null erfolgt der tatsächliche Statuswechsel.
Verwende für die letzten zehn Sekunden die vorgesehenen Countdown-Sounds.
Die Countdown-Anzeige muss über die Konfiguration deaktivierbar sein.
## 6.3 Keine unnötigen Wiederholungen
Jede Warnung darf pro Timer und Warnzeitpunkt nur einmal ausgelöst werden.
Das System muss auch bei Serverlag, Tick-Verzögerungen oder Neustarts zuverlässig bleiben.
---
# 7. SEPARATER ERINNERUNGS-TIMER
Diese Funktion ist ausdrücklich von einem PvP-Timer zu unterscheiden.
Ein Erinnerungs-Timer darf den PvP-Status niemals automatisch verändern.
## 7.1 Funktion
Administratoren können eine Erinnerung für einen bestimmten Zeitpunkt oder nach einer bestimmten Dauer erstellen.
Beispiel:
`/pvp reminder 10m "PvP-Event beginnt"`
Nach zehn Minuten gibt die Mod die konfigurierte Erinnerung aus.
PvP bleibt dabei unverändert.
## 7.2 Anwendungsfälle
Beispiele:
* Erinnerung an den Beginn eines PvP-Events.
* Erinnerung an das Ende einer Bauphase.
* Erinnerung an einen bevorstehenden Servertermin.
* Erinnerung daran, dass ein Administrator den PvP-Status manuell ändern möchte.
## 7.3 Anzeige
Die Erinnerung darf eine kurze Chatnachricht und optional einen dezenten Sound ausgeben.
Sie darf nicht automatisch die normalen PvP-Statusmeldungen auslösen.
Die Bossbar soll für Erinnerungen standardmäßig nicht verwendet werden, damit normale PvP-Timer nicht mit Erinnerungen verwechselt werden.
Eine optionale separate Erinnerungsanzeige ist möglich.
## 7.4 Verwaltung
Unterstütze:
`/pvp reminder 10m "PvP-Event beginnt"`
`/pvp reminders`
`/pvp reminder cancel `
`/pvp reminders clear`
Die Mod muss Erinnerungen eindeutig identifizieren und verwalten.
Mehrere Erinnerungen dürfen parallel existieren.
Erinnerungen müssen verständliche Bezeichnungen und ihre verbleibende Zeit besitzen.
Falls eine Erinnerung nach einem Neustart weiterhin gültig sein soll, muss ihr Zeitpunkt gespeichert werden.
Ein Erinnerungs-Timer darf niemals versehentlich als PvP-Status-Timer interpretiert werden.
---
# 8. EIGENE MC.SMP-SOUNDS
WICHTIG: Für diese Mod existiert bereits ein Soundpaket.
Die sieben bereitgestellten Dateien müssen verwendet werden.
Die Dateinamen dürfen nicht eigenmächtig geändert werden.
Verwende die Dateien exakt wie angegeben.
## 8.1 Vorhandene Sounddateien
### Sound 1: PvP aktiviert
Datei:
`pvp_activated.ogg`
Minecraft-Sound-ID:
`mcsmp_pvp_timer:pvp_activated`
Verwendungszweck:
Wird genau dann abgespielt, wenn PvP tatsächlich aktiviert wird.
Der Klang ist energisch und metallisch. Er enthält ein aufsteigendes, digital wirkendes Arpeggio und einen hellen Glockenakkord.
Die Datei ist ungefähr 1,40 Sekunden lang.
### Sound 2: PvP deaktiviert
Datei:
`pvp_deactivated.ogg`
Minecraft-Sound-ID:
`mcsmp_pvp_timer:pvp_deactivated`
Verwendungszweck:
Wird genau dann abgespielt, wenn PvP tatsächlich deaktiviert wird.
Der Klang besteht aus drei weich absteigenden Tönen und einem sehr leisen Relais-Klicken.
Die Datei ist ungefähr 1,30 Sekunden lang.
### Sound 3: Warnung bei zehn Minuten
Datei:
`pvp_warning_10min.ogg`
Minecraft-Sound-ID:
`mcsmp_pvp_timer:pvp_warning_10min`
Verwendungszweck:
Wird einmalig bei zehn Minuten verbleibender Zeit abgespielt.
Der Sound ist ein dezenter, glasiger Glockenton.
Die Datei ist ungefähr 0,62 Sekunden lang.
### Sound 4: Countdown-Tick
Datei:
`pvp_countdown_tick.ogg`
Minecraft-Sound-ID:
`mcsmp_pvp_timer:pvp_countdown_tick`
Verwendungszweck:
Wird während des letzten Zehn-Sekunden-Countdowns bei den Sekunden 10 bis 2 abgespielt.
Der kurze, präzise Ton soll auch bei wiederholter Wiedergabe angenehm bleiben.
Die Datei ist ungefähr 0,14 Sekunden lang.
### Sound 5: Letzte Sekunde
Datei:
`pvp_countdown_final.ogg`
Minecraft-Sound-ID:
`mcsmp_pvp_timer:pvp_countdown_final`
Verwendungszweck:
Wird bei Sekunde 1 anstelle des normalen Countdown-Ticks abgespielt.
Der Ton ist markanter und höher als der normale Countdown-Tick.
Die Datei ist ungefähr 0,55 Sekunden lang.
### Sound 6: Timer abgebrochen
Datei:
`pvp_timer_cancelled.ogg`
Minecraft-Sound-ID:
`mcsmp_pvp_timer:pvp_timer_cancelled`
Verwendungszweck:
Wird als Bestätigung abgespielt, wenn ein aktiver Timer abgebrochen wird.
Der Sound besteht aus zwei weichen, absteigenden Holz-Mallet-Tönen.
Die Datei ist ungefähr 0,52 Sekunden lang.
### Sound 7: Timer geändert
Datei:
`pvp_timer_changed.ogg`
Minecraft-Sound-ID:
`mcsmp_pvp_timer:pvp_timer_changed`
Verwendungszweck:
Wird abgespielt, wenn die Dauer eines bestehenden Timers erfolgreich verändert wurde oder ein neuer Timer einen bestehenden Timer ersetzt.
Der Klang besteht aus zwei aufsteigenden Glockentönen.
Die Datei ist ungefähr 0,52 Sekunden lang.
## 8.2 Verbindliche Zuordnung
Die Zuordnung muss exakt eingehalten werden:
| Ereignis | Sounddatei |
| --------------------------- | ------------------------- |
| PvP wird aktiviert | `pvp_activated.ogg` |
| PvP wird deaktiviert | `pvp_deactivated.ogg` |
| Noch zehn Minuten | `pvp_warning_10min.ogg` |
| Countdown Sekunden 10 bis 2 | `pvp_countdown_tick.ogg` |
| Countdown Sekunde 1 | `pvp_countdown_final.ogg` |
| Timer abgebrochen | `pvp_timer_cancelled.ogg` |
| Timer geändert | `pvp_timer_changed.ogg` |
Erfinde keine weiteren Sounddateien und verwende keine anderen Dateien als Ersatz, solange dies nicht ausdrücklich konfiguriert wurde.
## 8.3 Ressourceneinbindung
Kopiere die sieben OGG-Dateien unverändert in:
`src/main/resources/assets/mcsmp_pvp_timer/sounds/`
Erstelle eine korrekte `sounds.json` unter:
`src/main/resources/assets/mcsmp_pvp_timer/sounds.json`
Die JSON-Datei muss alle sieben Sound-IDs korrekt auf die jeweiligen Dateien abbilden.
Referenziere die Dateien ohne die Dateiendung `.ogg`.
Achte auf korrekte Resource-Namespaces, Dateipfade und JSON-Syntax.
Prüfe beim Build, ob alle sieben Dateien vorhanden sind.
## 8.4 WICHTIG: Sounds für normale Spieler
Die Mod soll auf einem Fabric Dedicated Server funktionieren.
Normale Spieler sollen keine zusätzliche Client-Mod installieren müssen, wenn dies vermeidbar ist.
Allerdings werden neue benutzerdefinierte Minecraft-Sound-IDs nicht automatisch auf Vanilla-Clients verfügbar, nur weil die OGG-Dateien auf dem Server liegen.
Implementiere deshalb eine geeignete Lösung für die Verteilung der Soundressourcen.
Bevorzugte Lösung:
* Ein passendes Server-Resource-Pack mit den sieben Sounddateien.
* Eine korrekte `sounds.json`.
* Eine Dokumentation zur Bereitstellung und Aktivierung.
* Eine Möglichkeit, die Resource-Pack-URL und den erforderlichen Hash zu konfigurieren, sofern die Bereitstellung extern erfolgt.
* Verständliche Hinweise, wenn Spieler das Resource Pack ablehnen oder nicht laden können.
Die Mod darf nicht behaupten, dass eigene Sounddateien auf jedem Vanilla-Client ohne Resource Pack funktionieren.
Falls eine zusätzliche Client-Mod erforderlich sein sollte, muss dies klar dokumentiert werden.
## 8.5 Soundlautstärke und Wiedergabe
Die Wiedergabelautstärke muss konfigurierbar sein.
Verwende die korrekten Sound- und Netzwerkmechanismen für die gewählte Implementierung.
Die Sounds müssen für alle betroffenen Spieler hörbar sein, unabhängig von ihrer Entfernung zum ausführenden Administrator.
Verwende dafür eine geeignete nicht positionsgebundene Wiedergabe.
Jedes Ereignis darf nur einmal den zugehörigen Sound auslösen.
Bei der Aktivierung von PvP dürfen beispielsweise nicht mehrere Aktivierungssounds durch doppelte Statusverarbeitung abgespielt werden.
## 8.6 Optionale Sounds
Die Mod soll ermöglichen, einzelne Sounds über die Konfiguration zu deaktivieren.
Wenn ein Sound deaktiviert ist, muss die zugehörige Funktion trotzdem korrekt arbeiten.
---
# 9. TITELANZEIGEN BEI STATUSWECHSELN
Beim tatsächlichen Wechsel des PvP-Status soll eine dezente Titelanzeige erscheinen.
## 9.1 PvP aktiviert
Haupttitel:
`⚔ PvP AKTIVIERT`
Untertitel:
`Kämpfe sind jetzt möglich!`
## 9.2 PvP deaktiviert
Haupttitel:
`⚔ PvP DEAKTIVIERT`
Untertitel:
`PvP ist vorerst deaktiviert.`
## 9.3 Anforderungen
* Zentrierte Darstellung.
* Dezente Größe.
* Passende Ein- und Ausblendung.
* Keine unnötigen Partikel.
* Keine übermäßig langen Bildschirmmeldungen.
* Anpassbare Texte und Farben.
* Konfigurierbare Anzeigedauer.
* Keine mehrfachen Titel durch doppelte Ereignisse.
Die Titelanzeige muss von der tatsächlichen Statusänderung getrennt sein.
Ein bloßer Timer-Reset darf nicht automatisch einen PvP-Aktivierungstitel auslösen.
---
# 10. TIMER ÄNDERN, ABBRECHEN UND VERLÄNGERN
Implementiere ein vollständiges Verwaltungssystem.
## 10.1 Timer verlängern
`/pvp addtime 30m`
Verlängert einen laufenden PvP-Timer um 30 Minuten.
## 10.2 Timer verkürzen
`/pvp removetime 10m`
Verkürzt die verbleibende Zeit um zehn Minuten.
## 10.3 Restzeit festlegen
`/pvp settime 1h`
Setzt die verbleibende Zeit auf eine Stunde.
## 10.4 Timer abbrechen
`/pvp cancel`
Bricht die geplante Statusänderung ab.
Der aktuelle PvP-Status bleibt dabei unverändert.
## 10.5 Timer ersetzen
Wenn ein neuer zeitgesteuerter Befehl eingegeben wird, während ein anderer Timer läuft, muss die Mod:
1. Den bisherigen Timer erkennen.
2. Den neuen Befehl validieren.
3. Die neue Konfiguration übernehmen.
4. Den alten Timer kontrolliert ersetzen.
5. Den neuen Endzeitpunkt speichern.
6. Die Statusanzeige aktualisieren.
7. Eine Bestätigung ausgeben.
8. Den Sound `pvp_timer_changed.ogg` genau einmal abspielen.
Wenn ein Timer abgebrochen wird, muss `pvp_timer_cancelled.ogg` abgespielt werden.
Die Statuslogik darf nicht durch mehrfaches Ersetzen oder Abbrechen inkonsistent werden.
## 10.6 Zeit auf null setzen
Wenn eine Zeitänderung den geplanten Zeitpunkt unmittelbar erreicht oder überschreitet, muss die Mod die vorgesehene Statusänderung kontrolliert ausführen.
Es darf kein Timer mit einer ungültigen negativen Restzeit zurückbleiben.
---
#
---
# 12. VERSCHIEDENE TIMER-MODI
Implementiere drei logisch getrennte Modi.
## Modus A: Normal
PvP wird sofort geändert und nach Ablauf des Timers automatisch in den gespeicherten Zielzustand versetzt.
## Modus B: Event
Wie der normale Modus, zusätzlich mit Vorwarnungen, Zehn-Sekunden-Countdown, Titelanzeigen und den zugehörigen Sounds.
## Modus C: Still
Die Statusänderung wird ohne zusätzliche öffentliche Vorwarnungen durchgeführt.
Konfigurierbare Sound- und Anzeigeeinstellungen bleiben dabei wirksam, sofern sie nicht ausdrücklich deaktiviert wurden.
Die genaue Bedeutung jedes Modus muss dokumentiert sein.
---
# 13. VORSCHAU EINER GEPLANTEN ÄNDERUNG
Administratoren sollen eine geplante Änderung überprüfen können, ohne sie tatsächlich auszuführen.
Beispiel:
`/pvp preview disable 3h`
Ausgabe:
MC.SMP | PvP-Vorschau
Neuer Status: DEAKTIVIERT
Dauer: 03:00:00
Geplante Aktivierung: [berechnete Uhrzeit]
Es werden keine Änderungen vorgenommen.
Die Vorschau darf keine Timer starten, keine Statusänderung durchführen und keine Statuswechsel-Sounds auslösen.
---
# 14. ADMINISTRATIONSBEFEHLE
Implementiere eine konsistente Befehlsstruktur.
Mindestens folgende Funktionen müssen vorhanden sein:
### Status
`/pvp`
Zeigt den aktuellen Zustand und gegebenenfalls den Countdown an.
### Informationen
`/pvp info`
Zeigt Status, verbleibende Zeit, Zielzustand und Endzeitpunkt an.
### Timer
`/pvp timer`
Zeigt Informationen zum aktiven Timer.
### Erinnerungen
`/pvp reminders`
Zeigt aktive Erinnerungs-Timer.
### Historie
`/pvp history`
Zeigt vergangene Statusänderungen.
### Notfall
`/pvp emergency`
Deaktiviert PvP sofort und bricht bestehende automatische PvP-Timer ab.
Der Befehl muss besonders geschützt sein.
Die Notfallaktion muss protokolliert werden.
### Konfiguration
`/pvp reload`
Lädt die Konfiguration neu, sofern dies ohne Inkonsistenzen möglich ist.
Alle Befehle müssen verständliche Fehlermeldungen und eine vollständige Syntaxhilfe besitzen.
Nutze Minecraft-Befehlsvorschläge, soweit technisch sinnvoll.
---
# 15. BERECHTIGUNGEN
Verwende ein Berechtigungssystem, das mit LuckPerms kompatibel ist.
Vorgeschlagene Berechtigungen:
* `mcsmp.pvp.admin`: vollständige Verwaltung.
* `mcsmp.pvp.status`: Statusabfrage.
* `mcsmp.pvp.timer`: Timerinformationen.
* `mcsmp.pvp.reminder`: Erinnerungen verwalten.
* `mcsmp.pvp.schedule`: Zeitpläne verwalten.
* `mcsmp.pvp.emergency`: Notfallbefehl ausführen.
Ohne LuckPerms müssen administrative Funktionen standardmäßig auf autorisierte Server-Operatoren beschränkt sein.
Normale Spieler dürfen den Status abfragen, aber keine Timer manipulieren.
---
# 16. PVР-SICHERHEIT UND KORREKTE SCHADENSREGELUNG
Die Anzeige allein reicht nicht aus.
Die Mod muss PvP tatsächlich kontrollieren.
Wenn PvP deaktiviert ist, dürfen Spieler anderen Spielern keinen PvP-Schaden zufügen.
Berücksichtige insbesondere:
* Nahkampfangriffe.
* Schwerter.
* Äxte.
* Streitkolben.
* Bögen.
* Armbrüste.
* Dreizacke.
* Andere Vanilla-Waffen.
* Geschosse, die von Spielern abgefeuert wurden.
* Indirekte Angriffe und andere relevante Schadensursachen.
Die Implementierung muss die tatsächlichen Schadensereignisse und die Herkunft des Angriffs berücksichtigen.
Normale Kämpfe gegen Monster und andere geeignete PvE-Ziele müssen weiterhin funktionieren.
Die Mod darf nicht pauschal sämtlichen Schaden deaktivieren.
Es muss geprüft werden, ob die verwendeten Fabric-APIs alle relevanten Angriffsarten abdecken.
PvP muss nach der Aktivierung wieder zuverlässig funktionieren.
Die Mod darf keine Gegenstände entfernen, keine Inventare verändern und keine Spieler ohne Grund töten.
Wenn andere Mods ebenfalls den PvP-Status oder Schadensereignisse verändern, müssen mögliche Konflikte dokumentiert werden.
---
# 17. NEUSTARTSICHERHEIT UND DATENSPEICHERUNG
Die Mod muss ihren Zustand dauerhaft speichern.
Speichere mindestens:
* Aktuellen PvP-Status.
* Aktiven Timer.
* Zielzustand des Timers.
* Startzeitpunkt.
* Endzeitpunkt.
* Bereits ausgelöste Warnungen.
* Erinnerungs-Timer.
* Wiederkehrende Zeitpläne.
* Relevante Konfiguration.
* Historie wichtiger Statusänderungen.
Verwende absolute Zeitstempel.
## Beispiel
Ein dreistündiger Timer wird gestartet.
Nach einer Stunde wird der Server neu gestartet.
Wenn die reale Zeit weitergezählt werden soll, verbleiben nach dem Neustart ungefähr zwei Stunden.
Ist der Endzeitpunkt bereits verstrichen, muss die Mod den vorgesehenen Zustand zuverlässig wiederherstellen.
Ein Serverneustart darf keine doppelten Sounds, Titel oder Warnungen auslösen.
Schreibe Daten sicher und verwende eine robuste Strategie, damit eine beschädigte Speicherdatei nicht unnötig den Serverstart verhindert.
---
# 18. PVР-HISTORIE UND PROTOKOLLIERUNG
Speichere die letzten 100 wichtigen Ereignisse oder eine konfigurierbare Anzahl davon.
Beispiele:
* PvP aktiviert.
* PvP deaktiviert.
* Timer gestartet.
* Timer geändert.
* Timer abgebrochen.
* Timer automatisch beendet.
* Notfallbefehl ausgeführt.
* Zeitplan ausgelöst.
* Konfiguration neu geladen.
Protokolliere, sofern verfügbar:
* Zeitstempel.
* Auslösenden Administrator.
* Alten Status.
* Neuen Status.
* Geplante Dauer.
* Grund der Änderung.
Automatische Statusänderungen müssen als automatisch gekennzeichnet werden.
Die Historie darf nicht durch normale Spieler manipuliert werden.
---
# 19. KONFIGURATION
Erstelle eine übersichtliche Konfigurationsdatei.
Sie soll mindestens folgende Einstellungen enthalten:
## PvP
* Initialer PvP-Status.
* Verhalten bei einem neuen Timer.
* Maximale Timerdauer.
* Standardmodus.
* Verhalten bei Serverneustarts.
## Actionbar
* Aktivierung.
* Anzeige des Status.
* Anzeige des Countdowns.
* Farben.
* Texte.
* Aktualisierungsintervall.
## Bossbar
* Aktivierung.
* Titel.
* Farbe.
* Fortschrittsanzeige.
* Sichtbarkeit.
* Anzeigeverhalten.
## Titelanzeigen
* Aktivierung.
* Haupttitel.
* Untertitel.
* Farben.
* Einblenddauer.
* Ausblenddauer.
## Warnungen
* Aktivierung.
* Warnzeitpunkte.
* Chatnachrichten.
* Countdown der letzten zehn Sekunden.
* Verhalten bei kurzen Timern.
## Sounds
* Aktivierungssound.
* Deaktivierungssound.
* Zehn-Minuten-Warnsound.
* Countdown-Tick.
* Finaler Countdown-Sound.
* Abbruch-Sound.
* Timeränderungs-Sound.
* Lautstärken.
* Aktivierung einzelner Sounds.
## Zeitpläne
* Aktivierung.
* Zeitzone.
* Standardverhalten.
* Umgang mit manuellen Änderungen.
## Erinnerungen
* Maximale Anzahl.
* Standardanzeige.
* Soundoptionen.
* Speicherung über Neustarts.
Die Standardkonfiguration muss sofort funktionieren.
---
# 20. TESTS UND QUALITÄTSSICHERUNG
Vor der Auslieferung müssen mindestens folgende Fälle getestet werden:
1. PvP wird sofort deaktiviert.
2. PvP wird sofort aktiviert.
3. PvP wird nach Ablauf eines Timers automatisch geändert.
4. Der Countdown zeigt die korrekte Restzeit.
5. Die Actionbar wird korrekt aktualisiert.
6. Die optionale Bossbar funktioniert.
7. Die Bossbar zeigt den richtigen Fortschritt.
8. Der Erinnerungs-Timer verändert den PvP-Status nicht.
9. Erinnerungen funktionieren auch bei mehreren gleichzeitig aktiven Einträgen.
10. Die zehnminütige Warnung wird höchstens einmal ausgelöst.
11. Der Zehn-Sekunden-Countdown wird korrekt abgespielt.
12. Alle sieben Sounddateien sind korrekt eingebunden.
13. Statuswechsel-Sounds werden nicht doppelt ausgelöst.
14. Ein neuer Timer ersetzt einen bestehenden Timer korrekt.
15. Ein Timer kann abgebrochen werden.
16. Zeitänderungen funktionieren korrekt.
17. Wiederkehrende Zeitpläne funktionieren.
18. Manuelle Änderungen und Zeitpläne verursachen keine widersprüchlichen Zustände.
19. Ein Serverneustart stellt den richtigen Status wieder her.
20. Warnungen werden nach einem Neustart nicht unnötig wiederholt.
21. Neue Spieler erhalten die korrekte Statusanzeige.
22. PvP-Schaden wird bei deaktiviertem PvP zuverlässig verhindert.
23. PvE funktioniert weiterhin.
24. Der Notfallbefehl funktioniert korrekt.
25. Berechtigungen werden zuverlässig geprüft.
26. Fehlerhafte Befehle werden verständlich abgelehnt.
27. Die Mod startet auf einem Fabric Dedicated Server.
28. Es entstehen keine unnötigen Abstürze oder kritischen Fehler.
---
# 21. AUSLIEFERUNG
Liefere:
1. Vollständigen Java-Quellcode.
2. Vollständige Gradle-Projektstruktur.
3. Passende `fabric.mod.json`.
4. Vollständige `sounds.json`.
5. Alle sieben vorhandenen OGG-Sounddateien unverändert.
6. Konfigurationsdatei mit sinnvollen Standardwerten.
7. Ressourcen für die Titel- und Bossbar-Anzeige, soweit erforderlich.
8. README mit Installationsanleitung.
9. Dokumentation aller Befehle.
10. Dokumentation der Berechtigungen.
11. Anleitung für das Sound-Resource-Pack.
12. Dokumentation der Konfiguration.
13. Tests für Timer, Statuswechsel und Neustarts.
14. Eine fertig kompilierte JAR-Datei für Minecraft Java 1.21.11 und Fabric.
Die Sounddateien müssen anhand der bereitgestellten ZIP-Datei übernommen werden. Erzeuge keine Ersatzsounds und ändere die vorhandenen Dateinamen nicht.
Prüfe die fertige JAR auf tatsächliche Kompatibilität mit der Zielversion.
---
# 22. ABSCHLIESSENDE PRIORITÄTEN
Die Entwicklungsprioritäten sind:
**Priorität 1:** Zuverlässige PvP-Steuerung.
**Priorität 2:** Korrekte Zeitberechnung und automatische Statusänderungen.
**Priorität 3:** Speicherung über Serverneustarts.
**Priorität 4:** Professionelle Actionbar und optionale Bossbar.
**Priorität 5:** Korrekte Integration aller sieben bereitgestellten Sounds.
**Priorität 6:** Erinnerungs-Timer ohne Änderung des PvP-Status.
**Priorität 7:** Warnungen, Zeitpläne, Historie und zusätzliche Verwaltungsfunktionen.
**Priorität 8:** Sauberer, wartbarer Code und vollständige Dokumentation.
Die Mod darf keine Funktionen nur vorgeben, die technisch nicht implementiert sind.
Alle Befehle müssen tatsächlich funktionieren. Alle Statusanzeigen müssen den echten Zustand widerspiegeln. Timer müssen zuverlässig ablaufen und dürfen nach einem Neustart nicht versehentlich neu beginnen.
Die Mod soll sich wie ein professionelles, eigenständiges MC.SMP-System anfühlen und ohne unnötige Änderungen am normalen Minecraft-Gameplay auskommen.