RtpZoneX

# 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**: (https://github.com/mukulx/RtpZoneX/issues) - **Source Code**: (https://github.com/mukulx/RtpZoneX) - **License**: GNU General Public License v3.0.