Reports

Spieler melden andere Spieler mit /report. Das Team wird ingame benachrichtigt und bearbeitet den Report im Dashboard: annehmen, hinteleportieren bzw. das Replay ansehen, bannen oder muten, schließen. Ingame gibt es für das Team keine Report-Befehle mehr – /reportsystem wurde entfernt.

Hinweis

Lizenz: reports gehört standardmäßig zur kostenlosen Base (zusammen mit core, punishments, lobby). Das zugehörige Modul replay braucht eine EternalSystem-Lizenz. Welche Module frei sind, kann sich ändern – gesperrte Module zeigt das Dashboard ausgegraut.

Einschalten

Modul-Schlüssel: reports (keine Abhängigkeiten), siehe Module & Presets.
Im Netzwerk auch auf dem Proxy einschalten – dort läuft /report. Das Grund-Menü öffnet der Spigot-Server, auf dem der Melder steht; dort muss reports ebenfalls an sein.
Für Aufnahmen: Modul replay auf den Spielservern (siehe Replays). Für den Chat-Verlauf: Modul chatlog. Bann-Gründe und Strafen: siehe Bans & Mutes.
Dashboard-Aktionen brauchen die REST-API: api.enabled: true und api.shared-secret in config.yml.

/report

Befehl	Recht	Beschreibung
`/report <Spieler>`	`eternal.report`	Öffnet das Grund-Menü (eine Kiste mit einem Symbol pro Grund)
`/report <Spieler> <Nr oder ID> [Kommentar]`	`eternal.report`	Meldet direkt. `Nr` = Position in der Liste (ab 1), `ID` = `id` aus `report-reasons` (z. B. `hacking`)

eternal.report hat die Standard-Stufe Alle (in plugin.yml: default: true). Sich selbst melden geht nicht. Kommentare gibt es nur über die Befehlsform, das Menü sendet keinen Kommentar.

Report-Gründe (reasons.yml)

report-reasons:
  - id: hacking
    label: "Hacking / Cheating"
    material: IRON_SWORD
    slot: 0
  - id: chat-insult
    label: "Beleidigung im Chat"
    material: WRITABLE_BOOK
    slot: 11
  - id: other
    label: "Sonstiges"
    material: BOOK
    slot: 24

Feld	Bedeutung
`id`	Eindeutiger Text-Schlüssel, auch für `/report <Spieler> <id>`
`label`	Anzeige im Menü, im Dashboard und in der Benachrichtigung
`material`	Bukkit-Material für das Symbol. Tippfehler → `PAPER` und eine Warnung im Log
`slot`	Platz im Menü (Kiste mit 3 Reihen, `0`–`26`). `-1` = automatisch

Wie bei den Bann-Gründen ist die reasons.yml auf dem Proxy maßgeblich (siehe Bans & Mutes).

config.yml

reports:
  cooldown-seconds: 30        # Wartezeit zwischen zwei Reports eines Spielers
  max-open-per-reporter: 3
  notify-online-staff: true   # ingame-Meldung an das Team
  teleport-on-claim: true

Warnung

max-open-per-reporter und teleport-on-claim werden in der aktuellen Version gelesen, aber nicht ausgewertet. Eine Obergrenze offener Reports pro Spieler gibt es derzeit nicht; der Teleport läuft immer über den Button TP im Dashboard.

Der Cooldown gilt pro Spieler und Server-Instanz (Proxy bzw. Spigot), er wird nicht in der Datenbank gespeichert und beginnt nach einem Neustart neu.

Benachrichtigung des Teams

Bei notify-online-staff: true bekommen alle Online-Teammitglieder mit eternal.report.notify die Zeile aus report-staff-notify:

NEUER REPORT #42 » Steve (Hacking / Cheating) von Alex

Wer in /settings Reports empfangen ausschaltet, bekommt keine Meldung mehr (siehe Einstellungen).
Ist das Ziel gerade genickt, zeigt die Meldung den Nicknamen, damit die Tarnung nicht auffliegt. Das Dashboard zeigt den echten Namen.

Aufnahme beim Report

