minecraft:timer
Adds a timer after which an event will fire.
Properties
| Property | Type | Default | What it does |
|---|---|---|---|
looping | Boolean | true | If true, the timer will restart every time after it fires. |
randomInterval | Boolean | true | If true, the amount of time on the timer will be random between the min and max values specified in time. |
time | Object | — | Amount of time in seconds for the timer. Specified as a pair of numbers (min and max). Incompatible with random_time_choices. |
min | Decimal | 0 | |
max | Decimal | 0 | |
time_down_event | Object | {"event": "", "filters": {"AND": null, "NOT": null, "OR":… | Event to fire when the time on the timer runs out. |
event | Text | "" | |
target | Textself, other, player, target, parent, baby, block, damager, holder, item | "self" | |
filters | Object or List of object | {"AND": null, "NOT": null, "OR": null, "all": null, "all_… | Filters allow data objects to specify test criteria which allows their use. Filters can be defined by a single object of type (Filter Test), an array of tests, collection groups, or a combination of these objects. |
test | Text | — | The name of the test to apply. |
subject | Boolean or Integer or Decimal or Text | — | The subject of this filter test. |
operator | Boolean or Integer or Decimal or Text | — | The comparison to apply with 'value'. |
domain | Boolean or Integer or Decimal or Text | — | The domain the test should be performed in. |
value | Boolean or Integer or Decimal or Text | — | The value being compared with the test. |
random_time_choices | List of object | [] | This is a list of objects, representing one value in seconds that can be picked before firing the event and an optional weight. Incompatible with time. |
value | Decimal | 0 | |
weight | Integer | 0 |
Example from the game files
This is how vanilla Wandering Trader uses it in Minecraft Bedrock 1.26.60.5:
{
"minecraft:timer": {
"looping": false,
"random_time_choices": [
{
"value": 2400,
"weight": 50
},
{
"value": 3600,
"weight": 50
}
],
"time_down_event": {
"event": "minecraft:start_despawn",
"target": "self"
}
}
}Used by 19
Vanilla entities with minecraft:timer in their definition:
Related components
damage_sensorinteractenvironment_sensoron_target_acquiredon_target_escapegame_event_movement_trackingentity_sensorrail_sensortarget_nearby_sensorbody_rotation_blockedon_friendly_angeron_hurtblock_sensorinside_block_notifierlooked_aton_hurt_by_playerschedulervibration_listenerbody_rotation_always_follows_headon_deathon_equipment_changedon_start_landingon_start_takeoffon_wake_with_owner