Logo
RtpZoneX
PluginGPL-3.0-only

RtpZoneX

Advanced zone-based random teleportation for Minecraft

27
Downloads
3
Followers
2 months ago
Updated
📦
1
Versions
game-mechanicsmanagementutilityfoliapaperpurpur
Download Latestv1.0.0View on Modrinth

📖About 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

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.