Enes RtpZone | Plugin v1.0

# EnesRTPZone - Advanced Random Teleportation Zone System
Version: 1.0
Developer: Enes9899
Modrinth: https://modrinth.com/plugin/enesrtpzone
Supported Platforms: Paper 1.21+, Folia, Purpur
---
## Product Overview
EnesRTPZone is a powerful, lightweight, and highly configurable Minecraft server plugin that enables server administrators to create dynamic random teleportation zones. This innovative plugin transforms any designated region into an interactive teleportation hub where players are automatically transported to safe random locations after a synchronized countdown period.
Designed specifically for Minecraft server owners who want to enhance their gameplay experience, EnesRTPZone combines intuitive region selection tools with robust safety algorithms to ensure seamless player teleportation without server lag or unsafe spawn locations.
### What This Plugin Offers:

• Dynamic Zone Creation: Define custom RTP zones using an intuitive wand-based selection system
• Automated Teleportation Workflow: Players enter zones and get teleported automatically after countdown
• Intelligent Safety Systems: Advanced algorithms prevent teleportation into hazardous areas
• Synchronized Multi-Player Experience: All players in a zone share the same countdown timer
• Zero Performance Impact: Fully asynchronous operations maintain server TPS
• Cross-Platform Compatibility: Works flawlessly on Paper, Folia, and Purpur server software

---
## Perfect For These Server Types

• Survival Servers: Create RTP spawn zones for new players or resource gathering
• PvP Arenas: Random teleportation for battle royale style gameplay
• Minigame Hubs: Teleport players to random minigame starting positions
• Skyblock Servers: Random island generation and teleportation systems
• Faction Servers: Random teleport zones for raiding or exploration
• ** RPG/Adventure Servers:** Mystery teleportation portals and adventure zones
• Lobby/HUB Servers: Random teleportation to different server sections

---
## Key Features and Capabilities
### Intelligent Random Teleportation System
The core feature of EnesRTPZone is its sophisticated teleportation engine. When players enter a designated RTP zone, the plugin initiates a configurable countdown timer. Upon completion, players are instantly transported to carefully calculated safe locations within customizable radius parameters (minimum and maximum distances).
### Advanced Safety Detection Algorithm
Safety is paramount. The plugin includes a comprehensive hazard detection system that automatically:

• Avoids lava pools, water bodies, and cactus blocks
• Prevents teleportation into void areas or ungenerated chunks
• Detects suffocation hazards and unsafe heights
• Validates solid ground beneath teleport destinations
• Checks for nearby hostile entities in survival mode

### Global Synchronized Countdown Timer
Unlike basic teleportation plugins, EnesRTPZone features a shared countdown system where:

• All players within the same zone see identical countdown timers
• Countdown displays through immersive title screen messages
• Customizable countdown duration (default: 30 seconds)
• Visual and audio feedback throughout the countdown phase
• Automatic countdown cancellation if players exit the zone

### Performance Optimized Architecture
Built with modern Minecraft server performance in mind:

• 100% Asynchronous Operations: All teleportation calculations run on separate threads
• Zero Main Thread Blocking: Server TPS remains stable during heavy usage
• Efficient Region Detection: Optimized player movement tracking
• Smart Memory Management: Minimal garbage collection impact
• Folia Support: Native asynchronous region support for maximum performance

### Intuitive Wand-Based Region Selection
Creating RTP zones is effortless with the built-in selection system:

• Left-click: Sets the first corner position (Position 1)
• Right-click: Sets the opposite corner position (Position 2)
• Visual Feedback: Particle effects show selected boundaries
• Real-time Validation: Immediate confirmation of successful selections
• Persistent Storage: Zones automatically save to configuration files

### Fully Customizable Configuration
Every aspect of the plugin can be tailored to your server's needs:

• Custom Messages: Full control over all player-facing text with color code support
• Countdown Settings: Adjustable timer duration to match your gameplay pace
• Radius Parameters: Define minimum and maximum teleportation distances
• Target World Selection: Specify which world players teleport to
• Prefix Branding: Custom chat prefix for all plugin messages

