MRpvp

Duelle ohne Risiko: Zwei Spieler kämpfen in einer eigenen Arena mit einem vorgegebenen Kit - und bekommen danach alles genau so zurück, wie es vorher war. Mit eigener Statistik, Bestenliste und Schutz gegen Statistik-Farmen.

#Was kann MRpvp?

• Herausfordern per Menü: Spieler, Kit, Arena und Regeln wählen, Einladung senden - der Gegner nimmt per Klick im Chat an.
• Nichts geht verloren: Inventar, Rüstung, Enderchest, XP, Leben, Hunger, Effekte, Spielmodus und Position werden vor dem Duell sicher gespeichert und danach zurückgegeben - auch nach einem Server-Absturz.
• Duelle zählen nicht für Minecraft: keine Tode und Kills in der Vanilla-Statistik, keine Todesnachricht, keine Drops, keine Advancements.
• 14 fertige Kits (Klassisch, Netherite, UHC, Sumo, Boxing, Crystal, Elytra & Streitkolben …) und 4 Arenen - eigene baust du im Spiel.
• Eigene Statistik: K/D, Siege, Serien, Bestenliste und die letzten Runden mit Kampf-Log.
• Faire Wertung: Auffällige Runden (z.B. abgesprochene Statistik-Farmen) warten auf eine Prüfung durch das Team.
• Alles über Menüs - für Spieler und für Admins.

#Schnellstart

1. MRpvp herunterladen und die JAR in den Ordner plugins/ legen.
2. Den Server starten. MRpvp legt die Arena-Welt mrpvp_arenas an und baut die Standard-Arenen und -Kits auf. Den Datenbank-Treiber lädt Paper beim ersten Start selbst herunter.
3. Rechte geben - ohne sie dürfen nur OPs Duelle spielen:

   /lp group default permission set mrpvp.player true
   /lp group supporter permission set mrpvp.groups.support true
   /lp group staff permission set mrpvp.groups.staff true
   /lp group admin permission set mrpvp.groups.admin true
   

4. Fertig - Spieler legen mit /duel los.

Update: Die alte JAR durch die neue ersetzen und den Server neu starten. Neue Einstellungen und neue Standard-Kits kommen automatisch dazu.

#So läuft ein Duell

1. /duel → Herausfordern → Spieler anklicken. Oder direkt: /duel <spieler>.
2. Kit und Map wählen, dazu die Optionen:
   • Siege bis Gewinn (1, 2, 3 oder 5 Runden als Match)
   • Zeitlimit pro Runde
   • Hunger und natürliche Regeneration an oder aus (manche Kits geben das fest vor, z.B. UHC ohne Regeneration)
3. Einladung senden. Der Gegner bekommt im Chat [Annehmen] [Ablehnen] [Details]. Deine letzten Einstellungen sind beim nächsten Mal vorausgewählt.
4. Im Duell zeigt die Bossbar Runde, Spielstand, die Herzen des Gegners und die Restzeit. Am Ende gibt es eine Zusammenfassung im Chat - und alles zurück.

• Aufgeben mit /duel leave zählt als Niederlage im ganzen Match (nur vor Runde 1 wird einfach abgebrochen).
• Verbindung weg? Die Runde pausiert 20 Sekunden, der Gegner ist eingefroren. Wer rechtzeitig zurückkommt, spielt weiter (einmal pro Match).
• Wer bei der Rückgabe offline ist, bekommt alles beim nächsten Login.

#Statistik & Bestenliste

