Redstone circuits

Redstone circuitry is a feature introduced in Alpha which allows for intricate Redstone wire based mechanisms to be created by players.

Advanced Redstone circuitry may be seen as comparable to the "WireMod" addon popular within Garry's Mod and to digital electronics in real life.

Redstone Basic Mechanics
Redstone wire, or dust, has two states: on and off (lit and unlit). The simplest way to activate redstone wire is to put a switch, button, floor plate, or redstone torch adjacent to the wire, and then activating the switch/button/floor plate will activate the redstone. It also works to have a switch, button, or redstone torch directly above redstone wire, attached to a wall. It also works to have a block built above redstone wire, and then to put a switch/button/plate/torch on top of that block; then, activating the switch/button/plate will power the redstone, two cubes below. The reason this works is because the switch/button/plate/torch will "power" the block underneath it, and this powered block will power the redstone below it. The mechanics of "powering" a block are not obvious, and it is helpful to first better introduce the other key element of redstone circuitry: the redstone torch.

Redstone torches are on by default, supplying power to redstone wires adjacent or below. To place a redstone torch, one must attach it to a block somehow--perhaps on the side of a block, perhaps on top of a block. Now, if the block that the torch is attached to is "powered", this causes the redstone torch to turn off. The confusing part is powering a block. To turn a redstone torch off, you have to power the block it is attached to. Any block that can have a torch attached can be "powered", but this "powered" state is invisible. The following are all ways to power a block:


 * If a button/switch/plate is attached to a block, activate that object to power that block.
 * If there is any redstone on top of a block, if the redstone is lit, the block is powered.
 * If there is a redstone torch underneath a block, if the torch is lit, the block is powered.
 * Tricky one: if redstone wire leads along the ground straight up to the side of a block, and the final square before the wire hits the block is perfectly straight (no 90 degree turn, no intersection/fork), then activate the redstone wire to activate the block.

The rules are rather specific. Think of a "powered block" being like a cube of dirt that is invisibly electrified but safe to touch, and that there are specific ways to power a block. So, we know how to power a block, and we know a powered block will deactivate redstone torches attached to it. What else will it do?


 * If a block is powered, a redstone torch attached to it will be deactivated (as was said).
 * If a block is powered, a door on top of it, adjacent to it, or above it will be opened (or closed depending on how the door was placed. It's tricky because doors were implemented unintuitively.)
 * If a block gets powered, and it is a note block/dispenser, it will play/shoot.
 * If a block gets powered, and rails are above it, they will toggle shape. (You can still have the wiring power the rail directly.)
 * If a block is powered, then it will activate any redstone wire adjacent, above, or below it...unless the block's only power source is redstone wire. In other words, when redstone wire powers a block, the powered block will not activate all other redstone connected to it.

Because of this logical behavior of redstone torches, powered blocks, and redstone wire, logical circuitry is possible. For example, the following are one set of steps to make a logical "Not gate": 1) put down a block, 2) have redstone wire lead straight up to a block; this is the input, 3) attach a redstone torch to another side of that block, and 4) have more redstone wire leading away from the torch; this is the output. That output wire will always be on, because it is touching a redstone torch, but will turn off when the torch turns off, which happens when the input is turned on. Essentially, the output is the opposite of the input, which is the objective of a Not gate. Note that the output wire can be anywhere next to the torch, but not diagonal. It could even be one cube underneath the torch, if the torch is on a wall. It could even be above the torch, on a block, since the torch powers the block above it, and the block powers the redstone above it.

Lastly, the following are common errors that may aid in understanding:


 * Trying to power a block by putting activated redstone underneath it. This does not work!  Only redstone torches can power a block upwards like that.  It does work the other way around though: a block receiving power will activate redstone beneath it.
 * Thinking that a redstone torch can power an adjacent block. This does not work!  Redstone torches only power a) adjacent wires, b) wires underneath, and c) blocks above them.
 * Trying to power a block with redstone. It can be frustrating!  The easy way is to make sure the redstone goes/is up on top of the block.  The straight-up-to-the-block method is hard to get right, because that last square cannot have any turn or intersection on it.
 * Again, note that a block powered only by redstone will not power other redstone touching it.
 * Switches on top of blocks are slightly buggy. If you put a switch on top of a block, make sure that it works properly immediately.  Depending on what order the redstone and switch are placed, and what direction you are facing, and what direction the switch is facing, some combinations of these options will cause the switch to not power the block underneath at all.  If it happens, to fix it, destroy the block, change positions, and try to put the block and switch down again.

