⚡️ AdvancedRTP ⚡️ - Random-teleport with players

# Command used for random teleportation
rtpCommand : "rtp"

# The minimum online level that must be on the server in order for teleportation with the NEARBY_PLAYERS type to work (next to the players)
nearbyPlayersMinOnline : 3

# Here you can set up several teleportation channels
channels :
  # The name of the channel. Used in the permission to use it. advancedrtp.channel.normal
  safe :
    # Required parameter. The argument of this channel. You can use this - /<command> <argument> (For example: rtp safe)
    argument : "safe"

    # Required parameter. Channel type. It can be DEFAULT and NEARBY_PLAYERS. DEFAULT - Normal rtp. NEARBY_PLAYERS-Near players
    type : DEFAULT

    # Optional parameter. Specify if you want to teleport the player to a certain world. By default - world
    # Please note: the plugin is designed for teleportation through the normal world. So if you specify nether or the end, teleportation
    # In most cases, it will be incorrect.
    world : world

    # Optional parameter. Specify if you want to use the default if the player does not specify any argument. (For example: rtp)
    default : true

    # Optional parameter. Delay to use teleportation in the current channel (in seconds)
    cooldown : 15

    # Required parameter. Teleportation radius. Doesn't work with the NEARBY_PLAYERS type. You need to specify x and z. Formatting: <from...> ! <before...>
    range:
      x : -1000 ! 1000
      z : -1000 ! 1000

    # Optional parameter. Type of teleportation. It can be NORMAL and SKY. With NORMAL, you will be teleported to earth. At SKY, you will be teleported into the air
    # Just like on griefer servers. Default - SKY
    teleportType : SKY

    # Optional parameter. Blocks that the plugin will not teleport to in the current channel.
    blacklistedBlocks :
     - "lava"
      - "stationary_lava"

    # Optional parameter. When teleporting, hunger will be removed. Only 20 units of hunger.
    hunger : 4

    # Optional parameter. Random teleportation actions in this channel. 1 sec = 20 ticks
    # List of actions:
    # effect, <type> <duration (in ticks)> <level> && ... - issue effects to the player.
    # title, <Heading> && <Subtitle> - send the title to the player.
    actions :
     - "effect, water_breathing 200 1 && fire_resistance 200 1"
      - "title, &6AdvancedRTP && &fNormal teleportation"

  far:
    argument : "far"
    type : DEFAULT
    range:
      x : -3000 ! 2000
      z : -5000 ! 4000
    teleportType : NORMAL
    hunger : 8
    actions :
     - "effect, water_breathing 200 1 && fire_resistance 200 1"
      - "title, &6AdvancedRTP && &fDistant teleportation"
  near:
    argument : "near"
    type : NEARBY_PLAYERS
    teleportType : NORMAL

    # Required parameter. The teleportation radius near the players.
    # In the specified range, the player will be teleported relative to the random player on the server.
    # Formatting: <from...> ! <before...>
    nearbyRange : 10 ! 100

    cooldown : 40
    hunger : 8
    actions :
     - "title, &6AdvancedRTP && &fTeleport near players"

prefix : "&6AdvancedRTP: &f"
noPermission : "You do not have permission to use this command!"
onlyForPlayers : "The team is only available to players!"
channelNotFound : "This channel does not exist!"
playerNotFound : "Player not found!"
helpOp : |
 &7==================== &6AdvancedRTP Help &7====================
  &f/{label} <channel> &a- teleport to the specified channel
  &f/{label} <channel> <player> &a- teleport the player to the specified channel
  &f/{label} reload &a- reload the plugin configuration and messages
  &f/{label} help &a- show this page
  &7==================== &6AdvancedRTP Help &7====================
helpPlayer : "Using: &a/{label} <safe/far/near>"
teleported : "You have been successfully teleported to the coordinates &a{x} {y} {z}&f!"
teleportedOther : "You have successfully teleported the player &a{player} &fto the coordinates &a{x} {y} {z}&f!"
nearbyTeleported : "You have successfully teleported next to the player &a{player}&f! Its coordinates: &a{x} {y} {z}&f."
nearbyTeleportedOther : "You have successfully teleported the player {teleportedPlayer} next to the player &a{player}&f! Its coordinates: &a{x} {y} {z}&f."
nearbyMinOnline : "This function requires a minimum of &a{count} the player(s)&f online."
nearbyEmptyWorld : "In the normal world, there are no players who failed to teleport."
noHunger : "To teleport, you need at least &a{count} unit(s)&f hunger."
cooldown : "Wait &a{remained} seconds&f before the next teleportation."
channelNoPermission:
  far : "Teleport to long distances is possible only with the privilege &a[VIP]&f!"
  nearby : "Teleport to long distances is possible only with the privilege &b[MVP]&f!"
placeholderSettings:
  cooldownIsZero : "now"

advancedrtp.admin - Allows the administrator to teleport other players to the rtp and reload the config
advancedrtp.channel.<configName> - Allows the player to teleport through the specified channel
advancedrtp.cooldown.bypass - Allows the player to bypass the teleportation delay
advancedrtp.allchannels - Allows the player to teleport through all channels

%advancedrtp_cooldown_<arg>% - get the remaining delay time for teleportation
in the specified channel. Instead of <arg> write the channel argument
that you specified in the "argument" parameter in config.yml