Skip to content

Config for Version 3.0

Jonathan edited this page Jan 2, 2026 · 1 revision

⚙️ Default Configuration (config.yml)

#  __          ___ _     _ _____ _______ _____
#  \ \        / (_) |   | |  __ \__   __|  __ \
#   \ \  /\  / / _| | __| | |__) | | |  | |__) |
#    \ \/  \/ / | | |/ _` |  _  /  | |  |  ___/
#     \  /\  /  | | | (_| | | \ \  | |  | |
#      \/  \/   |_|_|\__,_|_|  \_\ |_|  |_|
#
# by Joni - Thank you for using this plugin

# Language setting
# Available: [en, de]
# You can add/edit languages in the plugin folder (/lang)
lang: "en"

# Global RTP settings
# This section defines the main settings for random teleportation
# Custom settings per world can be defined in the custom section
# If 'something: null' is present, and you want to use that feature, remove null and add your settings
global:
  # Min & max teleportation range
  min: 1000
  max: 2500

  # Shape of the teleportation area [CIRCLE/SQUARE]
  shape: CIRCLE

  # Teleportation center
  center:
    player: false # If true, teleportation is centered on the player
    x: 0 # X coordinate of center
    z: 0 # Z coordinate of center

  # Cooldown settings
  cooldown:
    enabled: true # Enable cooldown between RTP uses
    time: 5 # Cooldown time in seconds

  # Move timer settings
  movetimer:
    enabled: true # If true, no movement allowed before teleportation
    time: 5 # Time in seconds
    sound-canceled: ENTITY_VILLAGER_NO # Set to 'false' to disable.

  # Message settings
  messages:
    start: false # Show message when RTP starts
    end: true # Show message when RTP ends

  # Title messages displayed when RTP starts/ends
  titles:
    start:
      enabled: false
      fadeIn: 0.5
      stay: 2
      fadeOut: 0.5
    end:
      enabled: true
      fadeIn: 0.5
      stay: 2
      fadeOut: 0.5

  # Sound settings
  sound:
    start: false # Play a sound when teleport starts. Set to 'false' to disable.
    end: ENTITY_PLAYER_LEVELUP  # Use any valid Bukkit Sound enum, e.g., ENTITY_PLAYER_LEVELUP.

  # Blocks to avoid when teleporting
  blocks:
    - LAVA
    - WATER
    - AIR

  # Y-limits for teleporting
  y-min: null
  y-max: null

  # Biomes to avoid when teleporting
  biomes:
  # - forest

  # Teleport to another world
  # If set to a valid world name, players will be teleported to that world instead of their current one.
  # Set to 'false' to teleport within the same world.
  tp-in-other-world: false

# Auto-RTP settings
# Should the plugin teleport players automatically?
auto-rtp:
  onfirstjoin: false # When a player first joins the server
  onjoin: false # Every time a player joins the server
  ondeath: false # After a player dies

# List mode: use 'blacklist' or 'whitelist'
list: blacklist
blacklist: # Add blocked worlds here
# - my_blacklisted_world
whitelist: # Add allowed worlds here
# - my_whitelisted_world

# Uncomment and modify to customize settings for specific worlds
# YOU CAN remove any fields you don’t want to customize,
# BUT missing values will be set to the global values
# (e.g. max in global is 1000 and if not set here it will be 1000 as well)
# An example is shown below:
custom:
#  custom_world_name:
#    min: 1000
#    max: 2500
#    shape: CIRCLE
#    center:
#      player: false
#      x: 0
#      z: 0
#    cooldown:
#      enabled: true
#      time: 30
#    movetimer:
#      enabled: true
#      time: 5
#      sound-canceled: ENTITY_VILLAGER_NO
#    messages:
#      start: false
#      end: true
#    titles:
#      start:
#       enabled: false
#       fadeIn: 0.5
#       stay: 2
#       fadeOut: 0.5
#      end:
#       enabled: true
#       fadeIn: 0.5
#       stay: 2
#       fadeOut: 0.5
#    sound:
#      start: false
#      end: ENTITY_PLAYER_LEVELUP
#    blocks:
#      - LAVA
#      - WATER
#      - AIR
#    y-min: null
#    y-max: null
#    biomes:
#    tp-in-other-world: false # replace with world name to tp to other world


# Maximum attempts to find a safe location before failing
max-tries: 25

# If you want to change the prefix, you can do it here
prefix: "[&2WildRTP&f] &6"

# Check for updates
check-updates: true

# Notify admins about plugin updates when they join
notify-updates-on-join: true

# If I am allowed to collect anonymous data about your server and this plugin. So I can see how many servers are using this plugin :)
# Learn more https://bstats.org/
# And you can see the data as well here https://bstats.org/plugin/bukkit/WildRTP/17799
metrics: true

# Debug mode
debug: false

# Config version (do not change)
config-version: 5

Clone this wiki locally