CannonRTP Content-Pakete

CannonRTP behandelt offizielle Kanonenmodell- und Konfigurations-Bundles als Nightbreak-verwaltete Content-Pakete statt als reine manuelle Importe. Jedes Paket enthält die Kanonen-YAML-Konfigurationen sowie alle FreeMinecraftModels-Ressourcen, die das 3D-Kanonenmodell antreiben.

Hauptbefehle

Befehl	Zweck
/wc setup	Öffnet das Nightbreak-Content-Browser-Menü (listet installierte und herunterladbare Kanonenpakete auf)
/wc downloadall	Lädt jedes verfügbare CannonRTP-Content-Paket von Nightbreak im Bulk herunter
/wc updatecontent	Aktualisiert veraltete CannonRTP-Content-Pakete im Bulk (Alias: /wc updateall)
/wc reload	Lädt CannonRTP nach einem manuellen Import neu
/nightbreaklogin <token>	Gemeinsame Nightbreak-Token-Registrierung -- erforderlich für Premium-Pakete

Alle diese Befehle erfordern cannonrtp.admin.

Integrierte Pakete

CannonRTP liefert standardmäßig Paketdefinitionen für zwei Nightbreak-Bundles aus:

Paket-ID	Anzeigename	Quelle
cannonrtp	Free CannonRTP	Kostenloser Nightbreak-Download
cannonrtp_premium	Premium CannonRTP	Erfordert Nightbreak-Premium-Supporter-Zugang

Jede Definition befindet sich in plugins/CannonRTP/content_packages/<id>.yml und speichert:

• version -- lokal installierte Version (wird von /wc updatecontent verwendet, um zu entscheiden, was veraltet ist)
• name und description -- werden im /wc setup-Menü angezeigt
• downloadLink -- die Nightbreak-Seite, die vom Bulk-Download-Ablauf verwendet wird
• folderName und contentFilePrefixes -- welche Dateien innerhalb des Pakets CannonRTP als zugehörig betrachtet
• nightbreakSlug -- der Nightbreak-Projekt-Slug, der vom Download-/Update-Endpoint verwendet wird

Diese Dateien sollten normalerweise nicht von Hand bearbeitet werden -- sie werden vom Plugin neu generiert und überschrieben.

Paketzustände

Innerhalb des /wc setup-Menüs wird jedes Paket als einer der folgenden Zustände angezeigt:

• installed -- die Kanonendateien des Pakets sind in plugins/CannonRTP/cannons/ vorhanden und isEnabled ist true
• downloaded but disabled -- die Kanonendateien des Pakets befinden sich in plugins/CannonRTP/cannons_disabled/
• outdated -- auf Nightbreak ist eine neuere Version verfügbar
• not downloaded -- lokal noch nichts vorhanden

Ein Klick auf ein Paket im Menü lädt es herunter, installiert, aktiviert oder deaktiviert es. Beim Deaktivieren eines Pakets werden seine Kanonenkonfigurationen aus cannons/ nach cannons_disabled/ verschoben, ohne sie zu löschen, sodass beim erneuten Aktivieren dieselben Dateien wiederhergestellt werden.

Kanonen-Ordnerstruktur

Ordner	Zweck
plugins/CannonRTP/cannons/	Aktive Kanonenkonfigurationen. Alles hier wird beim Start oder bei /wc reload geladen.
plugins/CannonRTP/cannons_disabled/	Paketierte Kanonenkonfigurationen, die derzeit ausgeschaltet sind. Dateien hier werden vom Loader ignoriert, aber für eine spätere Reaktivierung aufbewahrt.
plugins/CannonRTP/imports/	Ablageordner für manuelle Paketimporte. CannonRTP scannt diesen beim Start und führt seinen Inhalt in die Paketordner zusammen.

Manueller Import als Fallback

Sie können ein Paket weiterhin von Hand installieren:

1. Laden Sie das Paket-Zip von Nightbreak herunter.
2. Legen Sie das Zip (unverändert) in plugins/CannonRTP/imports/ ab.
3. Führen Sie /wc reload aus.

CannonRTP nimmt das Paket auf, verschiebt die Dateien in die entsprechenden Ordner und lädt die Kanonenkonfigurationen neu. Manueller Import wird weiterhin unterstützt, ist jedoch nicht mehr der empfohlene Arbeitsablauf -- /wc setup und /wc downloadall erledigen dies automatisch.

Premium-Zugang

Premium-Content-Pakete (wie cannonrtp_premium) erfordern ein verknüpftes Nightbreak-Konto. Verwenden Sie einmalig /nightbreaklogin <token> mit einem Token von Ihrer Nightbreak-Kontoseite, dann kann /wc downloadall oder das /wc setup-Menü Premium-Inhalte abrufen.

Wenn Sie nicht angemeldet sind, erscheinen Premium-Pakete weiterhin im Setup-Menü, können aber nicht heruntergeladen werden.