Skip to content

Documentation

Matt edited this page Aug 19, 2025 · 23 revisions

Macros

One of Redstone Tools' biggest features is the macro system it adds. The macro system allows users to increase their productivity by allowing users to press a keybind to quickly run a command or list of commands. Below is a guide on how to get started using macros.

The Macro Menu

To add, edit, delete, disable/enable or simply inspect macros, you have to open the macro menu. To do this, open the main menu (escape) and go to Options... -> Controls... -> Macros..., use the keybind, or simply run /edit-macros. Once you're in the macro menu you'll be able to:

  • Edit macros by clicking the Edit button next to the macro you want to edit.
  • Delete macros by clicking the Remove button to the macro you want to delete.
  • Create a new macro by clicking the Add macro button.

The Macro Edit Screen

Once you're editing a macro you'll have the option to change its name, keybind, and commands. You can also use advanced keybind settings by clicking its icon next the hotkey.


Gamerules

Redstone Tools adds gamerules to help users configure their worlds just the way they like them, below is a list of all gamerules added by Redstone Tools and what they do.

doContainerDrops

Whether or not containers should drop their items when they're broken, defaults to true.


Options

Redstone Tools has a few configurable options. Below is a list of these options.

Hotkey to open menu

When pressing this hotkey, will open the config menu, defaults to V+C


Improved command suggestions

When typing "/give @s redstblock" in chat, with this disabled it will give no suggestions (default behaviour, or "prefix matching"), but with this enabled it will give "redstone_block" as a suggestion (so called "fuzzy matching"), defaults to true.


Airplace outline

Whether to show the block outline when airplace is enabled, defaults to true.


Bigdust size

How tall the redstone dust hitbox should be when bigdust is enabled. Can be from 0 (flat) to 16 (full block), defaults to 3.


Commands

Redstone Tools adds a bunch of commands to improve productivity. Below is a list of the names of all commands added by Redstone Tools and what they do.

Basic commands

/copystate

Gives you an exact copy of the block you're looking at including it's NBT data.


/colored [<blockType=wool>]

Gives you a block of the specified type with the color of the block you're looking at.

blockType

The block type. Can be concrete, glass, terracotta or wool.


/quicktp [<distance=50.0>] [<throughFluids=false>] [<resetVelocity=true>]

Teleports you distance blocks in the direction you're looking or to the block you are looking at if it's closer.

If after 10 seconds it is still calculating where you should end up, it will cancel the teleport.

distance

The distance to teleport you in blocks, defaults to 50.0.

throughFluids

Whether to teleport to a fluid you're looking at if it's closer than distance, will let you teleport through fluids if set to true, defaults to false.

resetVelocity

Whether to reset your velocity to 0 after teleporting, defaults to true.


/macro <macro>

Runs a macro.

macro

The name of the macro to run.


/base <number> <toBase>

Converts a number to a different base and outputs it.

number

The number to convert, e.g. 0b1001, 0xffe2, 0o25, 0d123 or 123.

toBase

The base to convert number to, e.g. 10.


/ssb [<signalStrength=15>] [<block=auto>]

Gives you a container that outputs the specified signal strength.

signalStrength

The signal strength the barrel should output, defaults to 15.

block

The container type to give you, defaults to auto meaning it'll be a barrel.


/itembind [<reset=false>]

Binds the next command you run to the item you're holding.

reset

If true, will remove the currently bound item.


/reach <distance>

Changes your default reach.

distance

The distance in blocks to set your block and entity reach to.


/reach-block <distance>

Changes your default block reach.

distance

The distance in blocks to set your block reach to.


/reach-entity <distance>

Changes your default entity reach.

distance

The distance in blocks to set your entity reach to.


/g <item> [<count>=1>]

Shorthand for the vanilla /give @s.

item

The item to give.

count

The amount to give, defaults to 1.


Toggles

For toggles that have settings (Currently /airplace and /bigdust) their settings can be found in the config menu, accessible by pressing the Hotkey to open menu hotkey

/airplace

Lets you place blocks in the air if there is no block in reach.


/autodust

Automatically places redstone dust on colored blocks such as wool and glass that you place.


/bigdust

Makes the redstone dust hitboxes bigger.


/clickcontainers

Increases the level of cauldrons and composters by one when right-clicking them with an empty hand.


/autorotate

Automatically rotates rotatable blocks by 180 degrees.


WorldEdit Extensions

//colorcode <color> [<onlyColor=all>]

Converts all colored blocks such as wool and glass in your selection to the given color.

color

The color to convert the selected blocks to.

onlyColor

If set will only color the blocks with this color. For example, if onlyColor is red only red blocks will be recolored.


//rstack [<count=1>] [<direction=me>] [<offset=2>]

Stacks your selection with a custom distance.

count

The amount of times to stack your selection, defaults to 1.

direction

The direction to stack your selection in, defaults to me (the direction you're looking in).

offset

The offset between copies. 1 means 0 air gaps in between, 2 means one air gap in between, defaults to 2.


//minsel

Minimizes your selection by removing surrounding layers consisting of only air. Note that this might not work with some selection visualisers like //drawsel.

//read [<offset=2>] [<onBlock=redstone_lamp[lit=true]>] [<toBase=10>] [<reverseBits=false>]

Interprets your selection as a binary number and outputs it. First position is the MSB.

offset

The offset between tested blocks, defaults to 2.

onBlock

The block that represents a 1 bit. Otherwise, if it doesn't match, it will be a 0 bit, defaults to redstone_lamp[lit=true] (a lit redstone lamp).

toBase

The base to output the value of the binary number in, defaults to decimal.

reverseBits

Whether the bits are in reverse, defaults to false.