Teleport-System

Alle Teleports des Servers laufen über eine gemeinsame Engine: Homes, Warps, TPA, Spawn, /back und RTP bekommen automatisch Sicherheitsprüfung der Zielposition, Kampf-Sperre, Warmup, Cooldown und Kosten. Admin-Teleports wirken sofort und überspringen alle diese Prüfungen.

Commands #

Command	Syntax	Permission	Default	Beschreibung
`/back`	`/back`	`back.use`	true	Teleportiert zur letzten Position vor Teleport/Tod
`/dback`	`/dback`	`dback.use`	true	Teleportiert zur letzten Todesposition
`/tp`	`/tp <spieler> [spieler2]`	`teleport.tp`	false	Admin: zu einem Spieler oder Spieler zu Spieler
`/tphere`	`/tphere <spieler>`	`teleport.tphere`	false	Admin: Spieler zu dir
`/tppos`	`/tppos <x> <y> <z> [welt]`	`teleport.tppos`	false	Admin: zu Koordinaten
`/tpall`	`/tpall`	`teleport.tpall`	false	Admin: alle Spieler zu dir

Weitere Permissions #

Permission	Default	Beschreibung
`back.ondeath`	true	Todesposition wird als `/back`-Ziel gespeichert
`teleport.bypass.safety`	false	Überspringt die Sicherheitsprüfung der Zielposition
`teleport.bypass.combat`	false	Teleportiert trotz Kampf-Sperre
`warmup.bypass.<command>`	false	Überspringt den Warmup des jeweiligen Befehls
`cooldown.bypass.<command>`	false	Überspringt den Cooldown des jeweiligen Befehls
`cost.bypass.<command>`	false	Der jeweilige Befehl kostet nichts

💡

Tipp: Nach erfolgreichem /back bzw. /dback ist die jeweilige Position verbraucht, das verhindert Hin- und Herspringen zwischen zwei Punkten. /dback nutzt für Warmup/Cooldown/Kosten denselben Schlüssel back wie /back.

💡

Tipp: Scheitert ein Teleport nach der Abbuchung noch (z. B. keine sichere Zielposition gefunden), werden die Kosten automatisch zurückerstattet.

Konfiguration (modules/teleport.yml) #

YAML

# Schaltet das Teleport-Modul ein oder aus.
enabled: true

teleport:
  safety-check:
    # Prüft vor jedem regulären Teleport, ob die Zielposition sicher ist
    # (fester Boden, freier Platz, kein Gefahren-Block wie Lava oder Kaktus).
    # Ist sie unsicher, wird im Umkreis bis search-radius (Blöcke) nach einer
    # sicheren Stelle gesucht; ohne Fund schlägt der Teleport fehl.
    enabled: true
    search-radius: 5
  combat-tag:
    # Wer im PvP getroffen wird, gilt für duration Sekunden als "im Kampf"
    # (Angreifer und Opfer). Solange sind reguläre Teleports blockiert.
    # Admin-Teleports sind nie betroffen.
    enabled: true
    duration: 10
  back:
    # Eine neue Back-Position wird nur gespeichert, wenn sie mindestens
    # min-distance Blöcke von der aktuellen entfernt ist (ein Weltwechsel
    # speichert immer). Todespositionen für /dback speichern immer.
    min-distance: 5
    # In diesen Welten wird keine Back-Position gespeichert oder genutzt.
    world-blacklist: []

cooldown:
  # Wartezeit in Sekunden zwischen zwei Nutzungen, pro Spieler und Befehl.
  commands:
    back: 5

cost:
  # Economy-Kosten pro Nutzung. 0 = kostenlos. Abgebucht wird erst
  # unmittelbar vor dem Sprung, bei Fehlschlag gibt es den Betrag zurück.
  commands:
    back: 0

warmup:
  # Countdown vor dem Sprung. Bewegung bricht ab (Umschauen zählt nicht),
  # ein zweiter Befehl während des Countdowns wird abgelehnt.
  commands:
    back:
      duration: 3

Warmup, Cooldown und Kosten (global) #

Die Standardwerte für alle Befehle stehen in der config.yml; jedes Modul überschreibt sie pro Befehl in seiner eigenen modules/*.yml (wie oben bei back gezeigt).

YAML

# config.yml
warmup:
  default:
    # Countdown in Sekunden. 0 deaktiviert das Warmup.
    duration: 3
    # true = ein echter Schritt bricht das Warmup ab (Umschauen nicht).
    cancel-on-move: true
    # Anzeige des Countdowns: actionbar, bossbar, both oder none.
    # Die Bossbar wechselt mit dem Fortschritt die Farbe (grün/gelb/rot).
    display: actionbar
    # Partikel-Kreis auf Brusthöhe während des Countdowns.
    particles:
      enabled: true
      type: PORTAL
      count: 10
      radius: 0.5
  commands: {}

cooldown:
  # Fallback in Sekunden für Befehle ohne eigenen Wert. Cooldowns sind
  # zeitstempelbasiert (lag-unabhängig) und gehen beim Relog verloren.
  default: 0
  commands:
    pay: 1

cost:
  # Core-eigene Kosten; Modul-Kosten liegen in modules/*.yml.
  commands: {}

💡

Tipp: Fehlt eine Option in einem warmup.commands.<befehl>-Block, greift automatisch der warmup.default-Wert aus der config.yml.

Komplette Beispiel-Config #

So könnte eine angepasste modules/teleport.yml auf einem Survival-Server aussehen:

YAML

enabled: true

teleport:
  safety-check:
    enabled: true
    search-radius: 8
  combat-tag:
    enabled: true
    duration: 15
  back:
    min-distance: 10
    world-blacklist:
      - event_world
      - build_contest

cooldown:
  commands:
    back: 30

cost:
  commands:
    back: 25.0

warmup:
  commands:
    back:
      duration: 5

← ZurückPerformance Weiter →Homes