SmarterRandomTP: Safe Random Teleport Plugin for Minecraft

What Is SmarterRandomTP and Why Your Server Needs It

Random teleportation is a staple feature on many Minecraft servers. It lets players explore fresh terrain, escape spawn crowding, or simply add an element of surprise. But vanilla random teleport commands often come with a frustrating downside: you might end up in lava, plummeting off a cliff, or drowning deep underwater. That is where SmarterRandomTP steps in. This plugin for CraftBukkit and Spigot servers redefines random teleports by intelligently scanning destinations before dropping a player there. No more instant death upon arrival—just safe, sensible landings that keep the adventure fun.

How SmarterRandomTP Works

At its core, SmarterRandomTP uses a sophisticated safety check before finalizing a teleport location. When a player runs the /rtp command, the plugin picks a random coordinate within the configured radius. Then it verifies that the landing spot meets several criteria: a 3x3x3 cube of air or water must surround the player, the block beneath cannot be lava, fire, magma, cactus, or a portal, and there must be solid ground within five blocks below. If the destination fails any test, the plugin tries again until it finds a valid spot. This process happens in milliseconds, so players experience a seamless teleport without ever seeing the rejected hazards.

Key Features That Set It Apart

• Intelligent Hazard Avoidance: Automatically skips lava lakes, fire, and deadly drops. You will never materialize inside a block or over a 50-block chasm.
• Water Safety Toggle: Server owners can decide whether water counts as a safe destination. If your players suffer from lag when teleporting into oceans, simply set waterIsConsideredSafe to false.
• Dual Cooldown System: A standard cooldown applies to all players, while a separate VIP cooldown can be assigned to donors or trusted ranks. This creates a natural perk without needing extra plugins.
• Fully Configurable Radii: Adjust the X and Z radius independently, set a Y range for height limits, and define the origin point—usually your server spawn—so teleports always stay within your world’s intended play area.
• In-Game Administration: Every parameter can be tweaked on the fly using commands like /rtpSetRadiusX or /rtpSetCooldown. Changes are instantly written to the config file, though comments in that file will be lost due to Bukkit’s handling.

Installation and Setup

Getting SmarterRandomTP running is straightforward. Download the JAR file from the plugin’s official repository on the SpigotMC site and place it into your server’s plugins folder. If you are using an Ubuntu or Debian terminal, you can fetch it directly with wget and the file URL. For those who prefer a more visual approach, the foxygame.net launcher offers a convenient, flexible, and modern Minecraft launcher where you can download mods and plugins right from the menu, streamlining the entire process without digging through multiple web pages. After a server restart or reload, the plugin generates a default config.yml inside the plugins/SmarterRandomTP data folder. This file is heavily commented to explain every option, from cooldown lengths to teleport boundaries. A separate savedata.yml file stores player cooldown timestamps—delete it if you ever need to reset everyone’s cooldown at once.

Commands and Permissions

SmarterRandomTP ships with a comprehensive set of commands, all OP-only by default except for the basic /rtp. Here is a quick reference:

• /rtp – Triggers a random teleport. Permission: smarterrandomtp.rtp
• /rtpReload – Reloads the configuration from disk. Permission: smarterrandomtp.reload
• /rtpSetRadiusX <positive-integer> – Sets the X-axis radius. Permission: smarterrandomtp.setRadiusX
• /rtpSetRadiusZ <positive-integer> – Sets the Z-axis radius. Permission: smarterrandomtp.setRadiusZ
• /rtpSetRangeY <lower> <upper> – Defines the Y-level range. Permission: smarterrandomtp.setRangeY
• /rtpSafeTeleport <boolean> – Toggles the hazard safety check. Permission: smarterrandomtp.setSafeTeleport
• /rtpSetOriginX <integer> / /rtpSetOriginZ <integer> – Moves the teleport origin point. Permission: smarterrandomtp.setOriginX / smarterrandomtp.setOriginZ
• /rtpSetCooldown <milliseconds> – Sets the standard cooldown. Permission: smarterrandomtp.setCooldown
• /rtpSetCooldownVIP <milliseconds> – Sets the VIP cooldown. Permission: smarterrandomtp.setCooldownVIP
• /rtpOnPlayer <player-name> – Forces a random teleport on another player. Permission: smarterrandomtp.rtpOnPlayer
• /rtpSetWaterSafe <boolean> – Toggles water as a valid destination. Permission: smarterrandomtp.setWaterSafe
• /rtpReportConfig – Displays the current configuration. Permission: smarterrandomtp.reportConfig

Tab completion works for player names in /rtpOnPlayer, making administration even smoother. To grant a player or group the VIP cooldown, simply assign the permission smarterrandomtp.useVIPCooldown. By default, only operators have this node.

Fine-Tuning the Configuration

The config.yml file is the heart of the plugin. Here is a breakdown of the most important sections:

• safeTeleport: Set to true to enable the 99% hazard-free logic. When false, teleports become purely random without safety checks.
• waterIsConsideredSafe: If true, players can land in water bodies. If false, all water destinations are rejected, which is useful for servers where ocean teleports cause client lag and drowning.
• radiusX / radiusZ: The maximum horizontal distance from the origin point. Default is 3000 blocks in each direction.
• rangeYLower / rangeYUpper: Absolute Y coordinates that define the vertical band for teleports. Default is 50 to 110, keeping players above deep caves and below mountain peaks.
• originX / originZ: The center of the teleport area. Set this to your spawn coordinates so players always teleport relative to the hub.
• cooldown / cooldownVIP: Cooldown values in milliseconds. Default standard cooldown is 60000ms (1 minute), VIP is 5000ms (5 seconds). A value of 0 disables the cooldown entirely.

Remember that using in-game commands to change settings will overwrite the config file immediately, stripping out all the helpful comments. If you prefer to keep documentation intact, edit the YAML file directly while the server is stopped.

Why SmarterRandomTP Is a Must-Have

Random teleportation should be exciting, not lethal. SmarterRandomTP eliminates the frustration of bad landings while giving server owners granular control over boundaries, cooldowns, and safety rules. The dual cooldown system encourages community perks without complex permission setups, and the in-game command suite lets you adjust everything on the fly. Whether you run a survival world, a minigame hub, or a massive anarchy server, this plugin ensures that every /rtp leads to a fresh start—not a sudden death screen. Its compatibility spans from Minecraft 1.8 all the way to 1.12.X, and the active repository on SpigotMC guarantees you are getting a mature, well-maintained tool. Add SmarterRandomTP to your server today and give your players the freedom to explore without fear.