CannonRTP-Befehle und -Berechtigungen

CannonRTP registriert seine Befehle unter dem Namespace cannonrtp.

• Hauptbefehl: /cannonrtp
• Aliase: /crtp, /wc

/wc ist der kurze Alias, den die meisten Admins verwenden, aber der zugrunde liegende Berechtigungsknoten ist für jeden Unterbefehl cannonrtp.admin.

Admin-Befehle

Befehl	Absender	Beschreibung
/cannonrtp	Beliebig	Zeigt den Hilfekopf gefolgt von jedem registrierten Unterbefehl, den der Absender nutzen kann
/wc help	Beliebig	Wie /cannonrtp -- gibt die Hilfeliste aus
/wc create <id>	Spieler	Erstellt eine brandneue Kanonenkonfiguration und platziert die erste Instanz an deiner aktuellen Position
/wc create <id> <display_name>	Spieler	Wie oben, setzt aber einen benutzerdefinierten Anzeigenamen (Unterstriche werden zu Leerzeichen)
/wc place <id>	Spieler	Hängt eine weitere Platzierung einer bestehenden Kanone an deiner aktuellen Position an
/wc remove <id>	Spieler	Entfernt die nächstgelegene Platzierung von <id> in deiner aktuellen Welt (Konfigurationsdatei bleibt erhalten)
/wc delete <id>	Beliebig	Löscht die Konfigurationsdatei der Kanone vollständig
/wc target <id> <world>	Spieler	Ändert die Ziellandewelt der Kanone
/wc center <id>	Spieler	Setzt das Suchzentrum der Kanone auf deine aktuelle Position
/wc list	Beliebig	Listet jede Platzierung mit Anzeigename, Status, Warteschlangengröße und letztem Statusdetail auf
/wc status	Beliebig	Gleiche Ausgabe wie /wc list
/wc probe	Spieler	Testet, ob deine aktuelle Position alle aktivierten Schutzprüfungen bestehen würde
/wc reload	Beliebig	Lädt die globale Konfiguration, jede Kanonenkonfiguration, Tasks und Schutz-Adapter neu
/wc setup	Spieler	Öffnet das Nightbreak-Setup-Menü
/wc downloadall	Beliebig	Lädt jedes verfügbare Content-Paket von Nightbreak herunter
/wc updatecontent	Beliebig	Aktualisiert bereits installierte Content-Pakete (Alias: updateall)
/wc initialize	Spieler	Öffnet das Erstinstallations-Menü

Alle Admin-Befehle erfordern cannonrtp.admin.

create vs place vs remove vs delete

Eine einzige Kanonenkonfiguration (plugins/CannonRTP/cannons/<id>.yml) kann viele Platzierungen in der Welt steuern. create erstellt die Konfiguration und legt die erste Platzierung an. place fügt einer bestehenden Konfiguration eine weitere Platzierung hinzu. remove löscht eine Platzierung (die dir in deiner Welt am nächsten gelegene), behält aber die Konfiguration. delete löscht die Konfigurationsdatei vollständig und entfernt damit jede Platzierung.

Spielerinteraktion

Es gibt keinen Spielerbefehl, um eine Kanone zu aktivieren. Spieler nutzen CannonRTP, indem sie in den Auslöseradius der Kanone (triggerRadius, Standard 1,75 Blöcke) treten.

Berechtigungen

Nur zwei Berechtigungsknoten sind in plugin.yml registriert:

Berechtigung	Standard	Beschreibung
cannonrtp.admin	op	Für jeden Admin-Unterbefehl erforderlich
cannonrtp.use	true	Erforderlich, bevor ein Spieler eine Kanone auslösen kann

Wie cannonrtp.use funktioniert

Wenn einem Spieler cannonrtp.use fehlt, ignoriert die Kanone diesen Spieler stillschweigend. Für diese grundlegende Berechtigungsprüfung wird keine Ablehnungsnachricht gesendet -- sie laufen einfach durch den Kanonenbereich, ohne gestartet zu werden.

Kanonenspezifische Berechtigungssperre

Jede Kanonenkonfiguration kann zusätzlich ein Feld requiredPermission definieren.

• Wenn requiredPermission leer ist (Standard), prüft die Kanone nur cannonrtp.use.
• Wenn requiredPermission gesetzt ist und der Spieler cannonrtp.use hat, aber den kanonenspezifischen Knoten nicht besitzt, sendet CannonRTP die konfigurierte noPermission-Nachricht inklusive des Anzeigenamens der Kanone. Die Nachricht ist auf einmal alle drei Sekunden pro Spieler und Kanone gedrosselt.

Tab-Vervollständigung

Befehle, die ein Kanonen-<id>-Argument akzeptieren, vervollständigen per Tab aus der Liste der bekannten Kanonen-Konfigurations-IDs. Befehle, die ein <world>-Argument akzeptieren, vervollständigen per Tab aus der Liste der aktuell geladenen Weltnamen.