Skip to content
RonanCraft edited this page Sep 22, 2021 · 16 revisions

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

Summary


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
  • MinRadius

    The default minimum value (if worldborder is not set)
  • MaxAttempts

    The maximum amount of tries to find a safe location before giving up.
  • Cooldown

    The amount of time (in seconds) someone without the 'betterrtp.bypass.cooldown' permission must wait before rtp'ing again.
    Cooldown:
      Enabled: true
      LockAfter: 0 #Lock the player in infinite cooldown after X rtp's
      Time: 60 #In seconds
  • 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 a world is not customized below

  • 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 worldborders center
  • Shape

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

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_1:
      UseWorldBorder: false
      MaxRadius: 1000
      MinRadius: 100
      CenterX: 0
      CenterZ: 0
      Shape: circle
      Price: 50
  - 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 tallest block in the world
  • NETHER: finds the lowest safest block in the world (aka: caves)

Tip: Execute '/rtp info [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.config.<group_name>"

PermissionGroup: #Player requires "betterrtp.group.<world_name>" to trigger these configs
  Enabled: false
  Groups:
    - vip: # permission: betterrtp.config.vip
        - Build_World: #World named "Build_World"
            MaxRadius: 10000
            MinRadius: 1000
        - Survival_World:
            UseWorldBorder: false
            MaxRadius: 5000
            MinRadius: 1000
            CenterX: 10
            CenterZ: 10
    - vip2: # permission: betterrtp.config.vip2
        - Build_World:
            MaxRadius: 25000
            MinRadius: 10000
Clone this wiki locally