🪂 ElytraRace — The Ultimate Elytra Racing Plugin
A competitive and fully-customizable Elytra racing system for Minecraft Paper servers!
Designed for events, minigame servers, SMP challenges, and creators who want a polished, feature-rich racing experience.
✨ What Makes It Special?
- 🛡️ Intelligent Anti-Cheat: Multi-layer protection including rocket limits, boundary checks, and sequential order validation.
- ⚡ Performance Optimized: High-frequency calculations are cached and optimized to ensure zero impact on server TPS.
- 🌍 WorldGuard Integration: The industry standard for regions — import your existing WorldGuard zones as race rings instantly.
- 🛠️ Flexible Setup: Choose between precise manual placement or rapid automated region importing.
- 🏆 Comprehensive Stats: Real-time tracking of personal bests, win rates, and global leaderboards.
🚀 What’s New in v1.1.0? (10 Major Features)
- 🔒 Force-Join System — Automatically join players when they enter the lobby or force-join them via command.
- 🎒 Inventory Validation — Require Elytra + specific rocket counts before players can ready up.
- 📦 WorldGuard Region Import — Auto-import race rings directly from your existing regions.
- 🛫 Starting Platform System — Freeze players on a disappearing glass platform until the countdown hits zero.
- 🧪 Test Mode — Specialized admin mode to run races without saving statistics.
- 🕒 Personal Best Tracking — Store individual records and display PB/WR badges in the action bar.
- 👁🗨 Auto Spectator Mode — Automatically transition players to spectator mode after they cross the finish line.
- 🌈 Ring Preview System — Dynamic particle-based ring visualization for easy course setup.
- 🚧 Boundary Anti-Cheat — Smart enforcement that warns and returns players if they stray too far off-course.
- ⏳ Auto-Finish Timer — Configurable race timeouts to ensure games don't hang indefinitely.
🔥 Core Features
🏁 Automatic Race System
- Walk-into-lobby auto join
- Ready-up system with requirement validation
- Synchronized countdown with movement freeze
- Simultaneous start for all racers
- Automatic stats and leaderboard updates
🎯 Ring System & Validation
- Sequential checkpoint detection (prevents skipping)
- Wrong-direction detection
- WorldGuard region-based ring importing
- Particle preview system for visualization
⏱️ Real-Time Timers
- Global race timer and per-player timers
- High-precision action bar display
- Personal Best (PB) & World Record (WR) indicators
📊 Statistics & Leaderboards
- Detailed tracking: Wins, Races Played, Avg/Best Time, Win Rate
- Global Top 10 Leaderboards (Sort by Time, Wins, or Averages)
- Persistent storage for all player data
📋 Requirements
- Server: Paper 1.21.4+ (or compatible forks)
- Java: 21+
- Optional (Highly Recommended):
- WorldEdit 7.3.3+ (For region selection)
- WorldGuard 7.0.13+ (For region import)
🚀 Quick Start
- Install the plugin and restart your server.
- Set the Lobby:
/er setup lobby
- Define Course:
- Use WorldEdit to select areas:
/er setup start and /er setup finish
- Import rings:
/er import rings (imports regions named ring1, ring2, etc.)
- Finalize: Create a starting platform with
/er platform create
- Race!: Walk into the lobby or type
/er join, then /ready
🛡️ Anti-Cheat Protection
- ✅ Ring skip detection with instant disqualification
- ✅ Rocket usage limits (configurable)
- ✅ Off-path boundary enforcement
- ✅ Mid-race disconnect handling
- ✅ Teleport and flight exploit prevention
📖 Documentation & Support
Full documentation, including command references and configuration guides, is available on our GitHub Repository.
📜 License
Licensed under the MIT License — Free for personal and commercial use.
