CannonRTP Content-Pakete

CannonRTP verwaltet offizielle Kanonenmodelle als Content-Pakete von Nightbreak. Die aktuellen Downloads Free Cannon und Premium Cannon enthalten das FreeMinecraftModels-Modell und eine Versionsangabe für das Paket unter content_packages/. CannonRTP selbst erzeugt die zugehörigen Kanonenkonfigurationen in cannons/; die Downloads enthalten keine Platzierungskonfigurationen.

Hauptbefehle

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

Die Verwaltungsbefehle unter /wc erfordern cannonrtp.admin. Der separate Kontobefehl /nightbreaklogin <token> erfordert nightbreak.login.

Neben den Kanonenpaketen zeigt das /wc setup-Menü einen Eintrag für Plugin-Updates (ein Klick lädt ein verfügbares Update herunter), einen Eintrag für empfohlene Plugins, einen Eintrag zum Herunterladen aller Inhalte, der /wc downloadall ausführt, und einen Schalter für automatische Updates, der nightbreak.autoDownloadPluginUpdates in die config.yml schreibt (siehe Konfiguration).

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:

• isEnabled -- ob das Paket eingeschaltet ist; das /wc setup-Menü schreibt den Wert, wenn du das Paket aktivierst oder deaktivierst
• 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, auf die CannonRTP dich verweist, wenn ein Paket keinen nightbreakSlug hat und von Hand heruntergeladen werden muss, sowie der Link in der Konsolenwarnung zu einem veralteten Paket
• 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:

• installiert -- das Paket erfüllt die unten beschriebenen Download-Prüfungen, seine Metadaten enthalten isEnabled: true und passende Kanoneneinträge liegen in plugins/CannonRTP/cannons/
• heruntergeladen, aber deaktiviert -- der Modell-Download wird erkannt, das Paket ist jedoch nicht aktiv; beim Deaktivieren im Menü werden seine Kanonendateien nach plugins/CannonRTP/cannons_disabled/ verschoben
• veraltet -- das Paket ist installiert und auf Nightbreak ist eine neuere Version verfügbar; hat dein verknüpftes Konto keinen Zugriff mehr, weist das Menü darauf hin, statt das Update anzubieten
• Zugriff erforderlich -- das Paket ist nicht heruntergeladen, du bist angemeldet, und dein Nightbreak-Konto hat keinen Zugriff darauf
• nicht heruntergeladen -- eine positive lokale Versionsangabe fehlt oder die Modelldateien wurden nicht gefunden

Generierte Kanonen-YAML-Dateien allein belegen keinen Download. CannonRTP benötigt eine lokale Paket-version größer als null und mindestens eine .bbmodel-Datei im Paketordner folderName unter plugins/FreeMinecraftModels/models/ oder plugins/FreeMinecraftModels/Models/. Fehlt der Modellordner, wird das Paket wieder zum Download angeboten, auch wenn seine generierte Kanonenkonfiguration noch existiert.

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. CannonRTP erstellt seine eingebauten Dateien cannonrtp_free_cannon.yml und cannonrtp_premium_cannon.yml neu, sobald sie in cannons/ fehlen. Nach dem Deaktivieren hinterlässt der Reload dort daher Standardkopien ohne Platzierungen; beim erneuten Aktivieren werden die gespeicherten Dateien wieder darüber verschoben.

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

Du kannst ein Paket weiterhin von Hand installieren:

1. Lade das Paket-Zip von Nightbreak herunter.
2. Lege das Zip (unverändert) in plugins/CannonRTP/imports/ ab.
3. Führe /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. Verwende einmalig /nightbreaklogin <token> mit einem Token von deiner Nightbreak-Kontoseite, dann kann /wc downloadall oder das /wc setup-Menü Premium-Inhalte abrufen.

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