Commands/tickingarea

Commands/infobox

Sets, queries, and removes ticking areas. Up to 10 ticking areas can be defined at one time.

Syntax

tickingarea add <from: x y z> <to: x y z> [name: string]

tickingarea add circle <center: x y z> <radius: int> [name: string]

tickingarea remove <name: string>

tickingarea remove <position: x y z>

tickingarea remove_all

tickingarea list [all-dimensions]

Color added to make reading easier.

Arguments

A Y coordinate is not actually needed to identify a chunk, because a chunk spans the entire vertical height of the world. Nevertheless, a Y coordinate must be entered where shown in the arguments below. It can have any value, but will always be stored as 0.

from: x1 y1 z1 and to: x2 y2 z2

Specify the coordinates of opposite corners of a rectangular area used to define a ticking area.

center: x y z

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

radius: int

Specifies the radius of a circular ticking area as the number of chunks from the center to the edge of the circle. It must be from 1 to 4.

name: string

Specifies an optional name for a ticking area. A value that contains spaces must be enclosed in double quote marks. The name is shown in the list of ticking areas and can be used to remove a specific area.

position: x y z

Specifies the coordinates of a point within the ticking area(s) being removed.

Result

Fails if the arguments are not specified correctly, if attempting to add an 11th ticking area, if attempting to add a ticking area larger than 100 chunks or a circular ticking area with a radius less than 1 or greater than 4 chunks, or if attempting to add a ticking area with a duplicate name.

On success:

• add

Adds a ticking area consisting of all chunks that overlap any part of the rectangle.

• add circle

Adds a ticking area consisting of all chunks that overlap any part of the circle.

• remove

Deletes a ticking area. If name is specified, only the ticking area with that name is deleted. If position is specified, all ticking areas that include the point at those coordinates are deleted.

• remove_all

Deletes all currently defined ticking areas.

• list

Displays the ticking areas in the current dimension. If the optional all-dimensions argument is specified, the list includes all ticking areas currently defined. Note that the coordinates shown in the list are adjusted to the boundaries of a chunk in the case of a rectangle, or to the center of a chunk in the case of a circle.

Examples

To define a rectangular ticking area covering the rectangle area from (280, 72, 105) to (328, 78, 130), enter either /tickingarea add 280 0 105 328 0 130 or /tickingarea add 280 0 130 328 0 105.

To define a circular ticking area named "Homebase" centered on the chunk you're currently in and extending 2 chunks in every direction, enter /tickingarea add circle ~ ~ ~ 2 Homebase.

To remove the ticking area named "world spawn", enter /tickingarea remove "world spawn".

To remove all ticking areas that contain the block at coordinates (-200, 72, 1000), enter /tickingarea remove -200 72 1000.

To list all ticking areas defined in all dimensions enter: /tickingarea list all-dimensions