SmarterRandomTP

* Migrated from: https://dev.bukkit.org/projects/tf-smarterrandomtp

What is it?
SmarterRandomTP is a plugin that provides a smarter way to do random teleports. With SRTP, you wont be dumped in lava, fire, off a cliff, or so far underwater that you drown, among other unfortunate destinations.

------------------------

Built for CraftBukkit/Spigot 1.12.X. It should be compatible with all 1.8+ versions.

------------------------

Setup

• Download the JAR to your plugins directory. Self explanatory for GUIs. For those using an Ubuntu/Debian terminal, use "wget jarurl" with the url to the jar file (go to the Files tab) in quotes. If you don't have access to the terminal the host is managing, you can try to use an FTP program to connect via SFTP and upload the jar file.

Configuration

• Only one USER-EDITABLE file in the data folder: config.yml
• All the variables in the config are explained via comments
• Valuetypes for config variables are indicated via comments
• This plugin will generate a savedata.yml file that stores cooldown values. Do not modify this file! If you wish to reset everyone's cooldown, simply delete the file.

Commands/How to Use

• /rtp
  • Performs a random teleport using the configuration parameters
  • Perm node: smarterrandomtp.rtp
• /rtpReload
  • Reloads the configuration in memory from the config.yml file
    
  • Perm node: smarterrandomtp.reload
• /rtpSetRadiusX <positive-integer>
  • Set the radius in the X direction for which a randomtp may be placed
  • Perm node: smarterrandomtp.setRadiusX
• /rtpSetRadiusZ <positive-integer>
  • Set the radius in the Z direction for which a randomtp may be placed
  • Perm node: smarterrandomtp.setRadiusZ
• /rtpSetRangeY <lower-bound-as-positive-integer> <upper-bound-as-positive-integer>
  • Set the range in the Y direction for which a randomtp may be placed
  • Perm node: smarterrandomtp.setRangeY
• /rtpSafeTeleport <boolean>
  • When enabled, teleports will be 99% free of hazards
  • Perm node: smarterrandomtp.setSafeTeleport
• /rtpSetOriginX <integer>
  • Set the X position of the randomtp origin
    
  • Perm node: smarterrandomtp.setOriginX
• /rtpSetOriginZ <integer>
  • Set the Z position of the randomtp origin
  • Perm node: smarterrandomtp.setOriginZ
• /rtpSetCooldown <milliseconds-as-a-positive-long>
  • Set the cooldown period (in milliseconds)
  • Perm node: smarterrandomtp.setCooldown
• /rtpSetCooldownVIP <milliseconds-as-a-positive-long>
  • Set the VIP cooldown period (in milliseconds)
  • Perm node: smarterrandomtp.setCooldownVIP
• /rtpOnPlayer <victim-player-name>
  • Cause the specified player to undergo a random teleport
  • Perm node: smarterrandomtp.rtpOnPlayer
• /rtpSetWaterSafe <boolean>
  • Sets whether or not SRTP can teleport a player into water
  • Perm node: smarterrandomtp.setWaterSafe
• /rtpReportConfig
  • Reports the current SRTP configuration
  • Perm node: smarterrandomtp.reportConfig

You can use tab to autocomplete player names for /rtpOnPlayer

With the exception of /rtp, the perm nodes for all commands are OP-only by default.

Cooldown Usage:
This plugin has two different cooldown periods to benefit servers with user perks. First, simply set cooldown and cooldownVIP in the config file to the values you desire.

The default cooldown period is applied to all players. To give a user or group access to the VIP cooldown period instead, give them the following permission: smarterrandomtp.useVIPCooldown

By default, only OPs have the smarterrandomtp.useVIPCooldown permission.