Redstone Comparator

A redstone comparator is a block used in redstone circuits to maintain, compare, or subtract signal strength, or to measure certain block states (primarily the fullness of containers).

Breaking
A redstone comparator can be broken instantly with any tool, including the player's fist, and drops itself as an item.

A redstone comparator is removed and dropped as an item if:
 * its attachment block is moved, removed, or destroyed;
 * water flows into its space;
 * or a piston tries to push it or moves a block into its space.

If lava flows into a redstone comparator's space, the redstone comparator is destroyed without dropping itself as an item.

Usage
A redstone comparator can be placed on the top of any opaque block with a solid full-height top surface (including upside-down slabs and upside-down stairs). $$, a comparator can also be placed on walls and fences. For more information about placement on transparent blocks, see Opacity/Placement.

The redstone comparator has a front and a back — the arrow on the top of the comparator points to the front. When placed, the comparator faces away from the player. The comparator has two miniature redstone torches at the back and one at the front. The back torches turn on when the comparator's output is greater than zero (the arrow on top also turns red). The front torch has two states that can be toggled by the comparator:
 * Down and unpowered (indicating the comparator is in "comparison mode")
 * Up and powered (indicating the comparator is in "subtraction mode")

The redstone comparator can take a signal strength input from its rear as well as from both sides. Side inputs are accepted only from redstone dust, redstone blocks, redstone repeaters, redstone torches, and other comparators. The redstone comparator's front is its output.

It takes 1 redstone tick (2 game ticks, or 0.1 seconds barring lag) for signals to move through a redstone comparator, either from the rear or from the sides. This applies to changing signal strengths as well as simply to turning on and off. Redstone comparators usually do not respond to 1-tick fluctuations of power or signal strength — for example, a 1-clock input is treated as always off from the side, and always on from the rear.

The redstone comparator has four functions: maintain signal strength, compare signal strength, subtract signal strength, and measure certain block states (primarily the fullness of containers).

Maintain signal strength
A redstone comparator with no powered sides outputs the same signal strength as its rear input. In this regard, the comparator is similar to a redstone repeater.

Compare signal strength
A redstone comparator in comparison mode (front torch down and unpowered) compares its rear input to its two side inputs. If either side input is greater than the rear input, the comparator output turns off. If neither side input is greater than the rear input, the comparator outputs the same signal strength as its rear input.

Formula: Output = Rear × (Left <= Rear AND Right <= Rear)

Subtract signal strength
A redstone comparator in subtraction mode (front torch up and powered) subtracts the signal strength of the higher side input from the signal strength of the rear input.

Formula: Output = max(Rear - max(Left, Right), 0)

For example: if the signal strength is 6 at the left input, 7 at the right input and 4 at the rear, the output signal has a strength of max(4 - max(6, 7), 0) = max(4-7, 0) = max(-3, 0) = 0.

If the signal strength is 9 at the rear, 2 at the right input and 5 at the left input, the output signal has a strength of max(9 - max(2, 5), 0) = max(9-5, 0) = 4.

Measure block state
A redstone comparator treats certain blocks behind it as power sources and output a signal strength proportional to the block's state. The comparator may be separated from the measured block by a solid block. However, $$, if the solid block is powered to signal strength 15, then the comparator outputs 15 no matter the fullness of the container.

Containers
Using a redstone comparator to measure the state of a container will output a signal strength in proportion to how full the container is (0 for empty, 15 for full, etc.).

Containers that can be measured by a comparator include:
 * on top of a detector rail
 * on top of a detector rail
 * Large chest
 * Large trapped chest
 * (any color)
 * on top of a detector rail
 * on top of a detector rail
 * Large chest
 * Large trapped chest
 * (any color)
 * on top of a detector rail
 * Large chest
 * Large trapped chest
 * (any color)
 * (any color)

Generally speaking, the comparator output signal strength represents the average fullness of the slots, based on how many of that item form a full stack (64, 16, or 1 for non-stackable items).

The Minimum Items for Container Signal Strength table (right) shows the minimum number of 64-stackable items required to produce the different signal strengths from each type of container. Numbers followed by an "s" or "i" indicate the number of full 64-stack equivalents ("s"), and additional items less than a stack ("i") required. For items that stack in 16s (snowballs, signs, ender pearls, etc.), divide the "i" number by 4 and round up. Each non-stackable item counts as one full-stack.

