Commands/stopwatch

This feature is exclusive to Java Edition.

 

{
    "title": "<code>/stopwatch</code>",
    "rows": [
        {
            "field": "2",
            "label": "(link to Permission level article, displayed as Permission level<br>required)"
        },
        {
            "field": "None",
            "label": "(link to Commands#Restrictions article, displayed as Restrictions)"
        }
    ],
    "invimages": [],
    "images": []
}

Allows manipulation of stopwatches to keep track of real time — the time measured is not affected by the game's tick rate (i.e. pausing, /tick, or even server lag). This makes it useful to detect and compensate for lag e.g. when programming functions in a data pack.

The time is calculated with millisecond precision. Therefore:

• When displayed, it is presented in seconds with 3 decimal places (e.g. 43.961s).
• While any number can be used as the scale argument, a scale with a value >1000 is not useful to extract additional precision in the integer return value.

/stopwatch ...

... create <id> - Creates a stopwatch, which immediately begins running

... query <id> [<scale>] - Gets the value of the stopwatch, the amount of time since it was created/restarted in seconds.

... restart <id> - Restarts a stopwatch

... remove <id> - Removes a stopwatch

<id>: resource_location

Specifies the stopwatch to operate on.

Must be a resource location for an unregistered content.

<scale>: double

Specifies the value to multiply the returned value by, e. g. stopwatch query foo:bar 20 would get the elapsed time in ticks^[1]. Does not affect the value displayed in chat. If the return value would exceed 32-bit signed integer limits (<-2147483648 or >2147483647), it is clamped.