Actions

The action system is a collection of actions which are used automatically and via manual invocation.

Actions

A list of all current actions in react.

Action

Description

Selectors

Fix Lighting

Fixes lighting in the area

Position

CPU Score

Benchmarks the CPU

Dump

Dumps data to a pastebin.

File Size

Reads server file sizes for totals

Timings

Fires a timings report and finishes it for you.

Time

Chunk Test

Benchmarks chunk performance in the area

Position, Time

Cull Entities

Culls entities (removes some not all)

Position, Entity

Collect Garbage

Invokes System.gc(). Warning, dangerous.

Purge Entities

Purges all "typical" entities

Position, Entity

Purge Chunks

Purges chunks which are outside of all player views

Position

Lock / Unlock Fluid

Locks or unlocks fluid depending on action used

Position, Time

Lock / Unlock Redstone

Locks or unlocks redstone depending on action used

Position, Time

Lock / Unlock Hoppers

Locks or unlocks hoppers depending on action used

Position Time

Selectors

Action selectors allow you to control actions in a fine tuned way.

Positional Selectors

Positional selectors allow you to control the position and area that an action will fire in. Positional selectors work on a chunk grid. This means you select a position based on an area of chunks. The default is every chunk in every world. You can tweak this like so.

This Chunk
That Chunk
Specific Chunks

You can specify the chunk you are currently in as a reference point as "this"

@c:this

You can use "this" as the center of a chunk radius selection also.

@c:this+3

The "+NUM" suffix specifies the amount of CHUNKS to expand outwards from the reference point. It is advised you keep this below 10.

You can specify the chunk you are looking at (within your view distance) instead of the chunk you are actually inside of with the "look" tag.

@c:look

You can use "look" as the center of a chunk radius selection also.

@c:look+4

The "+NUM" suffix specifies the amount of CHUNKS to expand outwards from the reference point. It is advised you keep this below 10.

You can reference a specific chunk instead of "this" or "look" by specifying the world.x,z

@c:world_nether.15,13

Note that you cannot specify a radius such as @c:ww.15,13+3 as this is not allowed

You can specify every loaded chunk in a given world also by using a star (asterisk)

@c:world_the_end.*

Or specify every loaded chunk

@c:*

Time Selectors

Time selectors allow you to control how long an action should run for

Measurement

Example

Suffix

Game Ticks

@t:8t

t

Milliseconds

@t:150ms

ms

Seconds

@t:5s

s

Minutes

@t:2m

m

Hours

@t:3h

h

Entity Selectors

Entity selectors allow you to control which entity types to act upon (or which not to). Simply specify an entity type https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html

Selection Syntax

There are a couple extra tricks that are good to know when using selectors

AND
NOT

And literally means AND. It means combine these, or to compound. It uses the "&" symbol.

@c:this&look

Adds the chunk you are currently in, AND the chunk you are looking at into the selection

Not literally means not and is represented by the "!" symbol

@c:this+3&!look

Specifies a radius of 3 chunks around your location, but SUBTRACTS the chunk you are looking at out of the selection. The "&!" means A AND NOT B (or but not)