Introduction
What ExyliaAimTrainer does, what you need, and what you will have working in ten minutes.
ExyliaAimTrainer is an aim trainer for servers that take PvP practice seriously. A player shoots a drill alone, tuned to the target size and distance they choose, or challenges another player to a best-of duel in which both shoot the same targets at the same time. Every run is scored, every best is kept, and every drill has its own leaderboard.
The targets are not entities. Each one is sent as packets to the one player who shoots it: a block you see and an interaction box riding it that you hit. The server has nothing to tick, any number of players share one arena without seeing each other's targets, and a click is judged by the player's own client running the same hitbox test it runs on another player — exactly the way a PvP hit is judged.
Bedrock players join in through Geyser and Floodgate, with targets their client can draw and boards of their own. Every menu, message and sidebar ships in English, Spanish, Portuguese, French, Russian and Turkish.
What is included#
Eighteen shipped across four kinds — flicking, 180° and 360° flicks included, reaction, tracking and
combo fights with a real weapon — and none hardcoded: a drill is a block of numbers in config.yml.
A score in the drill's own currency, a difficulty from the way it was played, and the rating that is both multiplied together and the one number the boards rank.
SettingsEach player picks target size, distance, colour and style, and what their screen shows. Smaller and farther earns more rating.
DuelsDirect challenges, best-of series, the same seed on both screens so the same targets appear in the same places.
ArenasOne spawn per arena, created from the admin menu, shared by every drill and duel sent to it.
StatisticsProfiles, personal bests per drill, a board per drill and category, an overall board, each for Java and for Bedrock, session and duel history.
Requirements#
| Requirement | Detail |
|---|---|
| Server | Paper 1.21.1 or newer. Folia 1.21.4 or newer. |
| Java | 21 |
| Required dependencies | ExyliaLib, packetevents |
| Optional dependencies | PlaceholderAPI, ExyliaPracticeCore, Geyser and Floodgate for Bedrock players |
Typed configuration, declarative YAML menus, the database, placeholders, effects, sidebars, overlays, inventory snapshots and the player claims that keep Exylia plugins from stepping on each other all come from ExyliaLib. The plugin is written on top of it and does not run without it.
How to read this documentation#
Getting started
Installation, a first arena, a first drill and a first duel within minutes.
Guides
Set up arenas, tune drills, player settings, duels, the HUD and statistics. This is where most of the time goes.
How it works
What happens during a drill, how scoring and rating work, and how the plugin behaves next to the rest of the Exylia ecosystem.
Reference
Commands, permissions, placeholders, every configuration key, the menus and the developer API.
Help
Common problems and the FAQ.
Conventions#
- Values marked as default are what the plugin writes the first time it starts. If the file already exists, your value is kept.
- Identifiers between
<and>are variables./aim train <drill>means/aim train gridshot, not/aim train <gridshot>. - Times are seconds with decimals unless a key says ticks; 20 ticks are one second. Distances and sizes are blocks.
- Colours use ExyliaLib palette tokens (
{primary},{highlight},{muted}); MiniMessage tags such as<click>and<hover>work too, as the default duel request shows.
Something missing on this page? Tell us on Discord