Logic Gates
A logic gate can be thought of as a simple device that taking one or more inputs will return an output decided upon from the inputs according to the rule that the logic gate follows. For example if both inputs on an AND gate are in the 'true'/'on'/'powered' state the gate will return 'true'/'on'/'powered'. Much more in-depth information and a better explanation of this expansive topic is available on Wikipedia.

Below is a list of some of the basic gates with example images and MC Redstone Sim diagrams. There are many different ways to construct them other than those shown below, so use them as guidelines for creating one to fit your needs.

Circuit Symbols
Each symbol represents one or two blocks (one represents three), viewed from above. All descriptions are with reference to a "ground level".



From left to right:
 * 1) Air: air over air, i.e. two empty blocks, one above the other above ground level
 * 2) Block: air over a block (of any sort)
 * 3) Two Blocks: block over block, i.e. two solid blocks above ground level
 * 4) Wire: wire (with a block assumed to below the wire, below ground level)
 * 5) Redstone Torch: air over redstone torch (all torches are redstone torches in circuits)
 * 6) Wire on top of Block
 * 7) Torch over Block
 * 8) Block over Wire (i.e. the wire has an air block just above it; blocks cannot be put directly on wire)
 * 9) Block over Torch
 * 10) Torch over Wire (i.e. the wire has an air block just above it, the torch is above this)
 * 11) Bridge: wire on top of block, over wire (with the usual empty air block)
 * 12) Lever (aka Switch): air over switch
 * 13) Stone Button: air over button (button lasts 10 ticks)
 * 14) Pressure Plate: air over plate
 * 15) Door: 2-high
 * 16) Shadow

NOT Gate (¬)
A device that inverts the input, as such it is also called an "Inverter" Gate.

OR Gate (∨)
A device where the output is on when at least one of the inputs are on.

A simpler version of the OR gate is design A: merely a wire connecting all inputs and outputs. However, this causes the inputs to become "compromised", so that they can only be used in this OR gate. If you need to use the inputs elsewhere, version B is necessary.

Note that design B is a simple inversion of a NOR gate.

AND Gate (∧)
A device where the output is on when both inputs are on. This behaves in a manner equivalent to a Tri-state buffer, where input B acts like a switch, so that if it is off, input A is disconnected from the rest of the circuit. The discrepancy from real-life tri-state buffers lies in the fact that one cannot drive a low current in Minecraft. (See the Wikipedia article for details.)

An example application would be building a locking mechanism for a door, requiring both the activating button and the lock (typically a lever) to be on.

NOR Gate (⊽)
A device where the output is off when at least one of the inputs are on. All logic gates can be made from either this gate or the NAND gate. In Minecraft, this is the basic logic gate, implemented by a torch. A torch can have as many as 4 mutually isolated inputs (design B), but 3 can fit comfortably (design A), and all are optional. A torch with 1 input is the NOT gate, and with no inputs is the TRUE gate (i.e. a power source). If more inputs than 4 are necessary, one must resort to the non-isolated OR gate with a NOT at the end (at expense of isolation), or multiple NOR gates, according to the formula A ⊽ B ⊽ C = A ⊽ ¬(B ∨ C) (at the expense of speed, due to the nested gates).

NAND Gate (⊼)
A device where the output is off when both inputs are on.

XOR Gate (⊻)
A device which activates when the inputs are not equal to each other. Pronounced "exor". Adding a NOT gate to the end will produce an XNOR gate, which activates when the inputs are equal to each other. A useful attribute is that a XOR or XNOR gate will always change its output when one of its inputs changes.

XNOR Gate (≡)
In logic, this is more commonly referred to as "if and only if" or "iff" for short. It is device which activates only when the inputs are equal to each other. This is achieved by inverting the output or one input of an XOR.

IMPLIES Gate (→)
A device which represents material implication. Returns false only if the implication A → B is false, that is, if the conditional A is true, but the consequent B is false. It is often read "if A then B."

Latches and Flip-Flops
Latches and Flip-Flops are effectively 1-bit memory cells. They allow circuits to store data and deliver it at a later time, rather than acting only on the inputs at the time they are given. Functions using these components can be built to give different outputs in subsequent executions even if the inputs don't change, and so circuits using them are referred to as "sequential logic". They allow for the design of counters, long-term clocks, and complex memory systems, which cannot be created with combinational logic gates alone.

