Configuration reference

This is the config.yml SafeRTP writes on first start, comments included. Every key you see here is the key the plugin reads; there are no hidden ones. Change a value, reload, and it applies.

Top-level sections: language, config-version, back, arrival, cache, discovery.

# SafeRTP Configuration
# World-specific settings are in worlds.yml

# Active language. ISO-639-1 two-letter code (lowercase).
# Bundled out of the box: es (Spanish), en (English).
# Missing keys fall back to en automatically. Operators can drop extra
# lang/<code>.yml files in plugins/SafeRTP/lang/.
language: en

config-version: 2

# ============================================================
# BACK COMMAND  (v1.1.0)
# ============================================================
# Lets players undo their last /rtp with /rtp back.
# The pre-teleport location is cached in memory (not in the database)
# and expires after ttl-seconds. Handy when the RTP drops someone in
# an awkward biome and they just want to go back.
back:
  enabled: true
  ttl-seconds: 300
  cooldown-seconds: 60

# ============================================================
# ARRIVAL EFFECTS  (v1.2.0)
# ============================================================
# Applied immediately after a successful RTP teleport.
arrival:
  # Seconds of invulnerability (no-damage ticks) on landing. 0 = disabled.
  invulnerability-seconds: 5
  particles:
    enabled: true
    # Any Bukkit Particle enum name. See: https://jd.papermc.io/paper/1.21/
    type: END_ROD
    count: 40
  sound:
    enabled: true
    # Any Bukkit Sound enum name.
    type: ENTITY_ENDERMAN_TELEPORT
    volume: 1.0
    pitch: 1.2

# ============================================================
# LOCATION CACHE  (v1.2.0)
# ============================================================
# Pre-calculates safe RTP locations in background so /rtp is instant.
cache:
  enabled: true
  size-per-world: 6
  refill-threshold: 2

# ============================================================
# BIOME DISCOVERY  (v1.2.0)
# ============================================================
# Special notification the first time a player RTP-lands in a new biome.
# Discoveries persist across restarts in discoveries.yml.
discovery:
  enabled: true
  sound:
    enabled: true
    type: UI_TOAST_CHALLENGE_COMPLETE
    volume: 1.0
    pitch: 1.0