Marc
📎 1 file 29,397 chars
📄
pasted-code-1793312434524.txt
txt 1048 lines
▶
# 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.
Kodari AI
KodariOct 29 at 10:51 pm 6
  1. Projektbestand und vorhandene Sounddateien prüfen.

  2. PvP-Kern, Timer, Persistenz und Schadenssperre umsetzen.

  3. Befehle, Anzeigen, Warnungen und Erinnerungen ergänzen.

  4. Ressourcen, Konfiguration und Dokumentation vervollständigen.

Das Fabric-Projekt für Minecraft 1.21.11 ist angelegt. Es enthält serverseitige PvP-Schadenssperre, absolute und neustartfeste PvP-Timer, Actionbar, optionale Bossbar, Eventwarnungen, Titel, die sieben bereitgestellten Sounds, Erinnerungen und eine speicherbare Historie. Die Timerbefehle umfassen unter anderem /pvp enable|disable [zeit], /pvp addtime, /pvp removetime, /pvp settime, /pvp cancel und /pvp preview. Änderungen erfordern Operator-Level 3; /pvp emergency erfordert Level 4.

Der Gradle-Build prüft, ob alle sieben OGG-Dateien vorhanden sind, und erzeugt das Server-Resource-Pack unter build/distributions/mcsmp-pvp-timer-sounds.zip. Vanilla-Clients müssen das Pack annehmen, damit die benutzerdefinierten Sounds hörbar sind; URL und SHA-1 werden wie üblich in server.properties eingetragen.

Nicht umgesetzt sind wiederkehrende Kalender-Zeitpläne, LuckPerms-spezifische mcsmp.pvp.*-Nodes, konfigurierbare Titeltexte und -farben, separate Erinnerungssounds sowie automatisierte Tests. Diese Grenzen sind auch in der README dokumentiert. Eine kompilierte und getestete JAR liegt hier noch nicht vor.

Zum Erstellen und Herunterladen der JAR: Compile in der oberen Leiste wählen (auf dem Smartphone: ⋮ → Compile Project), im Build-Fenster nochmals Compile anklicken und nach erfolgreichem Build Download auswählen.

Kodari can make mistakes. Review important code before using.
Files
MC.SMP_PvP_Sounds
Code
16 1,395
MC.SMP_PvP_Sounds/src/main/java/de/mcsmp/pvptimer/PvpTimerMod.java
package de.mcsmp.pvptimer;

import com.mojang.brigadier.arguments.IntegerArgumentType;
import com.mojang.brigadier.arguments.ArgumentType;
import com.mojang.brigadier.arguments.StringArgumentType;
import com.mojang.brigadier.builder.LiteralArgumentBuilder;
import com.mojang.brigadier.builder.RequiredArgumentBuilder;
import net.fabricmc.api.ModInitializer;
import net.fabricmc.fabric.api.command.v2.CommandRegistrationCallback;
import net.fabricmc.fabric.api.entity.event.v1.ServerLivingEntityEvents;
import net.fabricmc.fabric.api.event.lifecycle.v1.ServerLifecycleEvents;
import net.fabricmc.fabric.api.event.lifecycle.v1.ServerTickEvents;
import net.minecraft.command.permission.Permission;
import net.minecraft.command.permission.PermissionLevel;
import net.minecraft.entity.boss.BossBar;
import net.minecraft.entity.boss.ServerBossBar;
import net.minecraft.entity.damage.DamageSource;
import net.minecraft.entity.player.PlayerEntity;
import net.minecraft.network.packet.s2c.play.PlaySoundS2CPacket;
import net.minecraft.network.packet.s2c.play.SubtitleS2CPacket;
import net.minecraft.network.packet.s2c.play.TitleFadeS2CPacket;
import net.minecraft.network.packet.s2c.play.TitleS2CPacket;
import net.minecraft.registry.entry.RegistryEntry;
import net.minecraft.server.MinecraftServer;
import net.minecraft.server.command.ServerCommandSource;
import net.minecraft.server.network.ServerPlayerEntity;
import net.minecraft.sound.SoundCategory;
import net.minecraft.sound.SoundEvent;
import net.minecraft.text.MutableText;
import net.minecraft.text.Text;
import net.minecraft.util.Formatting;
import net.minecraft.util.Identifier;
import net.minecraft.util.WorldSavePath;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.nio.file.AtomicMoveNotSupportedException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.StandardCopyOption;
import java.time.Instant;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Properties;
import java.util.Set;
import java.util.HashSet;
import java.util.UUID;
import java.util.concurrent.ThreadLocalRandom;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

public final class PvpTimerMod implements ModInitializer {
    public static final String MOD_ID = "mcsmp_pvp_timer";
    private static final Logger LOGGER = LoggerFactory.getLogger(MOD_ID);
    private static final long DEFAULT_MAX_TIMER_MILLIS = 30L * 24 * 60 * 60 * 1000;
    private static final Pattern DURATION_PART = Pattern.compile("(\\d+)([dhms])");
    private static final long[] DEFAULT_WARNINGS = {1_800_000, 600_000, 300_000, 60_000, 30_000, 10_000};
    private static final Map<Integer, Reminder> REMINDERS = new LinkedHashMap<>();
    private static final ArrayList<String> HISTORY = new ArrayList<>();
    private static final Map<UUID, String> LAST_ACTIONBAR = new LinkedHashMap<>();

