Skip to content
RonanCraft edited this page Jan 1, 2024 · 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
  • 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 and players can rtp instantly after an rtp into another world, rather than having to wait for the most recent cooldown.
        Cooldown:
          Enabled: true
          LockAfter: 0 #Lock the player in infinite cooldown after X rtp's
          Time: 60 #In seconds
          PerWorld: false #Cooldowns handled only for each world? If disabled, player cannot rtp in another world until cooldown has passed
  • 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!
Check out World Setup Types to see more information


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
Check out World Setup Types to see more information Examples:

CustomWorlds:
  - custom_world_name:
      UseWorldBorder: false
      MaxRadius: 1000
      MinRadius: 100
      CenterX: 0
      CenterZ: 0
      Shape: circle
      Price: 50
      MinY: 0
      MaxY: 320
      Cooldown: 300 #5 minute world cooldown
  - 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> Check out World Setup Types to see more information

PermissionGroup: #Player requires "betterrtp.group.<group_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!