Content generated with AI — it may contain mistakes.

Commands

The player command with its subcommands, the staff command, what each optional argument defaults to and why a command is refused.

Page 13 of 254 min read

Two roots that never overlap. /aim is the player's door and opens the main menu; /aimtraineradmin is the staff door and opens the admin menu. /aimtrainer and /at are aliases of the first, /aimadmin of the second.

Player commands#

CommandWhat it doesPermission
/aimOpen the main menu.exyliaaimtrainer.use
/aim train [drill]Start a drill. Without a name it starts the default drill (`training.default-drill`, `gridshot`).exyliaaimtrainer.train
/aim drillsOpen the drill picker.exyliaaimtrainer.train
/aim settingsOpen your settings: target size, distance, colour, style and what the screen shows.exyliaaimtrainer.settings
/aim duel [player] [drill] [bestOf]Without a player, opens the opponent picker. With one, sends the duel request straight away. Without a drill it uses the first drill in `config.yml`; without a length, `match.default-format`.exyliaaimtrainer.duel
/aim acceptAccept the pending duel request.exyliaaimtrainer.duel
/aim denyDecline the pending duel request. Never needs a permission.—
/aim profile [player]Open a profile: yours or another player's.exyliaaimtrainer.profile
/aim leaderboard [drill] [category]Open the board picker, or one drill's board on your own edition (Java or Bedrock). `overall` opens the overall board.exyliaaimtrainer.leaderboard
/aim historyOpen your recent duels.exyliaaimtrainer.history
/aim sessionsOpen your recent drills.exyliaaimtrainer.history
/aim leaveLeave the drill. Inside a duel it is a forfeit and the opponent wins. Never needs a permission.—

Every one of them is for players. From the console, /aim and its subcommands answer with the player-only line.

What the optional arguments default to#

ArgumentDefaultRefused when
drill (train)training.default-drill (gridshot). If that id is not a configured drill, the first drill in drills.The id is not a configured drill: unknown-drill.
drill (duel)The first drill listed in drills — not training.default-drill.The id is not a configured drill: unknown-drill.
bestOfmatch.default-format (3)The length is not in match.formats, or it is even and allow-even-formats is off: unknown-format. The default is checked the same way, so a default-format missing from formats refuses every duel sent without one.
drill (leaderboard)—An unknown id opens the board picker instead of an empty board. overall opens the overall board.
categoryratingNever: an unknown category falls back to rating. On the overall board only rating and accuracy exist; anything else is rating.
player (profile)YouSee below.

/aim profile <player> works for players the server already knows without a lookup: online, known to ExyliaLib's player directory, or in the server's user cache. Their numbers are read from the database when they are not loaded. A name that would need a lookup answers with player-not-found, which by default reads that the player is not online.

/aim duel <player> takes an online player.

Why a drill or a duel does not start#

/aim train checks, in this order, and answers with the first line that applies:

LineSectionWhen
unknown-drilltrainingThe drill does not exist.
no-packetscommonPacketEvents is missing, so targets cannot be drawn.
no-arenacommonNo arena is ready, or every ready one is at arena.max-players-per-arena.
busycommonYou are already in a drill or a duel.
cannot-borrowpracticeYou are waiting in an ExyliaPracticeCore queue and practice will not lend you, or practice.train-while-queued is off.
busy-elsewhere, busy-advicecommonAnother Exylia plugin holds you, or advises against taking you.

/aim duel <player> refuses with self-duel, request-cooldown (you sent one less than match.duel-request-cooldown seconds ago), no-packets, busy (you are already in a duel), queued (you are in a practice queue), target-queued, target-busy or target-not-ready. Being in a drill is no reason to refuse, on either side: whoever is in one leaves it when the duel is accepted. Another plugin can also cancel AimDuelRequestEvent, in which case nothing is said. There is one pending request per challenged player: a newer request replaces the older one. /aim accept answers no-pending when there is nothing open or it has expired, and player-not-found when the challenger has left; both sides are checked again before the duel is created.

While in a drill or a duel#

Only the commands in training.allowed-commands run: aim, aimtrainer, at, msg, r, tell and w by default. Anything else is cancelled with command-blocked. A plugin:command prefix is stripped before the check. There is no permission that bypasses the list, and /aimtraineradmin is not on it: a member of staff inside a drill has to leave first, or be added to the list.

Tab completion suggests the configured drills, the lengths in match.formats and the seven leaderboard categories. The drill suggestion also offers overall, which only means something to /aim leaderboard; /aim train overall answers unknown-drill. The format suggestion lists every length in formats, including even ones that allow-even-formats then refuses.

Staff commands#

Everything below needs exyliaaimtrainer.admin.

CommandWhat it doesPermission
/aimtraineradminOpen the admin menu: arenas, running duels, players and reload.exyliaaimtrainer.admin
/aimtraineradmin reloadReload config.yml, messages.yml, scoreboards.yml, the scoring model and every menu. Also works from the console. Arenas and player data are not touched.exyliaaimtrainer.admin

Reload runs five named steps:

StepWhat it does
configsReads config.yml, messages.yml and scoreboards.yml again — in the language config.yml now names — then applies the prefix and the debug switch.
scoringRebuilds the scoring model from scoring.
scoreboardsRedraws every sidebar on screen from the new lines.
hotbarRefreshes menus/hotbar.yml around your edits and compiles it again.
menusRefreshes and compiles every screen. Also runs when ExyliaLib itself is reloaded.

The success line reports how many steps ran and in how many milliseconds; a failure asks you to check the console. A drill that is already running keeps the numbers it started with; the next one reads the new file.

Reload does not touch arenas or player data. Both live in the database, not in a file.

There is nothing else to type

Arenas are created, renamed, positioned, enabled and deleted from the arena screens. Running duels are cancelled, drills stopped and player statistics reset from their own screens. See Arenas and Menus. The one thing that stays a command is reload, because the console has to be able to run it.

Something missing on this page? Tell us on Discord