---
## Complete Feature List
| Feature | Description |
|---------|-------------|
| Multi-Platform Support | Native compatibility with Paper 1.21+, Folia, and Purpur |
| Easy Zone Setup | Simple wand-based region selection with particle visualization |
| Global Countdown System | Synchronized timer visible to all players in the zone |
| Title Message Display | Full-screen countdown with customizable titles and subtitles |
| Safe Teleportation Engine | Intelligent hazard avoidance for lava, water, cactus, and dangerous terrain |
| Asynchronous Processing | Zero server lag with optimized async operations |
| Persistent Zone Storage | Automatic saving and loading of zone configurations |
| Fully Configurable | Complete customization of messages, timers, and teleportation settings |
| Real-time Zone Detection | Instant player entry and exit tracking |
| Countdown Cancellation | Automatic timer stop when players leave the zone |
| Cross-World Support | Teleport players to different worlds with ease |
| Admin Management Tools | Complete zone creation, deletion, and management commands |
---
## Available Commands
| Command | Description | Required Permission |
|---------|-------------|---------------------|
| /rtpzone | Display the complete help menu with all available commands | rtpzone.admin |
| /rtpzone wand | Receive the magical selection wand for region creation | rtpzone.admin |
| /rtpzone create <name> | Save the currently selected region as a named RTP zone | rtpzone.admin |
| /rtpzone delete <name> | Permanently remove a specific RTP zone from the server | rtpzone.admin |
| /rtpzone reset | Clear your current position selections and start fresh | rtpzone.admin |
| /rtpzone reload | Reload all configuration files and zone data without server restart | rtpzone.admin |
---
## Permission System
- rtpzone.admin - Grants access to all administrative commands including zone creation, deletion, configuration reloading, and the selection wand
---
## Configuration File (config.yml)
---
## Step-by-Step Usage Guide
### Creating Your First RTP Zone
1. Obtain the Selection Wand
- Execute /rtpzone wand in chat
- The wand will appear in your inventory with special properties
2. Define Your Region Boundaries
- Left-click any block to set the first corner (Position 1)
- Right-click another block to set the opposite corner (Position 2)
- Particle effects will visualize your selected region
3. Save Your Zone
- Type /rtpzone create <your_zone_name> (e.g., /rtpzone create spawnrtp)
- The zone is now active and saved permanently
4. Test the Zone
- Walk into the defined region
- Observe the countdown title message
- Get automatically teleported when the timer reaches zero
### Managing Existing Zones

• Delete a Zone: /rtpzone delete <zone_name> - Removes the zone permanently
• Clear Selection: /rtpzone reset - Removes your current position selections
• Reload Config: /rtpzone reload - Applies configuration changes without restart

---
## How The Teleportation System Works
### Phase 1: Zone Entry Detection
When a player enters a defined RTP zone, the plugin immediately detects their presence and initiates the teleportation sequence.
### Phase 2: Global Countdown Initialization
A synchronized countdown begins, visible to all players within the zone through immersive title screen messages. The countdown duration is configurable (default: 30 seconds).
### Phase 3: Safe Location Calculation
During the countdown period, the plugin asynchronously calculates optimal teleportation destinations:

• Random coordinates within configured radius parameters
• Safety validation to avoid hazardous terrain
• Solid ground verification for safe landing

### Phase 4: Teleportation Execution
When the countdown reaches zero:

• Players are instantly teleported to their calculated safe location
• A confirmation message appears in chat
• The teleportation process completes without server lag

### Phase 5: Exit Handling
If players leave the zone before countdown completion:

• The countdown automatically cancels for that player
• No teleportation occurs
• A cancellation message is displayed

---
## Installation Instructions
### Step 1: Download the Correct Version
Choose the appropriate JAR file for your server software:

• EnesRtpZone-paper.jar - For Paper servers (1.21+)
• EnesRtpZone-folia.jar - For Folia servers (async regions)
• EnesRtpZone-purpur.jar - For Purpur servers

### Step 2: Install the Plugin
1. Stop your Minecraft server (recommended for clean installation)
2. Copy the downloaded JAR file to your server's plugins folder
3. Start or restart your server
4. Verify plugin loads correctly in console logs
### Step 3: Configure Your Settings
1. Navigate to plugins/EnesRtpZone/config.yml
2. Customize countdown duration, radius settings, and messages
3. Execute /rtpzone reload to apply changes
### Step 4: Create Your First Zone
1. Use /rtpzone wand to get the selection tool
2. Define your region boundaries with left/right clicks
3. Save with /rtpzone create <name>
4. Your RTP zone is now active!
---
## Developer Information

• Developer: Enes9899
• Version: 1.0