🧭 RTP+ — Enterprise Random Teleport & Claim Safety System

RTP+ is the ultimate next-generation, GUI-driven random teleport plugin built for Spigot, Paper, Purpur, and Folia. Engineered with a zero-latency async pre-cache engine, universal land claim protection, integrated RTP portal blocks, and military-grade hazard safety.

Whether you operate a Survival SMP, Skyblock, Factions, or massive Network with Folia region threading, RTP+ guarantees lightning-fast 0ms teleports with absolute zero main-thread TPS impact.

🌐 Universal Compatibility & Architecture (v1.8.0+)

Rtp+ v1.8.0 features a completely decoupled platform abstraction engine (SchedulerUtil), delivering 100% native compatibility across the entire Minecraft server ecosystem:

*Tested and verified across *Minecraft 1.16.5, 1.17.x, 1.18.x, 1.19.x, 1.20.x, and 1.21.x (including 1.21.4+).

🌟 Official Server Showcase

Experience RTP+ live in production alongside custom systems:

⚡ Why Choose RTP+ Over Alternatives?

✨ Flagship Capabilities

⚡ 1. Instant 0ms RTP (Location Pre-Cache Pool)

• Zero Search Lag: Background asynchronous tasks pre-calculate and validate safe landing spots before players ever run /rtp.
• Zero Chunk Load Stutter: Teleportation happens instantly without freezing the main server thread or dropping TPS.
• Smart Elastic Queue: Automatically replenishes cached coordinates per world as players use them.

🚪 2. Built-in RTP Portal & Pressure Plate Engine

• Eliminate Extra Plugins: No need for AncientGates or complex portal plugins just for RTP.
• Spawn Integration: Designate pressure plates or blocks (END_PORTAL_FRAME, LODESTONE, HEAVY_WEIGHTED_PRESSURE_PLATE, etc.) at your spawn or hub.
• Seamless Stepping: Stepping onto or walking over designated blocks automatically triggers RTP with intelligent anti-spam debounce.

🛡️ 3. Universal Land Claim & Anti-Grief Defense

Never worry about players spawning inside another player's base or griefing a protected area. Soft-hooks automatically into:

• 🏰 WorldGuard 7.x (Respects non-global regions, deny-spawn flags, and custom claims)
• 📜 GriefPrevention (Avoids player claim territories and subdivisions)
• 🏘️ Towny (Respects active town plots, outposts, and borders)
• 🗺️ Lands (Avoids registered land plots and wilderness flags)
• 🛡️ HuskTowns (Safely avoids town territories) (Zero performance overhead if these claim plugins are not installed!)

🌋 4. Military-Grade Hazard & Ledge Shield

• Cardinal Neighbor Check: Scans all adjacent horizontal blocks (North, South, East, West) around the player's feet to prevent spawning next to flowing lava or 1-block cliffs.
• Nether Roof Bedrock Shield: Scans below the upper bedrock ceiling (Y < 125) to prevent players from ever getting stuck on the Nether roof.
• End Void Prevention: Enforces solid End Stone landings with Y ≥ 40.
• Deep Hazard Detection: Avoids waterlogged blocks, lava cauldrons, powder snow, cactus, wither roses, sweet berry bushes, sculk shriekers, and trial spawners.

↩️ 5. Pre-Teleport Origin Memory (/rtp back)

• Players who get trapped, change their mind, or need to return to spawn can type /rtp back within a configurable time window.
• Supports optional Vault economy charging and combat restrictions.

🧪 6. Arrival Effects & Invincibility Grace

• Chunk Loading Immunity: Configurable invincibility (default 5s) protecting players while their client loads terrain.
• Arrival Potion Buffs: Smooth landing buffs including Slow Falling, Resistance, and Night Vision.

🧾 Commands & Aliases

🔐 Permissions Reference

⚙️ Configuration Preview

# ==========================================
#           RtpPlus Configuration
# ==========================================

# GUI Configuration for /rtp and /wild commands
gui:
  title: "<gradient:#ffaa00:#ff5500>Random Teleport</gradient>"
  size: 27
  sound: "BLOCK_CHEST_OPEN"
  auto-teleport-if-single-world: false
  filler:
    material: "GRAY_STAINED_GLASS_PANE"
    name: " "
    lore: []

  worlds:
    world:
      enabled: true
      display-name: "<gradient:#55ff55:#55ffaf>Overworld RTP</gradient>"
      material: "GRASS_BLOCK"
      slot: 11
      lore:
        - "<gray>Click to teleport randomly in the Overworld.</gray>"
        - ""
        - "<yellow>• Min Radius:</yellow> <white>1,000 blocks</white>"
        - "<yellow>• Max Radius:</yellow> <white>5,000 blocks</white>"
        - "<yellow>• Cooldown:</yellow> <gold>%cooldown%s</gold>"
        - "<yellow>• Cost:</yellow> <gold>%cost%</gold>"
        - "<yellow>• Uses Today:</yellow> <gold>%uses_today%/%daily_limit%</gold>"
        - ""
        - "<green>Click to teleport!</green>"
      permission: "rtp.world.overworld"
      cost: 50
      cooldown-override: -1
      min-radius: 1000
      max-radius: 5000
      center-x: 0
      center-z: 0
      biome-mode: BLACKLIST
      biomes:
        - OCEAN
        - DEEP_OCEAN
        - COLD_OCEAN
        - FROZEN_OCEAN
        - WARM_OCEAN
        - MUSHROOM_FIELDS

# RTP Portal Trigger Blocks & Pressure Plates
portal-blocks:
  enabled: false
  target-world: ""
  materials:
    - "HEAVY_WEIGHTED_PRESSURE_PLATE"
    - "LIGHT_WEIGHTED_PRESSURE_PLATE"
    - "POLISHED_BLACKSTONE_PRESSURE_PLATE"
    - "STONE_PRESSURE_PLATE"
    - "OAK_PRESSURE_PLATE"
    - "END_PORTAL_FRAME"
    - "LODESTONE"

# Return to Pre-Teleport Origin (/rtp back)
rtp-back:
  enabled: true
  timeout-seconds: 120
  cost: 0

📊 Placeholders (PlaceholderAPI)