Skip to content

Documentation

Matthias edited this page Jul 11, 2023 · 6 revisions

Macros

One of Redstone Tools' biggest features is the macro system it adds. The macro system allows users to increase their productivity by removing the need to type commands into the chat and instead lets the user press a key to run a single or multiple commands (macros can also be triggered using a command, they don't require keybinds). 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 (or the escape menu), and go to Options... -> Controls... -> Macros.... Once you're in the macro menu you'll be able to:

  • Edit macros by clicking the pencil icon next to the macro you want to edit.
  • Delete macros by clicking the red X next to the macro you want to delete.
  • Disable/enable macros by unchecking/checking the box next to the macro you want to disable/enable.
  • Create a new macro by pressing the Create new... button.

The Macro Edit Screen

Once you're editing a macro you'll have the option to change its name, keybind, and commands. Note that changes won't be saved until you click Done, to discard changes you can click Cancel or press escape.


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.


doBlockUpdatesAfterEdit

When enabled, force updates all blocks in your selection after a WorldEdit action such as //paste, //set, etc., defaults to false.


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.

New Commands

/copystate

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


/colored <blockType>

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

blockType

The block type.


/quicktp [distance=50.0] [includeFluids=false]

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

distance

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

includeFluids

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 false, defaults to false.


/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. decimal, hexadecimal, 5, etc.


/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 or command block for overloaded ss.


/itembind

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


/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.


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, defaults to 2.


//update

Force updates all blocks in your selection.


//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=decimal] [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, 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.