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 kanonenspezifische Konfiguration, Tasks und Schutz-Adapter neu
/wc setup	Spieler	Öffnet das Nightbreak-Content-Browser-Menü (listet installierte und herunterladbare Kanonenpakete auf)
/wc recommendedplugins	Beliebig	Öffnet den Nightbreak-Katalog der empfohlenen Begleit-Plugins für CannonRTP
/wc downloadpluginupdate	Beliebig	Lädt eine neuere CannonRTP-Plugin-Jar von Nightbreak herunter (wird nach dem nächsten Serverneustart angewendet)
/wc downloadall	Beliebig	Lädt das CannonRTP-Plugin-Update und jedes verfügbare Content-Paket von Nightbreak herunter
/wc downloadallcontent	Beliebig	Lädt jedes verfügbare CannonRTP-Content-Paket von Nightbreak herunter (nur Inhalte, keine Plugin-Jar)
/wc updatecontent	Beliebig	Lädt Updates für veraltete CannonRTP-Content-Pakete herunter (Alias: /wc updateallcontent)

CannonRTP liefert kein separates Erstinstallations-Menü /wc initialize mit -- es hat keine voreingestellten Modi. Wenn ein Admin nach der Installation zum ersten Mal beitritt, fordert ihn eine Nightbreak-Chat-Warnung auf, /wc setup auszuführen.

Alle oben genannten Admin-Unterbefehle erfordern cannonrtp.admin.

Diese Nightbreak-Befehle sind in CannonRTP enthalten

/wc setup, /wc recommendedplugins, /wc downloadpluginupdate, /wc downloadall, /wc downloadallcontent und /wc updatecontent werden von der gemeinsamen MagmaCore-Bibliothek bereitgestellt, die in CannonRTP eingebettet (shaded) ist. Sie werden automatisch registriert -- du siehst sie nicht in der plugin.yml. Der separate Befehl /nightbreaklogin <token> (ebenfalls aus MagmaCore) registriert deinen Nightbreak-Konto-Token für Premium-Downloads.

Details dazu, was /wc setup, /wc downloadall und /wc updatecontent tatsächlich verwalten, findest du auf der Seite Content-Pakete.

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

In der plugin.yml sind zwei Berechtigungsknoten registriert:

Berechtigung	Standard	Beschreibung
cannonrtp.admin	op	Für jeden Admin-Unterbefehl erforderlich (einschließlich der gebündelten Nightbreak-Befehle setup / downloadall / updatecontent)
cannonrtp.use	true	Erforderlich, bevor ein Spieler eine Kanone auslösen kann

Der gemeinsame Befehl /nightbreaklogin <token> (von MagmaCore bereitgestellt, nicht in der plugin.yml von CannonRTP deklariert) verwendet seinen eigenen Berechtigungsknoten nightbreak.login.

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.