Content generated with AI — it may contain mistakes.

ExyliaTotemTrainer/How it worksUpdated in v1.2.0

How training works

The totem mechanic, a solo session from start to summary, and what the plugin protects while a player is inside.

Page 10 of 237 min read

Solo training is one player, one engine, one sidebar. The engine is the same object a duel uses, so everything on this page about hits, reactions and protections applies to duels too; what a duel adds is on Duels.

Before you start#

At least one arena must be ready, and players need no permission beyond the default /totem. To change what a session throws at the player, see Choose and tune the modes.

The mechanic#

Every interval the engine deals a lethal hit that a totem in either hand absorbs. The player then has to get the next totem into a hand before the following hit. The time between the hit and the re-equip is the reaction, and the reaction is what gets graded.

StepWhat happens
Before the hitThe hands are checked server-side. Main hand or off hand holding a totem: the hit is dealt. Neither: the player failed, no hit is dealt, no death happens.
The hitPlayer#damage with cause CUSTOM and a lethal amount. The totem pops.
The re-equipSwapping hands, scrolling the hotbar, clicking or dragging in the inventory: any way a totem reaches a hand. Evaluated one tick later, when the server's inventory is the one the player sees.
The reactionMeasured from the hit to the re-equip, in nanoseconds, then graded. See Grading.
The restockOne tick after the pop the mode puts totems back: a stocked mode tops up its count in random empty slots, a full-inventory mode refills or completes. See Modes.

Ticks drive the cadence; nanoseconds measure the reaction. The interval is the speed the player picked in ticks, unless the mode draws it from a window or speeds it up.

Nobody ever sees a death screen

A player without a totem in hand is not hit at all. The engine reports a fail instead, so a session ends with a title and a message, never with a respawn.

A session, start to finish#

/totem train <mode> [ticks], or a mode in the Solo training screen of /totem after picking a speed.

Checks

The mode has to exist, the interval has to be one of training.ticks, and a ready arena with room has to exist: without one the player reads "No arena is ready. Ask an administrator." and nothing is taken from them. A start within two seconds of the last one is ignored. A player already training or duelling reads "Finish what you are doing first."; one held by another Exylia plugin reads "You are busy in %plugin%."; one another plugin advises against taking reads "Not right now: %reason%." See Compatibility.

Claim and snapshot

The player is claimed for TRAINING, and their location and inventory are saved. Until they arrive in the arena they keep what they hold, so dropping, placing, using an item and opening a chest or the ender chest are refused meanwhile.

Isolation

They join a group of their own: they see nobody and nobody sees them, and they cannot be hit or touched from outside. See Compatibility.

Arena

The least-loaded ready arena is picked and the player is sent to its spawn A. Once they stand there, their inventory, cursor and crafting grid are cleared and they are put in adventure mode whatever they walked in as. See Arenas.

Countdown

training.countdown seconds (3.0 by default) with a title and an action bar. The default subtitle tells them to press E and swap totems from their inventory. Punching the air ends the countdown at once.

The drill

The totems are handed out, the held slot is set to the first one, the first hit is scheduled and the training sidebar appears. See Scoreboard.

The chat confirms the start: "Training started: %mode% · %ticks% ticks."

How a session ends#

ReasonWhenWhat the player sees
FAILEDNo totem in hand when a hit landedThe fail effect ("POPPED OUT") and "Missed a totem after %pops% pops.", then the summary screen
COMPLETEDA full-inventory mode without refill ran out of totemsThe training-complete effect ("COMPLETE") and "Training complete!", then the summary screen
LEFT/totem leave, or the leave button in the menuThe summary screen; the command also says "You left."
DISCONNECTEDThe player quitNothing; the numbers are stored
CANCELLEDAnother plugin took the player, or the plugin was disabledNothing; the numbers are stored

Whatever the reason, the session is stored when it had at least one pop or one fail: the lifetime profile moves and the record for that mode and speed is merged. See Statistics. The TrainingEndEvent carries the same reason.

The summary#

Once the player is home again, a session that ended as FAILED, COMPLETED or LEFT less than a minute ago opens the session summary screen, menus/training_result.yml: pops, fails and best streak; the rating, mode, speed, 0–100 score and duration; the best and average reaction. Two buttons follow it up: Play again starts the same mode at the same speed, and Back ▸ Solo training opens the training picker. The screen opens once; a player who quits before it opens never gets it.

The file knows %mode%, %ticks%, %pops%, %fails%, %best% and %average% (seconds with two decimals), %streak%, %score%, %rating% (the score weighted by the speed, see Grading) and %duration%.

While inside#

The same protections apply to solo training and duels.

WhatRule
DamageEverything but the engine's own hit is cancelled, including another plugin's damage() call with the same cause.
HungerFrozen.
ItemsDropping and picking up are cancelled. Between the claim and the arrival, and again on the way home, placing and breaking blocks, using an item or a block, and taking anything into a chest or the ender chest are cancelled too, so nothing can leave a copy behind when the snapshot is handed back.
ChatWith chat.isolation on (the default), a session's or a duel's chat stays inside it: the player reads only the others in it, and the rest of the server reads none of it.
Other playersHitting, right-clicking or being hit by anyone outside your group is cancelled. Players inside a session are not collidable.
CommandsOnly the labels in match.allowed-commands run (totem, tt, totemtrainer, msg, r, tell, w by default). Anything else reads "Leave with /totem leave before using that command." A plugin:command prefix is stripped before the check.
MovementFree in solo training. Pinned on the horizontal axes in a duel, falling allowed.
Leaving by other meansA teleport the plugin did not do (an ender pearl, a chorus fruit) or a world change ends the session, or forfeits the duel.
A death from elsewhereIf another plugin kills the player through a path the damage guard did not see, the inventory is kept, the drops are cleared, the console warns and the player is taken out.

Leaving#

Exit runs in a fixed order: the engine stops and the loadout is taken back, the player is teleported back to where they came from (or to arena.return-location), the inventory and game mode are restored from the snapshot once they are there, and the claim is released last, so no other mode can dress the player while their inventory is still on its way back.

After a crash

A snapshot left behind by a restart is restored on the player's next join, and they are sent back to where they were before the session started. Nobody wakes up inside an arena.

Check that it works#

Run /totem, click Solo training, pick a mode and a speed. After the countdown you are alone in the arena with totems in your inventory and the training sidebar on screen. Swap a totem into a hand after each pop and watch the grade on the action bar. Stop swapping and the "POPPED OUT" title ends the session with the summary screen. /totem leave exits at any time and returns your inventory.

Something missing on this page? Tell us on Discord