Minecraft:Commands/schedule

Template:Infobox command Schedules the function(s).

Usage

in Template:Editions, delays the execution of a function or all functions in a function tag. The function(s) are executed by the Minecraft:server after specified amount of time passes.

in Template:Editions, schedules a function to be executed once an area is fully loaded, or after a certain amount of time.

in Template:Editions, the same functions or the same function tags cannot have two schedules executed at the same game tick.

in Template:Editions, in replace mode, overrides an unexecuted schedule directly when a function or a function tag already has an unexecuted schedule. For example, if a function is scheduled to be executed in 30 seconds, and before it is executed you want to modify the execution time, you can use replace mode to set a new schedule to replace the original.

Even when using the execute as ... command, the scheduled function always runs as the server at Minecraft:world spawn.

Syntax

• Java Edition

schedule function <function> <time> [append|replace]

Adds a schedule.

schedule clear <function>

Removes a schedule.

• Bedrock Edition

schedule on_area_loaded add <from: x y z> <to: x y z> <function: filepath>

schedule on_area_loaded add circle <center: x y z> <radius: int> <function: filepath>

schedule on_area_loaded add tickingarea <name: string> <function: filepath>

Adds a schedule to be executed once an area is loaded.

schedule delay add <function> <delay (ticks)> [append|replace]

schedule delay clear <function>

Delays a schedule.

schedule clear <function: filepath>

schedule on_area_loaded clear function <function: filepath>

schedule on_area_loaded clear tickingarea <name: string> [function: filepath]

Removes a schedule.

Arguments

Template:El: <function>: function
Template:El: function: filepath: CommandFilePath

Specify the function to be run.

