⚡ SafeRTP - Asynchronous & Folia-Native Random Teleportation

SafeRTP is a modern, high-performance Random Teleport (RTP) plugin built specifically for Folia multithreaded servers and modern Paper (1.20+) environments.

---

✨ Key Features

• ⚡ Asynchronous Chunk Loading: Uses World#getChunkAtAsync to scan safe coordinates in parallel without blocking main or regional server threads.
• 🌳 Folia Native Support: Fully integrated with Folia's EntityScheduler and asynchronous region teleportation mechanics.
• 🕳️ 3D Biome & Underground Scanning: Native support for 3D biomes (Lush Caves, Dripstone Caves, Deep Dark, Nether biomes) with dynamic vertical Y-height search profiles.
• 🌐 World Environment Alignment: Automatically matches biomes to compatible dimension types (NORMAL, NETHER, THE_END).
• 🎨 MiniMessage & Ampersand Formatting: Full support for legacy color codes (&a, &c, &#rrggbb) and Adventure MiniMessage format tags (<gradient:...>).
• ⏱️ Warmups & Cooldowns: Customizable warmup delays and cooldowns. Warmup automatically cancels on movement or taking damage.
• 🚫 Restricted Biomes & Materials: Configure custom min/max search radius per world, blacklisted biomes, and unsafe blocks (lava, water, void, bedrock).
• 💾 Pre-Caching System: Background safe location caching persisted to cache.yml for zero-delay instant teleportation.
• 💰 Economy Support: Optional Vault integration for teleportation costs or item-based payments.

---

📜 Commands & Permissions

Commands

• /rtp — Randomly teleports executor in current world.
• /rtp <world> — Randomly teleports executor in target world.
• /rtp biome <biome> — Randomly teleports to a specific biome (auto-switches to target dimension if needed).
• /rtp biome <player> <biome> — Teleports another player to a specific biome (Admin).
• /rtp <player> [world] — Teleports target player to random location (Admin).
• /rtp reload — Reloads configuration and language files (safertp.admin).

Permissions

• safertp.use — Basic /rtp usage.
• safertp.biome — Biome-specific /rtp biome usage.
• safertp.admin — Admin commands (/rtp reload, target teleports).
• safertp.bypass.cooldown — Bypass cooldown timer.
• safertp.bypass.warmup — Bypass warmup delay.
• safertp.bypass.cost — Bypass economy/item costs.

---

⚙️ Optional Dependencies

• Vault (Optional): Required if monetary teleport costs are enabled in config.yml.