xRtp

xRtp is a powerful, optimized, and fully configurable Random Teleport plugin designed for modern Minecraft servers. Built for zero-lag performance, instant teleports, and complete visual customization.

---

✨ Main Features

⚡ Zero-Lag Instant Teleportation

xRtp uses a background location cache engine (LocationCacheManager) that pre-calculates safe destinations before players even ask for one. When a player runs /rtp, they are teleported instantly — no lag, no CPU spikes, no main-thread blocking.

• Fully async block and chunk checking
• Locations saved to cache.yml and reloaded on startup for zero-wait first teleport
• Configurable cache size and background refill interval

🌍 Smart World Border Handling

If min-radius exceeds the world border, xRtp auto-clamps the range and keeps working instead of crashing. Configuration warnings appear only once in the console — no spam.

🎛 Fully Customizable GUI Menu

Design your RTP menu exactly how you want it via menu.yml:

• Custom slot layout with auto-filler glass panes
• Close button and any custom action items
• Multi-world destinations with individual min/max radii
• Supports any material and custom display names with color codes

⏳ Configurable Cooldown System

Set custom cooldown times per world and allow specific players to bypass them with a permission node.

🛡 Safe Location Engine

• Skips liquid, unsafe, and blacklisted blocks
• Nether support with gap detection
• Only teleports to pre-generated chunks by default (prevents terrain generation lag)

🌐 Multi-Language Support

Ships with complete English (Default) and Spanish (Config ES) configuration packs. Every message, title, action bar, and GUI item is fully customizable.

---

📦 Commands & Permissions

Command	Description	Permission
/rtp	Opens the RTP world selection menu	xrtp.use
/rtp reload	Reloads all config files	xrtp.admin

---

⚙️ Configuration Overview

# config.yml
location-cache:
  enabled: true
  cache-size: 20               # Pre-cached locations per destination
  refill-interval-seconds: 5  # How often to refill in background

use-pre-generated-chunks: true # Prevents chunk generation lag
teleport-delay-seconds: 5
max-attempts: 100

# menu.yml — Full GUI control
menu:
  title: "&8&lRandom Teleport"
  size: 27
  auto-filler:
    enabled: true
    material: GRAY_STAINED_GLASS_PANE

destinations:
  survival:
    world: world
    min-radius: 100
    max-radius: 5000
    slot: 13
    material: GRASS_BLOCK
    name: "&a&lSurvival World"

---

🔧 Compatibility

• Minecraft: 1.18 – 1.21.x
• Platform: Spigot, Paper, Purpur, Leaf
• Java: 17+