Im Duell-Menü sieht jeder Spieler seine Statistik (gesamt und pro Kit), die Bestenliste (Siege, K/D, Siegquote, beste Serie - gesamt, 30 oder 7 Tage) und seine letzten Runden mit Kampf-Log. Jede Runde hat eine Spiel-ID (z.B. #1042), über die das Team sie wiederfindet.

#Für Admins

#Admin-Menü

/duel admin öffnet das Admin-Menü. Von dort aus:

• Live laufende Duelle steuern - ein Klick auf ein Duell öffnet seine Steuerung:
  • Zuschauen über der Arena oder direkt bei Spieler 1 / Spieler 2 (als Zuschauer, dein Inventar wird gesichert)
  • Pausieren / Fortsetzen: beide werden eingefroren, niemand nimmt Schaden, die Zeit steht
  • Sieger bestimmen: z.B. wenn jemand einen Bug ausnutzt - das Duell endet, der gewählte Spieler gewinnt das Match, die Runde zählt als Sieg (ohne Kill und Tod)
  • Abbrechen: zählt nicht, beide bekommen alles zurück
• Runden ansehen - mit Kampf-Log und den gesicherten Inventaren (vor und nach der Runde) - und offene Rückgaben sofort ausführen. Eine gewertete Runde lässt sich hier nachträglich aus der Wertung nehmen (mit optionalem Grund) und später wieder werten - die Statistik beider Spieler wird jeweils neu berechnet.
• Prüfen: auffällige Runden werten oder verwerfen
• Spieler verwalten, von Duellen sperren, Statistik zurücksetzen
• Kits und Arenen bearbeiten, Standard wiederherstellen

#Kits

Mitgeliefert: Klassisch, Diamant, Netherite, Bogen, Streitkolben, Elytra & Streitkolben, UHC, Build-UHC, Sumo, Boxing, NoDebuff, Crystal, Axt & Schild und Dreizack.

• Bearbeiten im Spiel mit dem Kit-Editor (Admin-Menü → Kits), in der MRadmin-Weboberfläche (Duelle → Kits) oder lesbar in kits.yml.
• Kit-Editor im Web (mit MRadmin, Permission mrpvp.admin.kits wie im Spiel): alle Kits mit Bildern und Tooltip wie im Spiel, Reihenfolge per ↑/↓, kopieren, neu anlegen, umbenennen, löschen. Ein Klick auf einen Platz öffnet den Item-Editor (Anzahl, Name, Beschreibung, Verzauberungen, Tränke, Farbe, Rüstungsbesatz …), dazu Name und Beschreibung auf Deutsch und Englisch, Symbol, Permission und alle Regeln. Gespeichert wird in kits.yml; neue Runden bekommen das Kit sofort, laufende behalten ihres.
• Kit-Regeln: kein Schaden bzw. nur Rückstoß (Sumo, Boxing), Sieg nach Treffern, feste Regeneration oder Hunger, festes Zeitlimit, mehr oder weniger Herzen, Effekte für die ganze Runde (z.B. Schnelligkeit II), eigene Cooldowns für Items (z.B. 15 Sekunden für Enderperlen - das Spiel zeigt die Wartezeit am Item), nur bestimmte Arenen, braucht eine Bau-Arena. Einstellbar im Kit-Editor über den Knopf Regeln, im Web oder in kits.yml. Was ein Kit fest vorgibt, ist beim Herausfordern ausgegraut.
• Ein Kit kann eine eigene Permission haben (permission in kits.yml), z.B. für VIP-Kits.
• Kits weitergeben (Export/Import): In der Kit-Liste schreibt Alle Kits exportieren eine Datei nach plugins/MRpvp/exports/. Auf dem anderen Server die Datei nach plugins/MRpvp/imports/ legen und Kits importieren wählen: Vorher siehst du pro Kit, ob es neu ist oder schon existiert (dann als <id>_2 anlegen oder ersetzen), welche Arenen es dort nicht gibt (werden weggelassen) und ob Items nicht lesbar sind. Im Web (Duelle → Kits) geht beides genauso, dort lassen sich fehlende Arenen auch einer eigenen zuordnen. Die Datei enthält jedes Item komplett - Items aus einer neueren Minecraft-Version kann ein älterer Server eventuell nicht lesen.
• Name und Beschreibung pro Sprache: In kits.yml entweder ein Text für alle Sprachen oder name: { de: "<white>Klassisch", en: "<white>Classic" } - jeder Spieler sieht seine Sprache, fehlt sie, gilt Englisch. Die Standard-Kits sind deutsch und englisch. Im Kit-Editor änderst du Name und Beschreibung in deiner eigenen Sprache, die anderen bleiben.

#Arenen

Mitgeliefert: Standard, Sumo (Plattform über dem Void), Bau-Arena (Bauen erlaubt) und XXL-Himmel (schwebende Inseln, nur für Kits mit Elytra).

• Neue Arenen baust du im Spiel im Arena-Editor (Admin-Menü → Arenen → Neue Arena; Kreativmodus, Werkzeuge in der Hotbar, dein Inventar wird solange sicher gespeichert).
• Entwürfe „im Bau“: Neue Arenen und Änderungen an bestehenden sind erst ein Entwurf. Mehrere aus dem Team können gleichzeitig daran bauen (in der Arenen-Liste Klick auf den Entwurf bzw. im Arena-Menü Mitbauen). Ein Entwurf ist nicht spielbar und erscheint nicht im Web - bei bestehenden Arenen bleibt bis dahin die alte Version spielbar. Im Editor (grüner Farbstoff, Slot 9): Veröffentlichen (wird die neue Version), Verlassen (der Entwurf bleibt im Bau, auch nach einem Neustart) oder Entwurf verwerfen (auch in der Liste mit Shift+Rechtsklick).
• Pro Arena einstellbar: erlaubte Kits, „nur Kits mit Elytra“, Bauen erlaubt und Bauhöhe, wie viele Kopien bereitstehen.
• Jede Arena liegt als fertige Kopie bereit, damit eine Runde sofort startet. Nach der Runde wird sie automatisch zurückgesetzt.
• Gelöschte Standard-Kits und -Arenen holt Standard wiederherstellen zurück.

#Auffällige Runden prüfen

Auffällige Runden zählen nicht einfach nicht - sie warten auf eine Entscheidung. Auffällig sind z.B. zu viele Runden gegen denselben Gegner, sehr kurze Runden ohne Treffer oder extreme Treffer. Unter Admin-Menü → Prüfen wertest du sie (die Statistik beider wird neu berechnet) oder verwirfst sie. Ohne Entscheidung zählt eine Runde nach 7 Tagen (einstellbar unter review).

#Befehle

#Permissions

#Konfiguration

Am einfachsten im Browser: Mit MRadmin (ab der Version mit „Konfiguration im Browser“) unter Plugins → MRpvp → Konfiguration - jede Einstellung mit Erklärung, Speichern lädt MRpvp sofort neu (Permission mradmin.config). Alles steht außerdem kommentiert in plugins/MRpvp/config.yml; Änderungen von Hand übernimmst du mit /mrpvp reload.

Alle Texte stehen in plugins/MRpvp/lang/<sprache>.yml (MiniMessage), die Kits in kits.yml, die Arenen unter templates/, Runden und Statistik in der Datenbank mrpvp.db.

#Discord-Log

MRpvp meldet in einen Discord-Kanal:

• Runden: Duell beendet (duel-ended, anfangs aus - kommt bei jedem Duell), auffällige Runde (alert), Runde wartet auf Prüfung (review-waiting), Prüfung entschieden (review-counted / review-discarded).
• Team-Eingriffe: Runde abgebrochen oder mit Sieger beendet, pausiert und fortgesetzt, nachträglich aus der Wertung genommen oder wieder gewertet.
• Kits und Arenen: Kit gespeichert, gelöscht, importiert; Arena veröffentlicht, gelöscht, Entwurf verworfen.
• Spieler und Verwaltung: Duell-Sperre und Aufhebung, Statistik zurückgesetzt, Inventar zurückgegeben, Standard wiederhergestellt, Reload.

1. In Discord: Kanal bearbeiten → Integrationen → Webhooks → Neuer Webhook und die Webhook-URL kopieren.
2. In der Config discord.enabled: true setzen und die URL bei webhook-url eintragen.
3. /mrpvp reload, dann mit /mrpvp discord test prüfen.

Unter discord.events legst du pro Ereignis fest, ob es gesendet wird und in welcher Farbe. Die Texte stehen in der Sprachdatei unter discord.

Kein eigener Webhook? Mit MRadmin geht es auch über dessen Discord-Log: discord.enabled: true, webhook-url leer lassen und discord.use-mradmin-webhook: true setzen. Wer bisher monitor.discord an hatte, bekommt das beim Update automatisch.

Mit MRadmin steht jedes Ereignis außerdem im Protokoll der Weboberfläche (bis zu 14 Tage) - auch wenn Discord aus ist.

#Zusammenarbeit mit anderen Plugins

MRpvp läuft allein. Zusammen mit anderen MRtechnology-Plugins kann es mehr - die Plugins sprechen dafür über MRadmin miteinander:

#Mehrere Welten (Multiverse)

Duelle lassen sich aus jeder Welt starten, danach geht es an denselben Ort zurück. Fehlt die Welt, landet der Spieler am Spawn der Hauptwelt.

• Multiverse-Core: Die Arena-Welt verwaltet MRpvp selbst. Importiere sie nicht mit /mv import, sonst setzt Multiverse dort seinen Spielmodus durch.
• Multiverse-Inventories: Bei Wechseln in die Arena-Welt und zurück bleibt das Inventar bei MRpvp, Multiverse-Inventories fasst es dann nicht an. Nichts einzustellen.

#Häufige Fragen

Kann beim Duell etwas aus dem Inventar verloren gehen? Nein. Alles wird in der Datenbank gesichert, bevor etwas am Inventar geändert wird - auch ein Absturz verliert nichts. Admins sehen jede Sicherung im Admin-Menü unter Runden und können eine offene Rückgabe sofort ausführen.

Warum zählt eine Runde nicht in meiner Statistik? Sie wurde als auffällig markiert - z.B. zu viele Runden gegen denselben Gegner oder eine sehr kurze Runde ohne Treffer - und wartet auf eine Prüfung durch das Team. Spätestens nach 7 Tagen wird sie automatisch entschieden.

Kann ich eigene Kits nur für VIPs anbieten? Ja: Gib dem Kit in kits.yml eine permission und vergib sie an die VIP-Gruppe.

Mein neues Kit steht im Admin-Menü, aber nicht in /duel. Ein Kit ist nur wählbar, wenn mindestens eine eingeschaltete Arena dazu passt. Häufige Gründe: Die Arena ist auf „nur Elytra“ gestellt, das Kit hat aber keine Elytra; die Arena lässt nur bestimmte Kits zu; das Kit braucht „Bauen“, die Arena erlaubt es nicht. Die Kit-Liste im Admin-Menü zeigt solche Kits rot an, der Kit-Editor im Web nennt bei jeder Arena den Grund.

Ich habe einen Fehler gefunden oder einen Wunsch. Gern über das Formular auf der Website - am besten mit der Spiel-ID der betroffenen Runde und der Ausgabe von /mrpvp version.

#Lizenz

MRpvp steht unter der MRtechnology Lizenz (source-available, nicht Open Source). Kurz gesagt:

Die Nutzung erfolgt auf eigenes Risiko - leg vor Updates eine Sicherung an. Maßgeblich ist der vollständige Text in LICENSE.

#Für Entwickler

Selbst bauen mit Java 25: gradlew build → build/libs/. Branches und Releases: docs/RELEASES.md, Konzept und Stand: docs/PLAN.md.