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

Command	Description
`/et set <id> <size> [timeout]`	Set a platform at your current position. Ex: `/et set P1 3 5` = 3×3 platform, 5s timeout
`/et list`	List all registered platforms with coordinates, range and timeout
`/et stats [id]`	View your statistics (all platforms or a specific one)
`/et reset [id]`	Reset your stats (all or a specific platform)
`/et delete <id>`	Remove a platform
`/et interval <minutes>`	Change the automatic periodic snapshot interval

Aliases: /elytratrainer, /etrain

`/snapshot` — Timed Training Session

Command	Description
`/snapshot start [minutes]`	Start a timed recording session (default: 5 min). Shows a summary when it ends
`/snapshot pause`	Pause or resume the active session timer

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

File	Description
`plugins/ElytraTrainer/config.yml`	Plugin configuration and saved platforms
`plugins/ElytraTrainer/attempts.csv`	Full history of all landing attempts
`plugins/ElytraTrainer/snapshots.csv`	Periodic and session snapshot data

✅ 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