🪂 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’s New in v1.1.0? (10 Major Features)

• 🔒 Force-Join System — Automatically join players when they enter the lobby
• 🎒 Inventory Validation — Require Elytra + rockets before players can ready
• 📦 WorldGuard Region Import — Auto-import race rings directly from regions
• 🛫 Starting Platform System — Freeze players until countdown reaches zero
• 🧪 Test Mode — Run races without saving statistics
• 🕒 Personal Best Tracking — Store best times + show PB badges
• 👁‍🗨 Auto Spectator Mode — Send players to spectator after finishing
• ✨ Ring Preview System — Particle-based ring preview for setup
• 🚧 Boundary Anti-Cheat — Warn & return players when leaving race zone
• ⏳ Auto-Finish Timer — End races automatically after a timeout

All settings are fully configurable in config.yml.

---

🔥 Core Features

🏁 Automatic Race System

• Walk-into-lobby auto join
• Ready-up system
• Countdown with movement freeze
• Simultaneous start for all racers
• Automatic stats update

🎯 Ring System & Validation

• Detect rings in order
• Prevent skipping
• Wrong-direction detection
• WorldGuard region-based ring importing
• Particle preview system

⏱️ Real-Time Timers

• Global race timer
• Per-player timers
• Actionbar display
• Personal Best (PB) & World Record (WR) indicators

📊 Statistics Tracking

• Races played
• Wins
• Average time
• Best time
• Win rate
• Personal best history

🏆 Leaderboards

• Top 10 fastest players
• Sort by time, wins, or averages

🚀 Rocket Management

• Rocket limit per race
• Usage tracking
• Anti-spam checks
• Inventory validation before ready

⚙️ Fully Customizable

• All messages editable
• Toggle every feature individually
• Performance tuning settings
• Anti-cheat thresholds
• Auto-finish timers
• Spectator mode options

---

📋 Requirements

• Server: Paper 1.21.4+ (or compatible forks)
• Java: 21+
• Optional (Recommended):
  • WorldEdit 7.3.3+
  • WorldGuard 7.2+

---

🚀 Quick Start

1. Install the plugin
2. Set race lobby:

   /er setup lobby 
   

3. Add rings or import from WorldGuard:

   /er setup addring ring1
   /er import rings
   

4. Create a starting platform:

   /er platform create
   

5. Start racing:

   /er join
   /ready
   

---

🛡️ Anti-Cheat Protection

• Ring skipping detection
• Off-path flying detection
• Rocket usage validation
• Boundary enforcement
• Mid-race disconnect handling
• Teleport exploit prevention

---

📖 Documentation

• 📚 Installation Guide
• ⚙️ Configuration Guide
• 📝 Commands Reference
• 🗺️ WorldEdit Setup Tutorial

(Links available on GitHub)

---

🤝 Support & Community

• 💬 GitHub Discussions
• 🐞 Issue Tracker
• 📧 Email: kartikfulara2003@gmail.com

---

📜 License

MIT License — Free for personal and commercial use.