Ist das Modul replay auf dem Server des gemeldeten Spielers aktiv, friert der Report die letzten replay.retention-seconds (Standard 60 s) ein und nimmt danach weiter auf, bis der Report angenommen/geschlossen wird oder replay.max-followup-seconds (Standard 600 s) erreicht sind. Steht der Melder auf einem anderen Server als der Gemeldete, leitet der Proxy die Aufnahme an den richtigen Server weiter. Details: Replays.

Bearbeiten im Dashboard (Moderation → Reports)

Recht: eternal.report.handle (Standard-Stufe Team).

Reiter: Aktiv, Offen, In Bearbeitung, Geschlossen, Alle. Pro Report:

Button	Recht	Wirkung
Annehmen	`eternal.report.handle`	Report gehört dir (Status „In Bearbeitung“)
TP	`eternal.report.handle`	Bist du ingame online, verbindet dich der Proxy mit dem Server des Gemeldeten. Liegt dort ein Replay, startet es; ohne Replay-Modul wirst du live zum Ziel teleportiert
Bannen	`eternal.ban`	Dialog mit erlaubten Gründen, bannt, schließt den Report und verknüpft ihn mit dem Bann. Der Spieler wird sofort gekickt
Muten	`eternal.mute`	wie Bannen, als Mute
Schließen	`eternal.report.handle`	Abschluss mit Begründung
Replay im Browser	`eternal.replay.rewatch`	3D-Player im Dashboard

Welche Gründe im Bann-/Mute-Dialog erscheinen, regeln die Rechte eternal.ban.reason.<id> (siehe Bans & Mutes). Die Option Sonstiges erlaubt freies Label und Dauer.

Hinweis

Die Dashboard-Buttons wirken ingame nur, wenn du mit deinem Minecraft-Account eingeloggt bist. Ein statischer API-Key hat keinen Spieler – Annehmen und TP sind damit nicht möglich.

Chat-Verlauf zum Report

Bei Chat-Reports (Beleidigung, Spam, Werbung …) lässt sich der Chat-Verlauf rund um den Zeitpunkt der Meldung aufklappen. Recht: eternal.web.player.view, Voraussetzung: Modul chatlog.

chatlog:
  report-context-before: 10           # Nachrichten vor der Meldung
  report-context-after: 10            # Nachrichten nach der Meldung
  report-context-window-seconds: 120  # so lange wird auf die "after"-Nachrichten gewartet

Nach Ablauf des Fensters wird der Ausschnitt am Report gespeichert und ändert sich nicht mehr.

Was mit dem Replay passiert

Ausgang	Replay
Bann aus dem Report	bleibt erhalten, bis der Bann über das Dashboard aufgehoben wird
Mute aus dem Report	bleibt erhalten
Schließen ohne Strafe	Server-Datei und Web-Kopie werden gelöscht

Rechte

Recht	Standard-Stufe	Zweck
`eternal.report`	Alle	`/report`
`eternal.report.handle`	Team	Reports im Dashboard bearbeiten
`eternal.report.notify`	Team	Ingame-Meldung bei neuen Reports
`eternal.replay.rewatch`	Team	Replays ansehen
`eternal.web.player.view`	Team	Chat-Verlauf zum Report, Spieler-Profile

Ingame gelten die plugin.yml-Standards (eternal.report: true, eternal.report.notify: op), solange Eternal Perms nichts anderes sagt. Siehe Rechte-Referenz.

Typische Stolperfallen

Menü öffnet sich nicht: reports ist auf dem Proxy an, aber nicht auf dem Spigot-Server des Melders – das Menü wird immer auf dem Backend geöffnet.
Kein Replay zum Report: replay ist auf dem Server des Gemeldeten aus, der Spieler war schon offline, oder server-name in der config.yml passt nicht zum Servernamen im Proxy. Die Meldung „Kein Replay: Modul replay ist auf … nicht aktiv — Live-TP“ weist darauf hin.
TP passiert nichts: Du bist nicht ingame online, oder die API-Anbindung (api.enabled, shared-secret) fehlt auf dem Server.
Benachrichtigungen fehlen: eternal.report.notify fehlt im Rang oder „Reports empfangen“ ist in /settings aus.