NzxterRTP

# 🌀 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: ```yaml # 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