Minecraft plugin WildRTP

🔌 About WildRTP

WildRTP is a Minecraft plugin for random teleportation (RTP). It finds safe, random locations for players using configurable generation strategies, supports per-world customization, includes cooldowns and movetimers, and can integrate with protection plugins to avoid claimed or protected areas.

🎯 Purpose

WildRTP is designed to give server administrators a reliable, configurable RTP command so players can be safely teleported to random locations without landing in hazardous blocks, protected regions, or undesirable biomes. It targets survival and adventure servers that need controlled random spawning and admin-managed RTP behavior.

⚙️ Features

• Configurable global and per-world min/max radii and shape (CIRCLE or SQUARE).
• Multiple generation strategies (AUTO, HIGHEST_BLOCK, BOTTOM_UP, TOP_DOWN) for different world types.
• Cooldown support and per-world cooldown option.
• Movetimer (prevent movement before teleport completes) with configurable duration and cancel sound.
• Safe-location checks (blocks and biome avoidance, max attempts setting).
• Auto-RTP triggers (on first join, on join, on death) configurable.
• Hooks/integrations for protection plugins to skip protected locations.
• Optional metrics collection (bStats) and update checking.

🧩 Who It Is For

• Survival and SMP servers that want safe random spawns.
• Adventure servers that need controlled player distribution.
• Admins who require per-world RTP configuration and protection integration.

🏗️ Example Use Cases

• Let new players use /wild to find an unexplored area without risking suffocation or teleporting into lava.
• Configure smaller RTP ranges and cooldowns for spawn-adjacent worlds and larger ranges for wilderness worlds.
• Enable WorldGuard/Towny/residence hooks so RTP never places players inside protected regions.

⌨️ Commands

🔐 Permissions

⚙️ Installation

📥 Setup

• Download the official WildRTP .jar and place it into your server's plugins/ directory.
• Restart the server and check the console to confirm the plugin loaded.

📦 Dependencies

Confirmed integration hooks (optional):

• WorldGuard
• ProtectionStones
• Towny
• Residence
• GriefDefender

These appear as optional hooks to skip protected or claimed areas when selecting RTP locations.

🧾 Configuration

• WildRTP uses a YAML configuration file (config versioned inside the plugin folder) with global and per-world sections.
• Configurable values include min/max radius, shape, center coordinates, cooldown, movetimer, messages/titles, sound, blocks/biomes to avoid, generation strategy, auto-rtp triggers, blacklist/whitelist, max-tries, hooks, metrics, and update checks.
• The plugin provides localization support (example languages include en, de, ru) via a lang setting and language files located in the plugin folder.

🧠 Technical Notes

• Supported server software includes Bukkit, Spigot, Paper, Purpur, and Folia (as listed by the project).
• The project lists compatibility with multiple Minecraft versions (examples provided by the project include 1.13 through 1.21.x and related entries).
• Metrics (bStats) and update checking are configurable in the plugin config.
• The plugin provides placeholder support and a GUI addon is available separately.

🤝 When This Plugin Is Useful

Use WildRTP when you need a configurable, safe random-teleport command with per-world control and protection-plugin integration so players are relocated without entering dangerous or claimed areas.