🌀 NzxterRTP

A highly optimized, multi-world Random Teleportation plugin designed for modern Bukkit and Spigot servers. Featuring a safe asynchronous coordinate scanner, world-based restrictions, immersive title animations, and smooth dynamic gradients, this plugin provides the ultimate wilderness teleportation experience without sacrificing server performance!

---

🚀 Key Features

• ⚡ Asynchronous Scanning: Looking for safe locations shouldn't lag your server! The plugin generates coordinates and checks chunk layouts on an asynchronous worker thread, keeping your main server tick rate (TPS) perfectly stable.
• 🌍 Full Multi-World Support: Fully control where players can random teleport. Configure an explicit whitelist of allowed worlds directly in the config.yml to prevent players from teleporting into forbidden zones.
• 🌌 Dimension-Aware Y-Logic: Teleportation adapts intelligently to the world's environment. It automatically adjusts search limits for the Nether (preventing players from stuck-spawning on the bedrock ceiling) and the End, while utilizing highest-block calculations for normal overworlds.
• 🛡️ Smart Safety Verification: Built-in multi-block checks ensure players never land inside lava, water, fire, cacti, spiderwebs, or solid walls. It guarantees a safe 2-block air clearance at their destination.
• 🌈 Dynamic Color Gradients: Seamlessly integrated with a robust color parsing system. Use premium multi-color gradient templates (<gold>, <purple>, <cyan>, etc.) across all chat messages, action prefixes, and interactive titles.
• 🎬 Immersive Title & Audio Effects: Keeps players engaged by broadcasting stylized countdowns or searching animations via full-screen titles and customizable action sounds.

---

🛠️ Commands & Permissions

Command	Description
/rtp	Teleports the player to a random safe location within their current world.
/rtp <world>	Teleports the player to a random safe location within a specific target world.
/rtp reload	Instantly reloads the plugin configuration files.

🔑 Permissions

• randomtp.admin — Allows administrative reloads of the configuration file.
• Note: World availability for standard players is restricted via the allowed-worlds list in the configuration rather than separate permissions, making it simple to manage.

---

📦 Configuration Overview

The generated config.yml provides granular control over the teleport boundaries and localized messaging:

# Set the coordinate limits for the random teleport generation
settings:
  min-coord: -5000
  max-coord: 5000
  only-loaded-chunks-teleport: false
  sound: "ENTITY_ENDERMAN_TELEPORT"

# Whitelist of worlds where /rtp is permitted
allowed-worlds:
  - world
  - world_nether

messages:
  searching: "<gray>Searching for a safe location..."
  teleporting: "<green>Teleported to X: %locationX% Y: %locationY% Z: %locationZ%!"
  use-title-for-teleporting-message: true