For example, to produce a signal strength of 10 from a hopper requires the equivalent of 3 full stacks plus 14 more items, or 206 items total, assuming they all stack in 64.

When a comparator measures a large chest or large trapped chest, it measures the entire large chest (54 slots), not just the half directly behind the comparator. A chest or trapped chest that cannot be opened (either because it has an opaque block, ocelot, or cat above it) always produces an output of 0 no matter how many items are in the container — shulker boxes can always be measured, even if they cannot open.


 * Calculating signal strength from items


 * When a container is empty, the output is off.


 * When it is not empty, the output signal strength is calculated as follows:






 * Example: 300 blocks in a dispenser (which has 9 slots), where each block stacks to a maximum of 64, produces output with a signal strength of 8:

1 + ((300 items / 64 items per slot) / 9 slots) * 14 = 8.292, floored is 8


 * Note that a non-stackable item is counted as a full slot (1 item in a slot, with a max stack size of 1: 1 / 1 = 1.0), and items that stack up to 16 (such as ender pearls, snowballs and eggs) are similarly considered a full slot at 16.


 * Calculating items from signal strength


 * It can be useful in redstone circuits to use containers with comparators to create signals of a specific strength. The number of items required in a container to produce a signal of desired strength is calculated as follows:




 * Example: To use a furnace (which has 3 slots) to create a strength 9 signal, players need 110 items:

max(9, (3*64/14)*(9-1)) = 109.714, rounded up is 110

Miscellaneous
Some non-container blocks can also be measured by a redstone comparator:




 * A cake outputs a signal strength relative to the amount of cake remaining. Each slice is worth 2 signal strength, with 7 total slices, for an output of 14 for a full cake.




 * A cauldron outputs different signal strengths depending on how much water is inside. From completely empty to completely full, the output values are 0, 1, 2, and 3. If lava is inside, the strength is always 1.




 * A composter outputs different signal strengths depending on the level inside. From completely empty to completely full, the output values are 0, 1, 2, 3, 4, 5, 6, 7 and 8.




 * A command block stores the "success count" of the last command executed, which represents the number of times the most recently used command of this command block succeeded. A "success" is defined by the command's success conditions: if a red error message is returned in the chat, the command was not successful.


 * Most commands can succeed once per execution, but certain commands (such as those that accept players as arguments) can succeed multiple times, and the comparator outputs the number of times it succeeded (maximum 15 when sent to redstone dust, but is in code able to go up to 32bit int limit, and can be used in contraptions with no redstone dust with those values).


 * A command block continues to store the success count of the last command executed until it executes its command again, thus the comparator continues to output the same signal strength even after the command block is no longer being activated (it doesn't turn off when the signal to the command block turns off).




 * An end portal frame outputs a full signal of 15 if it contains an eye of ender and zero otherwise.




 * A comparator can measure the state of an item frame's contents. An item frame comparator outputs 0 if the item frame is empty, or 1 to 8 for any item depending on its rotation: 1 at initial placement, plus 1 for each 45° of rotation for a maximum of 8.


 * The comparator must be placed behind the block the item frame is attached to, facing away from the item frame. The block must be a full block, and the item frame cannot be submerged in water. Having a sign in the same block as the item frame will prevent the frame from sending a signal as well.




 * A jukebox outputs a signal strength indicating which music disc is currently playing. See the Minimum Items for Container Signal Strength table above.




 * A lectern outputs a signal strength that depends on what page the player is currently on. (e.g. a book with 15 pages powers 1 redstone level per page, or one with 5 pages emits 3 signal strength per page.)


 * and


 * A hive or nest outputs a signal strength equal to the amount of honey in the hive/nest.




 * A respawn anchor outputs a signal strength of 0, 3, 7, 11, or 15, depending on the “charged” value.




 * A sculk sensor outputs a signal strength depending on the type of vibration that is detected.

ID




Metadata
$$, redstone comparators use the following data values:

Block data
A redstone comparator has a block entity associated with it that holds additional data about the block.

Trivia

 * Comparators are intentionally designed by Mojang to not emit redstone particles when powered, unlike redstone torches and repeaters.