The common feature at the heart of every redstone latch or flip-flop is the RS NOR latch, built from two NOR gates whose inputs and outputs are connected in a loop (see below). The basic NOR latch's symmetry makes the choice of which state represents 'set' an arbitrary decision, at least until additional logic is attached to form more complex devices. Latches usually have two inputs, a 'set' input and a 'reset' input, used to control the value that is stored, while flip-flops tend to wrap additional logic around a latch to make it behave in different ways.

RS NOR latch


A device where Q will stay on forever after input is received by S. Q can be turned off again by a signal received by R.

This is probably the smallest memory device that is possible to make in Minecraft. Note that Q means the opposite of Q, e.g. when Q is on, Q is off and vice-versa. This means that in certain cases, you can get rid of a NOT gate by simply picking the Q output instead of putting a NOT gate after the Q output.

A very basic example of use would be making an alarm system in which a warning light would stay turned on after a pressure plate is pressed, until you hit a reset button.

In the truth table, S=1, R=1 is often referred to as forbidden, because it breaks the inverse relationship between Q and Q. Also, some designs where the input is not isolated from the output, such as B and D, will actually result in Q and Q both apparently being 1 in this case. As soon as either S or R becomes 0, the output will be correct again. However, if S and R both become 0 on the exact same tick, the resulting state could be either Q or Q, depending on quirks of game mechanics. In practice, this input state should be avoided because its output is undefined.

RS NAND latch
Since NOR and NAND are the universal logic gates, a design for an RS NAND latch is just an RS NOR with inverters applied to the inputs and outputs. The RS NAND is logically equivalent to the RS NOR as the same inputs for R and S give the same outputs.

When S and R are both off, Q and Q are on. When S is on, but R is off, Q will be on. When R is on, but S is off, Q will be on. When S and R are both on, it does not change Q and Q. They will be the same as they were before S and R were both turned on.

D Flip-Flop
A D flip-flop, or "data" flip-flop, sets the output to D only on certain conditions. The basic level-triggering D flip-flop (design A), also known as a gated D latch, sets the output to D as long as the clock is set to OFF, and ignores changes in D as long as the clock is ON. Design B includes an edge-trigger, and will set the output to D only at the moment the clock goes from OFF to ON.

In these designs, the output is not isolated; this allows for asynchronous R and S inputs (which override the clock and force a certain output state). To get an isolated output, instead of using Q simply connect an inverter to Q.

Design C is a one block wide version of A, except for using a non-inverted clock. It sets the output to D as long as the clock is ON (turning the torch off). This design can be repeated in parallel every other block, giving it a much smaller footprint, equal to the minimum spacing of parallel data lines (when not using a "cable"). A clock signal can be distributed to all of them with a wire running perpendicularly under the data lines, allowing multiple flip-flops to share a single edge-trigger if desired. The output Q is most easily accessed in the reverse direction, toward the source of input. Q can be inverted or repeated to isolate the latch's Set line (the unisolated Q and Q wires can do double duty as R and S inputs, as in design A).

Design E provides a more compact version of A, while still affording the same ceiling requirement. The design to the right in the image however requires 1 more block ceiling allowance, but allows the edge trigger to act on a high input. This additional ceiling requirement can be circumvented by simply moving the vertical NOT gate, to a lateral position 2 blocks downward. There is also the option of simply providing a NOT gate on the clock for your data bank, thus preventing the requirement of a gate for each flip flop.

