RtpZoneX

Advanced zone-based random teleportation for Minecraft

Create custom RTP zones where players teleport together to safe random locations. Features zone wand tool, GUI configuration, particle effects, holograms, cooldowns, and multi-world support. Perfect for survival spawns, PvP arenas, and minigames.

Features

Core Functionality

• Zone-Based RTP - Create custom teleportation zones with defined boundaries
• Group Teleportation - Players entering zones are teleported together as a group
• Safe Location Finder - Automatically avoids lava, water, void, and unsafe blocks
• Multi-World Support - Create independent zones in different worlds

Visual Effects

• Particle Boundaries - Customizable particle effects show zone borders
• Floating Holograms - Display zone information above entry points
• Custom Sounds - Configurable sound effects for teleportation events

Management Tools

• Zone Wand - Intuitive tool for selecting zone boundaries (left/right click)
• Interactive GUI - Easy-to-use configuration interface for all zone settings
• Real-Time Updates - Changes apply immediately without server restart

Player Features

• Cooldown System - Per-zone cooldowns prevent spam
• Permission Support - Fine-grained control over who can use zones
• PlaceholderAPI Integration - Display zone stats and cooldowns anywhere

Performance

• Folia Compatible - Full support for multi-threaded Paper fork
• Optimized - Efficient particle and hologram rendering
• Async Safe Location Finding - Non-blocking teleport location search

Use Cases

Survival Servers

Create spawn zones that teleport new players to random wilderness locations for a true survival experience.

Lifesteal/PvP Servers

Set up combat zones with randomized spawn points to prevent spawn camping and camping strategies.

Adventure Maps

Distribute players randomly across large maps for exploration-based gameplay.

Minigames

Create lobby zones that group players and teleport them together to game arenas.

Commands

Main Commands

• /rtpzone - Open zone list GUI (alias: /rtz, /rtpz)
• /rtpzone wand - Get the zone creation wand
• /rtpzone create <name> - Create a new RTP zone
• /rtpzone delete <name> - Delete an existing zone
• /rtpzone list - Open zone list GUI
• /rtpzone config <name> - Open configuration GUI for a zone (alias: edit)
• /rtpzone info <name> - Display detailed zone information
• /rtpzone reload - Reload plugin configuration
• /rtpzone help - Show command help

Permissions

• rtpzonex.use - Allows using RTP zones (default: true)
• rtpzonex.zone.manage - Allows managing RTP zones (default: op)
• rtpzonex.admin - Full admin access (default: op)
• rtpzonex.reload - Allows reloading the plugin (default: op)

Quick Start Guide

1. Install the plugin

   • Download RtpZoneX and place it in your plugins folder
   • Restart your server

2. Create your first zone

   /rtpzone wand
   

   • Left-click a block to set position 1
   • Right-click a block to set position 2
   • Run /rtpzone create spawn-rtp

3. Configure the zone

   /rtpzone config spawn-rtp
   

   • Adjust settings in the GUI
   • Enable particles, holograms, sounds
   • Set cooldowns and permissions

4. Test it out

   • Walk into your zone
   • You'll be teleported to a safe random location!

Configuration

All zone settings are configurable through the in-game GUI:

• Teleport Settings - Delay, radius, height limits
• Safety Checks - Block blacklist, water/lava avoidance
• Visual Effects - Particle type, color, density
• Holograms - Text, position, update interval
• Sounds - Entry, teleport, and exit sounds
• Cooldowns - Per-zone cooldown timers
• Permissions - Zone-specific access control

PlaceholderAPI Support

When PlaceholderAPI is installed, the following placeholders are available:

• %rtpzonex_cooldown% - Player's remaining cooldown time
• %rtpzonex_zones% - Total number of zones on the server
• %rtpzonex_in_zone% - Whether player is in a zone (true/false)
• %rtpzonex_zone_name% - Name of the zone player is currently in
• %rtpzonex_total_teleports% - Total teleports by the player
• %rtpzonex_is_teleporting% - Whether player is currently teleporting (true/false)
• %rtpzonex_teleport_zone% - Name of zone player is teleporting to
• %rtpzonex_max_distance% - Max teleport distance from config
• %rtpzonex_min_distance% - Min teleport distance from config
• %rtpzonex_countdown% - Teleport countdown time from config

Support & Links

• Issues & Bug Reports: GitHub Issues
• Source Code: GitHub Repository
• License: GNU General Public License v3.0.