ElytraTrainer

ElytraTrainer is a Paper plugin designed to help players improve their Elytra flying skills through a structured training system with platforms, real-time HUD, detailed statistics, and timed snapshot sessions.

Created by Yasmin Carolina | Discord: diamonds1666

✈️ How It Works

Set up landing platforms anywhere in your world. As you fly with your Elytra toward a platform, the plugin automatically detects your approach, tracks your speed and accuracy, and records whether you landed clean, took damage, or missed entirely. A live HUD keeps you informed at all times while flying.

🖥️ Live HUD (Action Bar)

While gliding, you'll always see:

• Current speed — color-coded (green / yellow / red)
• Max speed — peak speed of your current flight session
• Altitude — your current Y position
• Target platform — which platform you're approaching and time remaining
• Active rockets — firework rocket boost timers
• Snapshot timer — countdown for your active training session

📋 Commands

/et — Platform Management

Aliases: /elytratrainer, /etrain

/snapshot — Timed Training Session

Aliases: /snap

📊 Statistics

For each platform, ElytraTrainer tracks:

• ✅ Clean hits — landed without taking any damage
• ⚠️ Damaged hits — landed but took fall/wall damage
• ❌ Misses — didn't reach the platform in time
• Hit rate and clean rate percentages
• Average and max approach speed (blocks/second)
• Average damage on damaged landings

All attempts are automatically saved to a CSV file (attempts.csv) inside the plugin folder for external analysis or tracking over time.

⏱️ Snapshot Sessions

Use /snapshot start [minutes] to begin a focused training session. The plugin will:

• Track only the attempts made during that session
• Show a live countdown timer in the HUD
• Display a full summary when the session ends (or you can end it manually)
• Save the session data to snapshots.csv

You can also pause and resume the timer freely with /snapshot pause.

⚙️ Configuration (config.yml)

# Interval in minutes for automatic periodic snapshots
snapshot-interval-minutes: 5

# Default timeout in seconds to detect a miss (didn't reach the platform)
default-timeout-seconds: 4

🚀 Rocket Boost Tracking

ElytraTrainer automatically detects when you use firework rockets while gliding and shows each active boost's remaining time in the HUD, so you always know exactly how much thrust you have left.

📁 Generated Files

✅ Requirements

• Server: Paper 1.21 or newer (1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4)
• Java: 21+
• ❌ Does not support Spigot or CraftBukkit

🇧🇷 Descrição em Português

ElytraTrainer é um plugin para Paper que ajuda jogadores a melhorar suas habilidades de voo com Elytra através de um sistema de treino com plataformas, HUD em tempo real, estatísticas detalhadas e sessões cronometradas.

Defina plataformas de pouso pelo mundo com /et set, voe em direção a elas e o plugin detecta automaticamente se você acertou limpo, acertou com dano ou errou. Todas as tentativas ficam salvas em CSV para acompanhar sua evolução ao longo do tempo.

Use /snapshot start para iniciar uma sessão cronometrada de treino e receba um resumo completo ao final com sua taxa de acerto, velocidade média e muito mais.

Made with ❤️ by Yasmin Carolina | Discord: diamonds1666