JK Flip-Flop
An unclocked JK Flip-Flop works a lot like a RS NOR Latch. When the input J is ON and the input K is OFF, the output Q is ON. It will then hold that state until only K or both is ON. When only K is ON the Q is OFF. When both inputs are on they will start a race condition. This means that the output will keep changing until one of the inputs is turned OFF (It doesn't race fast enough to burn out the torches).

''NOTE: Some of the illustrated JK Flip-Flops to the right don't include the typical inverse Q output. If you want to use the inverse Q then just add an inverter to the Q.''

T Flip-Flop
T Flip-Flops are also known as "toggles". Whenever T changes from 0 (off) to 1 (on), the output will toggle its state.

A useful way to use T Flip-Flops in Minecraft could for example be a button connected to the input. When you press the button the output toggles (a door opens or closes), and does not toggle back when the button pops out. (Designs C and D do not have an incorporated edge trigger and will toggle multiple times unless the input is passed through one first.)

It is also the core of all binary counters and clocks, as it functions as a "period doubler", turning two input pulses into one output pulse.

Design A has a large footprint, but is easy to build. It (and B, which is a slightly compacted version of A) is essentially a JK flip-flop with the inputs for J and K removed so that it relies on the edge trigger (right side of the diagram) to keep it in the stable state and only allow a single operation per input.

Design C has a smaller footprint and an easily accessible inverse output, but lacks an edge trigger. If the input is kept high, it will repeatedly toggle on and off, cycling quickly enough to burn out its torches. For example, if the button mentioned above is wired directly to its input, the device can toggle several times before the button shuts off. Even a 4-clock is too slow to reliably result in only one toggle.

Adding an edge trigger by routing input through a separate pulse generator (design B' seems to work best) will prevent this problem, as will any other means of sending it a short (2-3 tick) pulse of power.

Designs D and E are much taller than the others, but only a single block wide, making them good for situations where floorspace is limited. D is level-triggered like design C, which can save space when distributing one input pulse to multiple flip-flops. E has a single block wide edge trigger added on, making it easy to daisy-chain multiple units to create a binary counter or period-doublers for a slow clock. These designs are based on the vertical gated D latch (design C) with the inverse output looped back to the input.

''NOTE: Some of the illustrated T Flip-Flops to the right don't include the typical inverse Q outputs. If you want to use the inverse Q then just add an inverter to Q.''

Repeater/Diode
Using two Redstone torches in series can effectively extend your running wire length past the 15-block limitation. As of 1.0.2 (the July 6th update), there must be a strip of wire between the two Redstone torches. Repeaters makes it possible to send long-distance signals around the map, but in the process, slows down the speed of transfer. To reduce delays, you can stretch out the repeater so that some areas of the wire are consistently in the opposite state, but as long as the amount of Redstone torches, or, effectively, NOT Gates is even, the signal will be correct. In more advanced circuits, repeaters can be used as a semi-conductors; to isolate in- or outputs.

The North/South Quirk
A specific arrangement of torches which would normally be expected to behave identically to a repeater, causing a 2-tick delay in signal transmission, instead causes only a 1-tick delay. (See figure 1.) When constructed with the torches facing east and west, this arrangement causes the expected 2-tick delay, but when facing north and south, the second (top) torch changes state at the same time as the first, after only a single tick. The quirk can cause unexpected bugs in complicated circuit designs when not accounted for, but it does have several practical uses. For example, double doors require opposite power states, but inverting one signal delays that door's response by 1 tick. The only known way to perfectly synchronize them is with this 1-tick repeater. Another application is in creating a clock circuit (see below) with an even pulse width and period.

Finally, as a generalization of the double-door use, the North/South Quirk can be used to obtain two signals which are always inversely related without the additional 1-tick delay a NOT gate normally causes in the second signal. (See figure 2.) This can be especially useful in circuits where precise timing is important, such as signal processing that relies on the transition of an input from high to low and low to high (on to off and back), for example by sending each of the inverse signals through separate edge detectors (see pulse generators below) and then ORing their outputs.

Delay Circuit
Sometimes it is desirable to induce a delay in your redstone circuitry. Delay circuits aim to do this in a compact manner. These two delay circuits utilize torches heavily in favor of compactness, but in doing so the builder must be aware of the North/South Quirk. For maximum signal delay, construct these designs so that the stacked torches face east and west. For a fine-tuned delay, adjust the design to rotate one of the alternating-torch stacks to face north and south, or add an additional stack in that orientation.

Design A gives a 4 tick delay, while design B gives a 3 tick delay.

One possible use for delay circuits is to make music. With the introduction of Note Blocks in Beta 1.2, delay circuits can be mixed in with wire and note blocks to create sequences of notes. Here's an example http://www.youtube.com/watch?v=6gPMtzuCKdg

Clock generators
Clock generators are devices where the output is toggling on/off constantly. The simplest stable clock generator is the 5-clock (designs B and C). Using this method, 1-clocks and 3-clocks are possible to make but they will "burn out" because of their speed, which makes them unstable. Redundancy can be used to maintain a 1-clock, even as the torches burn out; the result is the so-called "Rapid Pulsar" (designs A and F). Slower clocks are made by making the chain of inverters longer (designs B'  and C'  show how such an extension process can be achieved).

Using a different method, a 4-clock can be made (design D). A 4-clock is the fastest clock which will not overload the torches.

A 4-clock with a regular on/off pulse width is also possible as seen in design E. This design uses five torches, but can be constructed so that it has a pulse width of 4 ticks by employing the North/South Quirk. It is important that the orientation of this design (or at least the portion containing the stacked torches) be along the north/south axis.

The customary name x-clock is derived from half of the period length, which is also usually the pulse width. For example, design B (a 5-clock) will produce the sequence  on the output.

Designs F and G are examples of possible vertical configurations.

Design H is a example of a 11 clock that goes around 50% slower then a 5 clock

Pulse Generators
A device that creates a pulsed output when the input changes. A pulse generator is required to clock flip-flops without a built-in edge trigger if the clock signal will be active for more than a moment (i.e., excluding Stone Buttons).

Design A will create a short pulse when the input turns off. By inverting the input as shown in B, the output will pulse when the input turns on. The length of the pulse can be increased with extra inverters, shown in B'. This is an integral part of a T flip-flop, as it prevents the flip-flop changing more than once in a single operation. Designs A and B can be put together to represent both the increase of A and the decrease of A as separate outputs, these can then be ORed to show when The input changes, regardless of its state.

A pulse generator which causes a short pulse of low power instead of high can be made by removing the final inverter in design B' and replacing it with a wire connection. This is the type used in designs A and B of the T and JK flip-flops (when J=1 and K=1) to briefly place these devices in the 'toggle' state, long enough for a single operation to take place.

Monostable Circuit


A device that turns itself off a short time after it has been activated. Basically, it consists of a RS-NOR-latch (marked blue), which is required for saving the state it is in (powered on/off), and a torch that is connected to itself (marked green). In "off" state, this torch is always off. When the device is turned on, the torch will start flickering, turning itself on and off rapidly. However, any connected torches will stay in the state they were before the flickering started. After approximately 1.5 seconds the torch will burn out, thus turning off and resetting the whole device. Of course, this torch can be replaced by any other delay.

It can also be used to delay a signal by using its reset signal as output.



It is possible to extend the time after which the circuit will reset itself by duplicating the circuit marked green up to a maximum of three (Design Z). If the duration is any longer, the first torch will regenerate before the last one burns out, thus burning out again and again, never allowing the circuit to reset. However, a longer delay can be achieved by using the device's reset signal to activate a second Monostable Circuit.

Once turned on, the device will ignore any new input until it has reset itself and the first burnt out torch is again ready to use. Building this device requires 11 redstone cable and 5 redstone torches.

Vertical transmission
Sometimes it's necessary or desirable to transmit a redstone state vertically, for example to have a central control or status for several circuits from a single observation point. To transmit a state vertically, a 2×2 spiral of blocks with redstone can be used to transmit power in either direction, and the spiral is internally navigable (i.e. one can climb or descend within the tower).

If repeaters are necessary, there is a 1×1 design for transmitting a state upward, and a 1×2 design for transmitting a state downward. For this to be effective you MUST NOT finish the top torch ON only OFF will switch the current when needed. Internal navigability of these designs inside a 2×2 tower interior can be maintained using ladders.

Blink device
This device creates energy in an irregular sequence.

You can build this device by placing a block with one redstone torch on every side. Place some redstone on top of the block, and place a new block on top of each torch. Then wire it up to different circuits.

This device will stop working after the server restarts, or if you save and come back. All torches and redstone will be off. Reconstruction will be necessary.

By connecting all the torches together, this device will keep going, because although the torches burn out, they are all connected. Giving you a 1 tick timer.

Mechanical to Electrical Conversion


Making use of a quirk involving the update function on blocks near a water or lava source, it is possible to convert the "mechanical" energy of updating a nearby block into a redstone signal. To do this, create a water or lava rig that will shift when the desired block updates (for more info, read this thread). Then position a redstone torch or powder trail so that the water/lava will wash/burn the torch or powder. Do this in such a way that the missing redstone component will change the input to your circuit.

Once this setup has been rigged, the next time an update function is called in an adjacent block to the water/lava source, it will trigger your mechanism. Update functions include: an adjacent block is placed by a user, gravel or sand falls into an adjacent block, grass grows, wheat grows, an adjacent block receives power, an item resting on an adjacent block changes state (such as a door being opened).

This setup can only trigger once before needing to be manually reset.

Electrical to Liquid Kinetic Conversion
It is possible to use the same quirk described in the Mechanical to Electrical Conversion section to make water or lava flow as desired. In order to do this, simply follow the instructions in this thread and run a redstone wire to the block adjacent to the water/lava source. Whenever the redstone wire toggles state, the water/lava source will update. If arranged properly, this can be used to redirect water or lava whenever the desired input is given via redstone circuit.

Related pages

 * Redstone
 * Redstone (wire)
 * Redstone (ore)
 * Redstone (dust)
 * Diode/Repeater/Delayer
 * Redstone Torch
 * Advanced Electronic Mechanisms
 * Mechanisms
 * Traps
 * CraftBook (mod) adds integrated circuits and programmable logic chips to SMP

Redstone-Schaltkreise