Commands
##Introduction
This page lists every stopwatch command. They all live under /aevum stopwatch …. A stopwatch counts up from zero; create takes no time argument, and it adds a reset verb. Time arguments on add/remove/set accept 90, 90s, 5m, 1h30m, 2d (see time format).
INFO
Plus the plugin-wide /aevum help [page] and /aevum reload. Timers have their own command page.
##Stopwatch commands
| Command | Example | Description |
|---|---|---|
| /aevum stopwatch create <name> [scope] [target] | /aevum stopwatch create run | Creates a stopwatch. Scope is global (default), player or team. |
| /aevum stopwatch add <name> <time> [target] | /aevum stopwatch add run 1m | Adds elapsed time to a stopwatch. |
| /aevum stopwatch remove <name> <time> [target] | /aevum stopwatch remove run 1m | Removes elapsed time from a stopwatch. |
| /aevum stopwatch set <name> <time> [target] | /aevum stopwatch set run 30s | Sets a stopwatch's elapsed time. |
| /aevum stopwatch status <name> [target] | /aevum stopwatch status run | Shows a stopwatch's time and state. |
| /aevum stopwatch pause <name> [target] | /aevum stopwatch pause run | Pauses a stopwatch. |
| /aevum stopwatch resume <name> [target] | /aevum stopwatch resume run | Resumes a stopwatch. |
| /aevum stopwatch reset <name> [target] | /aevum stopwatch reset run | Resets a stopwatch back to zero. |
| /aevum stopwatch mark <name> <label> [target] | /aevum stopwatch mark run lap1 | Records a checkpoint at the current elapsed time. |
| /aevum stopwatch marks <name> [target] | /aevum stopwatch marks run | Lists a stopwatch's checkpoints. |
| /aevum stopwatch unmark <name> <label/*> [target] | /aevum stopwatch unmark run lap1 | Removes a checkpoint. Use * to clear them all. |
| /aevum stopwatch list | /aevum stopwatch list | Lists all stopwatches with their scope and instance count. |
| /aevum stopwatch delete <name> [target] | /aevum stopwatch delete run | Deletes a stopwatch. |
##Scopes & targets (recap)
The optional [scope] on create and [target] on every other command control who a stopwatch belongs to and which owners a command affects.
| Argument | Values | Meaning |
|---|---|---|
[scope] |
global (default), player, team |
One shared stopwatch, one per player, or one per Stella team. |
[target] (empty) |
— | Yourself (player-run only). From console a target is required. |
[target] |
<player> / <team> |
A single online player or a single team. |
[target] |
@all |
Every owner under that name. |
Full details in Getting Started → Scopes. For a
globalstopwatch the target is ignored.
##Explanation
- Creating —
createregisters a stopwatch under a name and scope. The scope is locked to that name afterwards. - Adjusting time —
add,removeandsetchange the elapsed value live;resetzeroes it. - Control —
pause,resumeandstatusmanage the run state. - Checkpoints —
mark,marksandunmarkrecord and inspect named splits (the elapsed time at each mark). They surface through Stopwatch Placeholders and the API. - Listing & deleting —
listshows every name with its scope and instance count;deleteremoves them. - No end — a stopwatch never ends on its own; it keeps counting until you pause, reset or delete it.