# play.measure

> Talos 0.6 · Since 0.6

Step Play tick by tick with actions held over chosen ticks, reading entity fields after each: per field first, final, min and max with the tick; the first tick each condition held; rows on request.

For jump apex, run speed, time to a target. An entity despawning mid-run is recorded (despawned), not an error. Leaves the world paused, keys up.

| | |
|---|---|
| Title | Measure a run |
| Mode | `editor` |
| Token cost | about 308 tokens (listed only when its toolset is enabled) |
| Toolset | `measure` |

## Arguments

| Argument | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `every` | `integer` | no | `1` |  | Sample every N ticks |
| `inputs` | `object[]` | no |  |  | [{name, value?, from?, to?}]: an action held from tick from (0) to to (the end); value as play.input takes it |
| `rows` | `boolean` | no |  |  | Include the sampled rows |
| `sample` | `object[]` | no |  |  | [{entity, field}]: field is a dotted path into /entity/{id} (position.y, script.state.x), or speed (horizontal m/s) |
| `ticks` | `integer` | no | `60` |  | 1/60 s each |
| `when` | `object[]` | no |  |  | [{entity, field, op, value, stop?}]: op is > >= < <= == != |

## Example

An MCP `tools/call` with the required arguments (placeholders in angle brackets).

```json
{
  "name": "play.measure",
  "arguments": {}
}
```