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

- Multi-World Support - Create custom teleportation zones with defined boundaries - Multi-World Support - Players entering zones are teleported together as a group - Multi-World Support - Automatically avoids lava, water, void, and unsafe blocks - Multi-World Support - Create independent zones in different worlds

Visual Effects

- Custom Sounds - Customizable particle effects show zone borders - Custom Sounds - Display zone information above entry points - Custom Sounds - Configurable sound effects for teleportation events

Management Tools

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

Player Features

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

Performance

- Async Safe Location Finding - Full support for multi-threaded Paper fork - Async Safe Location Finding - 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:

- Permissions - Delay, radius, height limits - Permissions - Block blacklist, water/lava avoidance - Permissions - Particle type, color, density - Permissions - Text, position, update interval - Permissions - Entry, teleport, and exit sounds - Permissions - 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

- License: License - License: %%MD1%% - License: GNU General Public License v3.0

Contributing

Contributions are welcome! Please read the contributing guidelines before submitting pull requests.

License

This plugin is licensed under the GNU General Public License v3.0. See the LICENSE file for details.