ElytraRace

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit paper purpur spigot

标签： game-mechanics minigame utility

? 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.