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

create, place, remove, target und center speichern ihre Konfiguration, bevor sie die Änderung anwenden. Schlägt das Speichern fehl, meldet der Befehl den Fehler und lädt weder neu noch wendet er die Änderung an. Behebe das gemeldete Dateiproblem vor einem erneuten Versuch.

Nach einer erfolgreichen Änderung bauen diese Befehle und delete jede Kanone neu auf, nicht nur die bearbeitete. Laufende Starts werden abgebrochen und die betroffenen Spieler auf ihren Kanonensitz zurückgesetzt, jede Kanone verwirft ihre wartenden Ziele und beginnt neu zu suchen, und alle Start-Cooldowns werden zurückgesetzt.

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 neue Kanonenkonfiguration und platziert die erste Instanz an deiner aktuellen Position. Lehnt eine bereits existierende ID ab; verwende /wc place, um ihr eine Platzierung hinzuzufügen.
/wc create <id> <display_name>	Spieler	Wie oben, setzt aber einen benutzerdefinierten Anzeigenamen (Unterstriche werden zu Leerzeichen)
/wc place <id>	Spieler	Fügt eine weitere Platzierung einer bestehenden Kanone an deiner aktuellen Position hinzu
/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 CannonRTP vollständig neu: jede Konfigurationsdatei, Kanone und jeden Schutz-Adapter sowie alles, was im Ordner imports/ wartet
/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. Sie wird nach dem nächsten Serverneustart verwendet, oder früher, wenn nightbreak.applyPluginUpdatesWithoutRestart in der config.yml auf when-empty oder immediately steht
/wc applypluginupdate	Beliebig	Wendet ein bereits heruntergeladenes CannonRTP-Update ohne Neustart an, indem das Plugin aus der neuen Jar neu geladen wird. Wird abgelehnt, wenn kein gültiges, neueres Update wartet, wenn ein Plugin eines anderen Autors von CannonRTP abhängt oder es als Soft-Dependency nutzt, oder solange ein anderer Plugin-Austausch läuft. Lässt sich die neue Jar nicht aktivieren, wird die vorherige Jar wieder geladen und das Update bleibt für den nächsten Neustart im Update-Ordner. Siehe Updates ohne Neustart anwenden.
/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)
/wc forcereinstallcontent <package|all>	Beliebig	Lädt Inhalte erneut von Nightbreak herunter, selbst wenn die lokale Kopie bereits aktuell ist -- damit reparierst du beschädigte oder von Hand bearbeitete Paketdateien. Übergib all für jedes bereits heruntergeladene Paket oder vervollständige per Tab einen einzelnen Nightbreak-Paket-Slug (free-cannon-model, cannonrtp-premium-cannon-model).

/wc initialize öffnet für Spieler mit cannonrtp.admin die Ersteinrichtung. /wc setup öffnet den Inhaltsbrowser. Die gemeinsame Startinitialisierung registriert beide Befehle; Voreinstellungsmodi bestimmen nicht, ob initialize verfügbar ist.

Solange die Einrichtung nicht als abgeschlossen markiert ist (setupDone in der config.yml), erhalten Spieler mit cannonrtp.admin etwa 10 Sekunden nach dem Beitritt eine Chat-Erinnerung mit anklickbaren Links zu /wc initialize und /wc setup. Jede Auswahl im Ersteinrichtungsmenü (Recommended Setup, Manual Setup, Use Current Content) setzt setupDone auf true und beendet die Erinnerung.

Alle oben genannten Admin-Unterbefehle erfordern cannonrtp.admin.

Diese Nightbreak-Befehle sind in CannonRTP enthalten

/wc setup, /wc initialize, /wc recommendedplugins, /wc downloadpluginupdate, /wc applypluginupdate, /wc downloadall, /wc downloadallcontent, /wc updatecontent und /wc forcereinstallcontent 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 (ebenfalls aus MagmaCore) verknüpft den Server für Premium-Downloads mit deinem Nightbreak-Konto, und /nightbreaklogout trennt ihn wieder (siehe Einen Server trennen).

MagmaCore registriert außerdem /wcchangelog, das Admins ungelesene Versionshinweise zu CannonRTP und den Kanonenpaketen anzeigt. Siehe Changelog-Benachrichtigungen.

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. Die drei eingebauten Dateien (example_cannonrtp, cannonrtp_free_cannon, cannonrtp_premium_cannon) kehren beim folgenden Reload mit ihren Standardwerten und ohne Platzierungen zurück.

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

Die gemeinsamen Befehle /nightbreaklogin und /nightbreaklogout (von MagmaCore bereitgestellt, nicht in der plugin.yml von CannonRTP deklariert) verwenden ihren eigenen Berechtigungsknoten nightbreak.login, der standardmäßig op ist.

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 auf eine bestehende Kanone wirken (place, remove, delete, target, center), vervollständigen <id> per Tab aus der Liste der bekannten Kanonen-Konfigurations-IDs und akzeptieren nur eine bereits existierende ID. /wc create ist die Ausnahme: <id> und <display_name> sind Freitext, daher zeigt die Tab-Vervollständigung dort nur den Hinweis <id> / <display_name>. Befehle, die ein <world>-Argument akzeptieren, vervollständigen per Tab aus der Liste der aktuell geladenen Weltnamen, und /wc forcereinstallcontent vervollständigt all sowie jeden Nightbreak-Paket-Slug.