Config

Main configuration file, enable and disable features and configure rtp parameters.

Summary

• Language-File
• Settings
• Default
• BlacklistedBlocks
• DiabledWorlds
• CustomWorlds
• Overrides
• WorldType
• PermissionGroup

---

Language-File

Set the language, accessible at the lang file

---

Settings

Basic plugin settings that can be disabled/changed

• Respect

  Enable Plugin hooks to disallow players from teleporting randomly into defined regions.
  View which plugins are supported here

• MaxAttempts

  The maximum amount of tries to find a safe location before giving up.
  May cause performance issues if set above 100!
  Can't find a location most of the time? Try increasing the search area, and/or make sure there is mostly land around the search area!

• Cooldown

  The amount of time (in seconds) someone without the 'betterrtp.bypass.cooldown' permission must wait before rtp'ing again.
  PerWorld setting allows to have each world have a cooldown rather than having one global cooldown for every world.

      Cooldown:
        Enabled: true
        LockAfter: 0 #Lock the player in infinite cooldown after X rtp's
        Time: 60 #In seconds
        PerWorld: false #Cooldowns handled for each world?

• Delay

  Delay time someone types /rtp, to actually start rtp'ing

  Delay:
    Enabled: true
    Time: 5 #In Seconds
    CancelOnMove: true

• DisableUpdater

  Disable displaying when a new update is available?

---

Default

Set defaults when rtp'ing to a non customized world, or to a customized world missing a value, also applies to locations!

• UseWorldBorder

  Use the vanilla worldborder of a world? (Must set worldborder with the vanilla '/worldborder' command!)

• Biomes

  Set a list of biomes you'd like to limit rtp to teleport to, view more biomes here
  Caution: Limiting the amount of biomes allowed to rtp into will use up significant amount of more CPU and more attempts.

• MaxRadius

  Maximum allowed radius from the center X/Z
  Specifics: If useworldborder is true, this value will be capped at the worldborders radius

• MinRadius

  Minimum allowed radius from the centers X/Z

• CenterX/Z

  Center X/Z position that you'd like BetterRTP to function in any world, if useworldborder is true, this will be set to the vanilla worldborder center

• Shape

  Type of shape a random location should be found, supported: square, circle
  Default: Square

• MinY

  Minimum Y to find a safe location, cannot be higher than 0
  Default: 0

• MaxY

  Maximum Y to find a safe location, cannot be lower than 64 (water level)
  Default: 319

---

BlacklistedBlocks

A list of blocks you'd like to not have BetterRTP teleport a player onto (1.8 -> current)

Example:

BlacklistedBlocks:
  - stationary_water
  - stationary_lava
  - water
  - flowing_water
  - lava
  - flowing_lava
  - cactus
  - leaves
  - leaves_2
  - air
  - void_air
  - bedrock

DisabledWorlds

---

A list of worlds to NOT allowed BetterRTP to function, only overriding a world to another will allow it to function

Example:

DisabledWorlds:
  - prison
  - creative

CustomWorlds

---

Have multiple worlds follow different teleportation parameters other than the default

Examples:

CustomWorlds:
  - custom_world_name:
      UseWorldBorder: false
      MaxRadius: 1000
      MinRadius: 100
      CenterX: 0
      CenterZ: 0
      Shape: circle
      Price: 50
      MinY: 0
      MaxY: 319
  - other_custom_world:
      MaxRadius: 100000
      MinRadius: 1000
      CenterX: 123
      CenterZ: -123
      Price: 0
      Biomes:
        - 'desert'
        - 'forest'

Overrides

---

Redirect one worlds '/rtp' command to another world
Formatting is as follows, the "current world" means the world a player is standing in, and "desired world" is the world the player should be redirected to when the players executes "/rtp" in the "current world".
Format: "- <CURRENT WORLD>: <DESIRED WORLD>"
Caution: Please be sure to include the "-" as this is YAML file formatting for creating a list!

Example:

Overrides:
  #- <CURRENT WORLD>: '<DESIRED WORLD>'
  - master_world: 'world'
  - creative_world: 'world'

WorldType

---

Set how to determine a safe location (underground or highest block)

Valid Values: 'NORMAL', 'NETHER'
Description:

• NORMAL: finds the safest highest block in the world
• NETHER: finds the safest lowest block in the world (aka: caves)

Tip: Execute '/rtp info world [world_name]' to find out if the world type was registered (these are caps sensitive)

Example:

WorldType:
  - world: 'NORMAL'
  - world_nether: 'NETHER'
  - world_the_end: 'NORMAL'

PermissionGroup

---

Setup a group that will customize a players parameters for a world
Permission node is setup as such betterrtp.group.<group_name>

PermissionGroup: #Player requires "betterrtp.group.<world_name>" to trigger these configs
  Enabled: false
  Groups:
    - vip: # permission: betterrtp.group.vip
        - Build_World: #World named "Build_World"
            Priority: 100 #Higher the less prioritized
            MaxRadius: 10000
            MinRadius: 1000
            Cooldown: 500 #Custom Cooldowns for Permission Group!
        - Survival_World:
            UseWorldBorder: false
            MaxRadius: 5000
            MinRadius: 1000
            CenterX: 10
            CenterZ: 10
            Cooldown: 500 #Custom Cooldowns for Permission Group!
    - vip2: # permission: betterrtp.group.vip2
        - Build_World:
            Priority: 1 #Lower the more prioritized
            MaxRadius: 25000
            MinRadius: 10000
            Cooldown: 450 #Custom Cooldowns for Permission Group!