{{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|function}}{{#vardefine:be-arg|function}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

1. REDIRECT Template:Edition

Template:Rcat: <time>: time

Specify the delay time.

{{#vardefine:onlyje|}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|time}}{{#vardefine:be-arg|}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

One thing to note is that the delay time of

1. REDIRECT Template:Code

Template:Redr does NOT always mean one tick of delay. Instead, it schedules the function for the upcoming phase for scheduled functions.

• If

1. REDIRECT Template:Code

Template:Redr is executed in

1. REDIRECT Template:Code

Template:Redr functions, it schedules the function for the phase in the same tick, which comes right after the phase for the

1. REDIRECT Template:Code

Template:Redr functions.

• If

1. REDIRECT Template:Code

Template:Redr is executed during the "scheduled functions" phase, it schedules the function for the next phase, which is coming in the next tick.

Thus, specifying

1. REDIRECT Template:Code

Template:Redr in

1. REDIRECT Template:Code

Template:Redr functions makes the function run within the same tick, and specifying

1. REDIRECT Template:Code

Template:Redr in scheduled functions makes the function run in the next tick.

1. REDIRECT Template:Edition

Template:Rcat: <function>: string (in

1. REDIRECT Template:Code

Template:Redr mode)

Specify the function to be cleared. Should be a namespaced ID (minecraft: cannot be omitted) or a function tag(minecraft: cannot be omitted).

{{#vardefine:onlyje|}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|string}}{{#vardefine:be-arg|}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

1. REDIRECT Template:Edition

Template:Rcat: append|replace

replace — (default) Simply replaces the current function's schedule time.

append — Allows multiple schedules to exist at different times.

1. REDIRECT Template:Edition

Template:Rcat: from: x y z: CommandPosition and to: x y z: CommandPosition

Specifies the coordinates of opposite corners of a rectangular area used to define a loaded area.

{{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|block_pos}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

For x and z, numbers less than -30,000,000 or greater than 30,000,000 are treated as -30,000,000 or 30,000,000 respectively.

1. REDIRECT Template:Edition

Template:Rcat: center: x y z: CommandPosition

Specifies the coordinates of the center point of a circular area used to define a loaded area.

{{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|block_pos}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

For x and z, numbers less than -30,000,000 or greater than 30,000,000 are treated as -30,000,000 or 30,000,000 respectively.

1. REDIRECT Template:Edition

Template:Rcat: radius: int: int

Specifies the radius of a circular loaded area as the number of chunks from the center to the edge of the circle.

{{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|integer}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}} It should be between 0 and 2,147,483,647 (inclusive).

1. REDIRECT Template:Edition

Template:Rcat: name: string: basic_string

Specifies the name of a ticking area, executes function when which is added.

{{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|string}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

Output

{{#vardefine:output-table-lines|}}{{#vardefine:output-table-lines|-2}}{{#vardefine:output-table-lines-now|}}{{#vardefine:command-num-now|}}{{#vardefine:command-line-now|}}{{#vardefine:commands-num|}}{{#vardefine:output-edition-num-now|}}{{#vardefine:output-edition-line-now|}}{{#vardefine:output-editions-num|}}{{#vardefine:je-outputs-dis|}}

{{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On fail}}{{#vardefine:output1-{{#var:output-table-lines}}|0}}{{#vardefine:output2-{{#var:output-table-lines}}|0}}{{#vardefine:output3-{{#var:output-table-lines}}|0}}{{#vardefine:command-row-{{#var:commands-num}}|}}{{#vardefine:output-editions-num|}}{{#vardefine:output-edition-{{#var:output-editions-num}}|je}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|1}} {{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On success}}{{#vardefine:output1-{{#var:output-table-lines}}|1}}{{#vardefine:output2-{{#var:output-table-lines}}|1}}{{#vardefine:output3-{{#var:output-table-lines}}|The game tick the function is to execute at modulo 2147483647}}{{#vardefine:commands-num|}}{{#vardefine:command-{{#var:commands-num}}|/schedule function ...}}{{#vardefine:command-row-{{#var:commands-num}}|1}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|}} {{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On success}}{{#vardefine:output1-{{#var:output-table-lines}}|1}}{{#vardefine:output2-{{#var:output-table-lines}}|1}}{{#vardefine:output3-{{#var:output-table-lines}}|the number of schedules that are cleared.}}{{#vardefine:commands-num|}}{{#vardefine:command-{{#var:commands-num}}|/schedule clear ...}}{{#vardefine:command-row-{{#var:commands-num}}|1}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|}} {{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On fail}}{{#vardefine:output1-{{#var:output-table-lines}}|0}}{{#vardefine:output2-{{#var:output-table-lines}}|N/A}}{{#vardefine:output3-{{#var:output-table-lines}}|N/A}}{{#vardefine:command-row-{{#var:commands-num}}|}}{{#vardefine:output-editions-num|}}{{#vardefine:output-edition-{{#var:output-editions-num}}|be}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|1}} {{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On success}}{{#vardefine:output1-{{#var:output-table-lines}}|1}}{{#vardefine:output2-{{#var:output-table-lines}}|N/A}}{{#vardefine:output3-{{#var:output-table-lines}}|N/A}}{{#vardefine:command-row-{{#var:commands-num}}|}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|}}

{{#vardefine:output-table-lines|}}{{#vardefine:output-table-lines|-2}}{{#vardefine:output-table-lines-now|}}{{#vardefine:command-num-now|}}{{#vardefine:command-line-now|}}{{#vardefine:commands-num|}}{{#vardefine:output-edition-num-now|}}{{#vardefine:output-edition-line-now|}}{{#vardefine:output-editions-num|}}{{#vardefine:je-outputs-dis|}}

History

External links

• Template:Cite

Navigation

All editions	clear clone damage deop difficulty effect enchant execute fill function gamemode gamerule give help kick kill list locate loot me msg op particle place playsound recipe reload ride say schedule scoreboard setblock setworldspawn spawnpoint spreadplayers stopsound summon tag teleport tell tellraw time title tp transfer w weather xp Removed placefeature
Template:El only	advancement attribute ban ban-ip banlist bossbar data datapack debug defaultgamemode dialog experience fetchprofile fillbiome forceload item jfr pardon pardon-ip publish random return save-all save-off save-on seed setidletimeout spectate stopwatch swing team teammsg tm test tick trigger version waypoint worldborder Debug chase debugconfig debugmobspawning debugpath raid serverpack spawn_armor_trims warden_spawn_tracker Removed ? achievement banip blockdata broadcast chunk entitydata home iron locatebiome replaceitem setspawn solid stats testfor testforblock testforblocks toggledownfall unban wood
Template:Els only	stop whitelist
Template:El only	aimassist allowlist changesetting clearrealmevents controlscheme dedicatedwsserver gametips packstack project reloadconfig reloadpacketlimitconfig save sendshowstoreoffer set_movement_authority Removed aigoals automate automateactivetool automatebreakblock automatefindblock automatefly automategetinteractionpositionforblock automatelookat automatemove automatemoveto automateplaceblock bhave bossbar bounds cleanroom clearslot clearinventory crash crashclient crashserver createlocalworld destroyblock detect dumpblocknames dumpentitiesclient dumpentitiesserver enchantrandom fillchestblock filldrive findanchoredbuildpos findflatarea findnearbypickups fixbiomes fly getactivescreen getavgendframerate getavgremaindertimepercent getavgrendertime getavgticktime getavgunaccountedtimepercent getblockname getbrightness getchestcontents getchunkdirtycount getchunkrebuildcount getchunksortcount getcpu getdurability getexperience getfps getgpu getgpumemory getguiscale getmsaalevel getos getplayerbiome getplayerid getpos getpower getprofilersecondsperupdate getresolution getselecteditemcount getskin getstructure getsysteminfo getsystemmem getviewdistance getworldname health hunger islargechestblock isplayercrouching isplayerflying isplayergrounded isworldloaded kit leaveworld loadbehaviortreedefinitions log lookat memwarn mixer nearbyentityisbaby networkstats notifyprofiler paths pause placefromhand playerstat profile redstonetest register3pserver resupply rot selectinventoryitem sendmodalform setbrightness setguiscale setskin setviewdistance showallitems showfrustum simlock simscale simulationtype skin spawnfeature spawning spawnitem spawnmob stoptime systemstat testassets timelock tptobiome tptosuitabletree villages volumearea wipeout
Template:El only	classroommode closechat code codebuilder lesson remove videostream Removed position videostreamaction
Template:Els only	? ability agent alwaysday camera camerashake clearspawnpoint codebuilder_actorinfo connect daylock dialogue drop enableencryption event fog getlocalplayername gettopsolidblock hud immutableworld inputpermission listd mobevent music ops permission playanimation querytarget replaceitem script scriptevent setmaxplayers structure takepicture testfor testforblock testforblocks tickingarea titleraw toggledownfall wb worldbuilder wsserver Removed clearfixedinv executeasself move place setfixedinvslot setfixedinvslots test transferserver
Joke	debugdim transform vote warp
Related	Argument types Permission level Slot Target selectors

de:Befehl/schedule es:Comandos/schedule ja:コマンド/schedule pt:Comandos/schedule ru:Команды консоли/schedule zh:命令/schedule