    private static boolean pvpEnabled = true;
    private static long timerStartMillis;
    private static long timerEndMillis;
    private static boolean timerTargetEnabled;
    private static String timerMode = "normal";
    private static int warnedMask;
    private static int lastCountdownSecond = -1;
    private static int nextReminderId = 1;
    private static int tickCounter;
    private static long maxTimerMillis = DEFAULT_MAX_TIMER_MILLIS;
    private static long[] warningTimes = DEFAULT_WARNINGS.clone();
    private static ServerBossBar bossBar;

    private static boolean initialPvpEnabled = true;
    private static boolean actionbarEnabled = true;
    private static boolean bossbarEnabled;
    private static boolean bossbarOnlyWithTimer;
    private static boolean bossbarShowPermanent = true;
    private static boolean titlesEnabled = true;
    private static boolean warningsEnabled = true;
    private static boolean finalCountdownEnabled = true;
    private static boolean soundsEnabled = true;
    private static boolean soundActivated = true;
    private static boolean soundDeactivated = true;
    private static boolean soundWarning = true;
    private static boolean soundCountdownTick = true;
    private static boolean soundCountdownFinal = true;
    private static boolean soundCancelled = true;
    private static boolean soundChanged = true;
    private static float soundVolume = 1.0f;
    private static int titleFadeInTicks = 5;
    private static int titleStayTicks = 30;
    private static int titleFadeOutTicks = 10;
    private static int maxReminders = 50;
    private static int maxHistory = 100;
    private static String actionbarMode = "always";
    private static String defaultMode = "normal";

    @Override
    public void onInitialize() {
        ServerLifecycleEvents.SERVER_STARTED.register(server -> {
            loadConfig();
            load(server);
        });
        ServerLifecycleEvents.SERVER_STOPPING.register(PvpTimerMod::save);
        ServerTickEvents.END_SERVER_TICK.register(PvpTimerMod::tick);
        ServerLivingEntityEvents.ALLOW_DAMAGE.register((entity, source, amount) -> {
            if (!pvpEnabled && entity instanceof PlayerEntity && source.getAttacker() instanceof PlayerEntity) {
                return false;
            }
            return true;
        });
        CommandRegistrationCallback.EVENT.register((dispatcher, registryAccess, environment) ->
                dispatcher.register(createCommandTree()));
    }

    private static LiteralArgumentBuilder<ServerCommandSource> createCommandTree() {
        LiteralArgumentBuilder<ServerCommandSource> root = literal("pvp")
                .executes(context -> {
                    reply(context.getSource(), statusText());
                    return 1;
                });

        root.then(literal("info").executes(context -> {
            reply(context.getSource(), statusText());
            return 1;
        }));
        root.then(literal("timer").executes(context -> {
            reply(context.getSource(), timerText());
            return 1;
        }));
        root.then(literal("enable").requires(PvpTimerMod::isAdmin)
                .executes(context -> {
                    setPermanent(context.getSource(), true);
                    return 1;
                })
                .then(argument("duration", StringArgumentType.word()).executes(context -> {
                    startTimer(context.getSource(), true, StringArgumentType.getString(context, "duration"), defaultMode);
                    return 1;
                })));
        root.then(literal("disable").requires(PvpTimerMod::isAdmin)
                .executes(context -> {
                    setPermanent(context.getSource(), false);
                    return 1;
                })
                .then(argument("duration", StringArgumentType.word()).executes(context -> {
                    startTimer(context.getSource(), false, StringArgumentType.getString(context, "duration"), defaultMode);
                    return 1;
                })));
        for (String mode : new String[]{"normal", "event", "still"}) {
            String selectedMode = mode;
            root.then(literal(selectedMode).requires(PvpTimerMod::isAdmin)
                    .then(literal("enable").then(argument("duration", StringArgumentType.word()).executes(context -> {
                        startTimer(context.getSource(), true, StringArgumentType.getString(context, "duration"), selectedMode);
                        return 1;
                    })))
                    .then(literal("disable").then(argument("duration", StringArgumentType.word()).executes(context -> {
                        startTimer(context.getSource(), false, StringArgumentType.getString(context, "duration"), selectedMode);
                        return 1;
                    }))));
        }
        root.then(literal("cancel").requires(PvpTimerMod::isAdmin).executes(context -> {
            cancelTimer(context.getSource());
            return 1;
        }));
        root.then(literal("addtime").requires(PvpTimerMod::isAdmin)
                .then(argument("duration", StringArgumentType.word()).executes(context -> {
                    adjustTimer(context.getSource(), StringArgumentType.getString(context, "duration"), 1);
                    return 1;
                })));
        root.then(literal("removetime").requires(PvpTimerMod::isAdmin)
                .then(argument("duration", StringArgumentType.word()).executes(context -> {
                    adjustTimer(context.getSource(), StringArgumentType.getString(context, "duration"), -1);
                    return 1;
                })));
        root.then(literal("settime").requires(PvpTimerMod::isAdmin)
                .then(argument("duration", StringArgumentType.word()).executes(context -> {
                    setTimerRemaining(context.getSource(), StringArgumentType.getString(context, "duration"));
                    return 1;
                })));
        root.then(literal("emergency").requires(PvpTimerMod::isEmergencyAdmin).executes(context -> {
            emergencyDisable(context.getSource());
            return 1;
        }));
        root.then(literal("preview").requires(PvpTimerMod::isAdmin)
                .then(literal("enable").then(argument("duration", StringArgumentType.word()).executes(context -> {
                    preview(context.getSource(), true, StringArgumentType.getString(context, "duration"));
                    return 1;
                })))
                .then(literal("disable").then(argument("duration", StringArgumentType.word()).executes(context -> {
                    preview(context.getSource(), false, StringArgumentType.getString(context, "duration"));
                    return 1;
                }))));
        root.then(literal("reminder").requires(PvpTimerMod::isAdmin)