ElytraRace

🪂 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

1. Install the plugin and restart your server.
2. Set the Lobby: /er setup lobby
3. 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.)
4. Finalize: Create a starting platform with /er platform create
5. 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.

• 💬 Discussions: GitHub Discussions
• 🐞 Issues: Report a Bug

---

📜 License

Licensed under the MIT License — Free for personal and commercial use.