Frequently asked questions
Short answers about ExyliaAimTrainer: why a drill will not start, duels, ratings, leaderboards, resets, Bedrock and where the data lives.
Quick answers to what owners and players ask most. For a step-by-step fix, see Common problems.
The plugin does not start#
packetevents is a hard dependency: without it the server never loads the plugin. ExyliaLib is listed as soft only so the loader can install it, but the plugin needs it to run. Check both are in plugins/. See Installation.
"Targets need PacketEvents, which this server does not have."#
A target is a pair of packet entities the server never has, so without a loaded PacketEvents there is nothing to draw and every drill and duel request is refused with that line. The console says so at startup: "PacketEvents is missing: targets cannot be drawn and no drill can start".
"No arena is ready. Ask an administrator."#
Drills and duels both need an arena. An arena is ready when it is enabled, has its spawn set, and that spawn is in a loaded world; in /aimtraineradmin, Arenas, a row marked [NO SPAWN] is missing one of those. The same line appears when every ready arena is full (arena.max-players-per-arena, 0 is unlimited) or in the first moments after boot, before the arenas are read from the database. See Arenas.
"Finish what you are doing first."#
The player is already in a drill or a duel (a drill does not stop them challenging, a duel does). "You are busy in <plugin>" means another Exylia plugin holds them, such as an FFA arena, an event or a practice match, and "Not right now: <reason>" means a plugin advises against it in its own words.
A player cannot duel somebody#
The refusal line says why: the target is busy, is <reason> (this plugin's own reason is "answering a duel request"), is waiting in an ExyliaPracticeCore queue, or you must "Wait <time> before challenging again" (match.duel-request-cooldown, fifteen seconds by default). A player has one request waiting at most, a newer one replaces the older, and requests expire after match.duel-request-expiry (thirty seconds). See Duels.
Hits feel off, or depend on ping#
The client does the aiming: every target has a hitbox the client tests with its own raycast, so a target is hit where the player sees it. Reaction times have the player's ping subtracted (capped at scoring.max-ping-correction-millis, 100 ms, and never more than half the time), and moving targets are judged where the client drew them by rewinding the ping plus two ticks. A reaction under min-reaction-millis (80 ms) is a false start. See Scoring.
Why does spam clicking not help?#
Every swing that hits nothing is a miss: scoring.miss-penalty (4) points against the hit-points (10) of a hit, and lower accuracy. In a fight, a hit on a target still red from the last one does nothing, and in a 1.9 drill (attack-cooldown: true) a swing charged no more than 90% is rushed and counts as a miss. See Training.
What is the difference between score and rating?#
The score is the drill's own number (points per minute, a reaction score, or time on target) and decides duel rounds. The rating is the score times the difficulty of the settings it was played at, clamped between scoring.min-difficulty (0.25) and max-difficulty (6.0); the boards rank by it, so nobody climbs by making targets easy. See Scoring.
Can players walk during a drill?#
No, every player is frozen during a drill because it measures their hands. They can only run the commands in training.allowed-commands (aim, aimtrainer, at, msg, r, tell and w by default), and an ender pearl, a teleport by another plugin or leaving the arena's world takes them out of the session.
A player stays in the arena after the drill ends#
That is the rest: training.rest-seconds, five by default. Play again replays the drill, Change drill picks another, and the time running out sends an idle player home; a player with a settings or drill screen open keeps waiting. Set it to 0 to send players home as soon as a drill ends.
How do I add a drill?#
Write a new block under drills in config.yml and run /aimtraineradmin reload. A drill is a kind (FLICK, REACTION, TRACK or COMBO) and a set of numbers, so a new one gets the same menus, records and boards. Renaming a key starts that drill over with empty boards. See Tune and add drills.
Duels feel unfair when players use different settings#
By default they do not use them: with match.use-preferences: false both sides play the drill as written and share one seed, so the same targets appear in the same places in the same order. Turning it on applies the challenger's size and distance to both. See Duels.
What is a draw, and why was a duel cancelled?#
A round goes to the higher score, then the better accuracy, then more hits; level on all three is a draw and the round is replayed. Three draws in a row mean neither side is shooting, and the duel is cancelled with nothing stored.
Can I offer a best-of-2 or best-of-4?#
List the length in match.formats and set match.allow-even-formats: true. An even series can end level once every round has been played; the winner of the last round then takes the duel.
A player is not on the leaderboard#
A board never places a zero and has one row per player. An accuracy only counts from sessions of at least leaderboard.accuracy-min-shots shots (twenty), and only drill sessions that ran their course reach the boards; duels set no records. Java and Bedrock have separate boards, and a board is cached for leaderboard.cache-seconds (five minutes) unless the player beat their best rating. See Statistics.
How do I reset a player's statistics?#
Open /aimtraineradmin, Players, pick the player and use the reset button; the list shows online players only. It goes through ExyliaLib's player reset: it asks first, kicks the player while it runs (the staff member needs exylialib.admin.wipe) and deletes their profile, settings and every drill record. Session and duel history stays unless the staff member adds history to the reset. See Statistics.
Can queued ExyliaPracticeCore players train?#
Yes, with practice.train-while-queued on (the default). They keep their place in the queue and go to the match the moment it is found. See Compatibility.
Players in a drill cannot see the server chat#
That is chat.isolation, on by default: whoever is in a drill or a duel reads only that one. Set it to false to leave chat as your chat plugin delivers it.
My edits to a menu or a message do not show#
The plugin reads the lang/<code>/ folder of the language config.yml names (default follows ExyliaLib), so edit the files of the language in use. A server updated from before languages has its old files in lang/custom/. See Configuration · language, Menus and Edit menus.
Can Bedrock players play?#
Yes, through Geyser and Floodgate. Their targets are drawn as slimes and they are ranked on Bedrock boards of their own, since touch and controller aim is not the same contest as a mouse. See Compatibility.
My PlaceholderAPI placeholders show up unresolved#
Every placeholder is %exyliaaimtrainer_<name>%, for example %exyliaaimtrainer_wins%. The older %exyliaaimtrainer_aim_wins% and %aim_wins% no longer resolve. See Placeholders.
Where are the arenas and the statistics?#
In the database, not in YAML: aim_arenas, aim_profiles, aim_records, aim_sessions and aim_matches. H2 by default; point database.yml at MySQL, MariaDB, PostgreSQL or MongoDB to share them between servers (see Database). History rows older than history.retention-days (30) are deleted, and a reload does not touch any of it.
Does it work on Folia?#
Yes, it declares Folia support, and every event it fires runs on the thread that owns the player or the arena it is about.
Where do I get support?#
On the Exylia Discord.
Something missing on this page? Tell us on Discord