OneWay Elytra

Ein Minecraft-Plugin für Paper/Spigot 1.21.1, das ein spezielles Elytra-System mit radiusbasierten Einschränkungen implementiert.

Was macht dieses Plugin?

Dieses Plugin erstellt ein „OneWay Elytra”-System, bei dem bestimmte Elytra nur innerhalb eines konfigurierbaren Radius um einen Spawnpunkt verwendet werden können. Normale Elytra funktionieren wie gewohnt und sind davon nicht betroffen.

Funktionen

• Radiusbasierte Elytra-Verwendung: OneWay-Elytra können nur innerhalb eines definierten Radius um den Spawnpunkt herum getragen werden.
• Automatische Elytra-Verwaltung:
  • Spieler erhalten automatisch eine OneWay-Elytra, wenn sie den Radius betreten.
  • Die Elytra wird automatisch entfernt, wenn Spieler den Radius verlassen (nur wenn sie nicht gleiten).
  • Warnung in der Aktionsleiste, wenn der Brustpanzer-Slot belegt ist: „Entferne zuerst deinen Brustpanzer, um die OneWay-Elytra zu erhalten!“
• Missbrauchsprävention:
  • Außerhalb des Radius kann kein neues Gleiten gestartet werden.
  • Spieler, die bereits fliegen, können ihren Flug bis zur Landung fortsetzen.
• Landungserkennung: Wenn ein Spieler außerhalb des Radius landet, wird die Elytra automatisch entfernt.
• Flexible Entfernungsmodi:
• MOVE_TO_INVENTORY: Die Elytra wird ins Inventar verschoben (oder fallen gelassen, wenn dieses voll ist).
• DROP: Die Elytra wird sofort gelöscht (kann nicht wieder aufgenommen werden).
• Mehrsprachige Unterstützung:
  • Sprachdateien für Deutsch (de) und Englisch (en) enthalten.
  • Alle Meldungen können in lang/de.yml oder lang/en.yml angepasst werden.
  • Konfigurationsoption lang: de oder lang: en zum Wechseln der Sprache.

Installation

1. Laden Sie die Datei „OneWayElytra-1.0.0.jar” herunter.
2. Legen Sie sie im Ordner „plugins” Ihres Servers ab.
3. Starten Sie Ihren Server neu.
4. Konfigurieren Sie den Spawnpunkt und den Radius (siehe unten).

Konfiguration

Die Konfigurationsdatei befindet sich unter „plugins/OneWayElytra/config.yml”:

# OneWay Elytra Plugin-Konfiguration
# Sprache: de = Deutsch, en = Englisch (Nachrichtendateien im Plugin-Ordner: lang/de.yml, lang/en.yml)
lang: en

# Spawnpunkt (Welt + Koordinaten)
spawn:
  world: „world“
  x: 0.0
  y: 64.0
  z: 0.0

# Radius in Blöcken
radius: 100

# Entfernungsmodus beim Verlassen der Zone: MOVE_TO_INVENTORY oder DROP
removeMode: „MOVE_TO_INVENTORY“

# Debug-Modus (zusätzliche Konsolenausgabe)
debug: false

Sprachdateien

Alle für den Spieler sichtbaren Meldungen sind in Sprachdateien gespeichert:

• plugins/OneWayElytra/lang/de.yml – Deutsche Meldungen (Standard)
• plugins/OneWayElytra/lang/en.yml – Englische Meldungen

Diese Dateien werden beim ersten Start automatisch erstellt und können bearbeitet werden, um Meldungen anzupassen. Verwenden Sie & für Farbcodes (z. B. &c für Rot, &a für Grün).

Befehle

/oe setspawn

Setzt den Spawnpunkt auf Ihre aktuelle Position.

/oe setradius <Blöcke>

Setzt den Radius in Blöcken (z. B. /oe setradius 50).

/oe setremovemode <MOVE_TO_INVENTORY|DROP>

Ändert den Entfernungsmodus:

• MOVE_TO_INVENTORY: Elytra wird ins Inventar verschoben
• DROP: Elytra wird gelöscht

/oe info

Zeigt die aktuelle Konfiguration an (Spawnpunkt, Radius, Entfernungsmodus).

/oe reload

Lädt die Konfigurationsdatei und die Sprachdateien neu.

/oe give <Spieler> [Anzahl]

Gibt einem Spieler eine oder mehrere OneWay-Elytra.

/oe tag

Markiert die Elytra in deiner Hand als OneWay-Elytra.

/oe untag

Entfernt die Markierung von der Elytra in deiner Hand.

/oe check

Überprüft, ob die Elytra in deiner Hand eine OneWay-Elytra ist.

Aliase: /onewayelytra, /oneway

Berechtigungen

• onewayelytra.admin – Erlaubt alle Admin-Befehle (Standard: OP)
• onewayelytra.bypass – Ignoriert alle OneWay-Elytra-Regeln (Standard: OP)

So funktioniert es

1. Elytra-Markierung: OneWay-Elytra werden über PersistentDataContainer (PDC) mit einem speziellen Tag markiert.
2. Automatische Verteilung: Wenn ein Spieler den definierten Radius ohne OneWay-Elytra betritt, erhält er automatisch eine.
3. Gleitschutz: Beim Start eines Gleitflugs überprüft das Plugin, ob sich der Spieler innerhalb des Radius befindet. Außerhalb des Radius wird der Start blockiert
4. Landungserkennung: Eine Aufgabe überprüft alle 2 Ticks, ob Spieler gelandet sind, und entfernt die Elytra, wenn sie sich außerhalb des Radius befinden

Technische Details

• API-Version: 1.21.1
• Abhängigkeiten: Keine (nur Paper-API)
• Java-Version: 21
• Markierung: PersistentDataContainer mit NamespacedKey onewayelytra:oneway

Fehlerbehebung

Problem: Elytra wird nicht automatisch vergeben/entfernt

• Überprüfen Sie, ob der Spawnpunkt korrekt eingestellt ist (/oe info)
• Überprüfen Sie, ob Sie sich innerhalb des richtigen Radius befinden
• Aktivieren Sie den Debug-Modus in der Konfiguration (debug: true) und überprüfen Sie die Konsole

Problem: Sonderzeichen werden falsch angezeigt

• Stellen Sie sicher, dass die Konfigurationsdatei als UTF-8 gespeichert ist
• Die Build-Datei ist bereits für UTF-8 konfiguriert

Lizenz

• Die Lizenz finden Sie hier