Zum Hauptinhalt springen

CannonRTP (WorldCannon)

CannonRTP ist ein Multi-Kanonen-Zufalls-Teleportations-Plugin für Minecraft-Server. Das Projekt heißt intern WorldCannon, aber das Plugin registriert sich als CannonRTP in Bukkit und das ist der Name, den Spieler und Admins sehen.

Wichtige Namensdetails:

  • Plugin-Name: CannonRTP
  • Hauptbefehl: /cannonrtp
  • Aliase: /crtp, /wc
  • Berechtigungen: cannonrtp.admin, cannonrtp.use
  • Konfigurationsordner: plugins/CannonRTP/

Was es macht​

CannonRTP ist ein Multi-Kanonen-Zufalls-Landesystem statt eines einzelnen festen Launchers.

Jede Kanone kann:

  • Spieler erkennen, die einen Auslöseradius betreten
  • eine Warteschlange sicherer Landeorte in einer konfigurierten Zielwelt vorladen und pflegen
  • unsicheres Gelände, blockierte Räume und geschütztes Land ablehnen
  • optional eine zusätzliche kanonenspezifische Berechtigung erfordern
  • Spieler durch eine zeitgesteuerte Aufwärmphase, Koordinatenvorschau, Boost, Teleportation und Langsam-Fall-Sequenz starten
  • optional ein FreeMinecraftModels benutzerdefiniertes Modell am Kanonenstandort anzeigen

Startablauf​

Wenn ein Spieler in den Auslöseradius einer berechtigten Kanone läuft:

  1. CannonRTP prüft cannonrtp.use.
  2. Es prüft die optionale requiredPermission der Kanone.
  3. Es überprüft, ob die Kanone aktiviert ist, eine gültige Konfiguration hat und vorgeladene Landeorte besitzt.
  4. Es verbraucht einen vorgeladenen sicheren Landeort aus der Warteschlange der Kanone.
  5. Es startet die Aufwärmphase: Der Spieler erhält Levitation und sieht einen Titel/Untertitel-Countdown mit zufälligen Koordinatenvorschauen.
  6. Wenn die Aufwärmphase endet, wird der Startton abgespielt, vertikaler Boost angewendet, der Spieler 50 Blöcke über das Ziel teleportiert und Langsames Fallen angewendet.
  7. Der Langsam-Fall-Effekt wird vorzeitig entfernt, wenn der Spieler auf dem Boden landet.

Wenn die Kanone ein customModel konfiguriert hat und das fire FreeMinecraftModels-Modell existiert, wird eine alternative Startanimation verwendet, bei der der Spieler während der Aufwärmphase am Kanonenstandort sitzt.

Landesicherheitsregeln​

Bevor ein Ort in die Vorlade-Warteschlange aufgenommen wird, prüft der aktuelle Code:

  • die Zielwelt ist geladen
  • das Suchzentrum ist gültig
  • der Ort liegt innerhalb der Weltgrenze
  • eine höchste sichere Oberfläche existiert (fest, nicht-flüssig, nicht-Luft)
  • die Fuß- und Kopfräume sind passierbar
  • die Landefläche ist nicht in der konfigurierten Liste unsicherer Bodenmaterialien
  • die Fuß- und Kopfblöcke sind nicht in der konfigurierten Liste unsicherer Körpermaterialien
  • alle aktivierten Schutz-Plugin-Integrationen erlauben den Ort

Kanonenzustände​

Jede Kanone hat einen internen Zustand, der über /wc status sichtbar ist:

ZustandBedeutung
ChargingLädt noch die erste Charge sicherer Orte vor
ReadyHat genügend vorgeladene Orte, um Spieler zu starten
MaintainingBereit, füllt aber noch verbrauchte Orte nach
ExhaustedZeitüberschreitung ohne genügend gültige Orte
InvalidKonfigurationsfehler (z.B. nicht geladene Zielwelt)

Eine Kanone wird startbereit, sobald sie mindestens chargedLocationsPerCannon gültige Ziele gespeichert hat.

Laufzeitanforderungen​

  • Minecraft API: 1.21
  • Java: 21
  • Empfohlene Server-Software: Paper oder ein aktueller kompatibler Fork
  • Optionale Abhängigkeit: FreeMinecraftModels (für benutzerdefinierte Kanonenmodelle)

Hier starten​