Dispenser

Dispenser

Transparency	No
Luminance	No
Blast resistance	3.5
Tool
Renewable	Yes
Stackable	Yes (64)
Flammable	No
Drops	Itself
Name	dispenser

A dispenser is a solid block used as a redstone component to dispense items.

Obtaining

Dispensers can be mined with a pickaxe, in which case it drops itself and its contents. If mined without a pickaxe, the dispenser drops only its contents.

Block	Dispenser
Hardness	3.5
Tool
Breaking time
Hand	17.5
Wooden	2.65
Stone	1.35
Iron	0.9
Diamond	0.7
Golden	0.45

Crafting

Ingredients	Crafting recipe	Description
Cobblestone + Bow + Redstone Dust		Enchantments on the bow do not affect the resulting dispenser.

Natural generation

Two dispensers are naturally generated in every jungle temple.

Usage

A dispenser can be used as a container and as a redstone component that dispenses items when activated, with results varying on the item dispensed. For example, the trap in a jungle pyramid incorporates arrows inside a dispenser, which shoots when activated.

To place a dispenser, use it while pointing at a surface adjacent to the space it should occupy. A dispenser can be placed so that its output faces in any direction, including up or down. When placed, a dispenser faces the location of the player placing it.

A dispenser cannot be moved by pistons^{[Java edition only]} or water. Lava flows around a dispenser.

Container

The dispenser GUI.

A dispenser has 9 slots of inventory space.

To open the dispenser GUI, use the Use Item control. To move items between the dispenser inventory and the player inventory or hotbar while the dispenser GUI is open, drag or shift-click the items. To exit the dispenser GUI, use the Esc control.

By default, the GUI of a dispenser is labeled "Dispenser". A dispenser's GUI label can be changed by naming the dispenser in an anvil before placing it, or by using the data command^{[Java edition only]}. For example, to label a dispenser at (0,64,0) "My Dispenser", use data merge block 0 64 0 {CustomName:'"My Dispenser"'}.

A dispenser can be "locked" by setting the dispenser's Lock tag. If a dispenser's Lock tag is not blank, the dispenser cannot be accessed except by players holding an item with the same name as the Lock tag's text. A dispenser's Lock tag can be set or unset with the data command. For example, to lock a dispenser at (0,64,0) so that only players holding an item named "My Key" can access the dispenser, use data merge block 0 64 0 {Lock:"My Key"}.

Redstone component

See also: Redstone circuit

A dispenser can be used to dispense its contents randomly.

Activation

A dispenser is a redstone mechanism and can be activated by:

• an adjacent active power component: for example, a redstone torch (except that a redstone torch does not activate a dispenser it is attached to), a block of redstone, a daylight sensor, etc.
• an adjacent powered opaque block (for example, a block with an active redstone torch under it)
• a powered redstone repeater or redstone comparator facing the dispenser
• powered redstone dust configured to point at the dispenser, or on top of it, or a directionless "cross" next to it; a dispenser is not activated by adjacent powered redstone dust that is configured to point in another direction.

Some of these methods can activate a dispenser (in the sense of triggering an action) without powering the dispenser (in the sense of whether the dispenser can power adjacent Redstone dust, etc.).

In addition to the methods above, a dispenser can also be activated by quasi-connectivity.^{[Java edition only]} A dispenser becomes activated if one of the methods above would activate a mechanism component in the block above the dispenser, even if there is no mechanism component there (even if the block above the dispenser is air or a transparent block), but only when the dispenser receives a block update (including a Redstone update within two blocks of the dispenser). A dispenser does not activate if it has been less than 1 redstone tick (2 game ticks, or 0.1 seconds barring lag) since its last activation ended.

Behavior

When activated, a dispenser waits for 2 Redstone ticks (4 game ticks, or 0.2 seconds barring lag) and then ejects one item. The dispenser does not continue to eject items while activated; ejection occurs only on the initial activation (the rising edge of an input signal). To eject multiple items, repeatedly activate the dispenser with a clock circuit. If the clock runs at faster than 5 Hz (more than 5 redstone pulses a second), the dispenser fires once and then locks in the "on" position.

If multiple slots are occupied by items, a random occupied slot is chosen for ejection. The slot is chosen when an item is ejected, not when the dispenser is initially activated, thus it is possible to move items into or out of a dispenser between its activation and item dispensing.

The effects of being activated vary with the type of ejected item. Most items are thrown in the direction the dispenser is facing as if a player had used the Drop Item control. (Unlike a dropper, a dispenser can't feed another container.) Other items behave differently when dispensed:

Dispenser Behavior
Item	Effect
Armor Elytra	Equips on a player, armor stand, skeleton, wither skeleton, stray, zombie, husk, pillager, drowned, vindicator, villager, piglin or zombified piglin within the block the dispenser is facing with empty appropriate armor slot (any armor, made from any material).
Armor Stand	Placed as an entity in the block the dispenser is facing.[Java edition only]
Arrow Spectral Arrow Tipped Arrow	Fired in the direction the dispenser is facing.
Boat	Placed as an entity (i.e., a right-clickable vehicle) in the block the dispenser is facing, if the dispenser is facing the water or an empty block above water — otherwise dropped, which is unintentional.
Bone Meal	Uses bone meal (as fertilizer) on the block the dispenser is facing, if possible. If the block faced does not react to bonemeal, no bone meal is used.
Bottle o' Enchanting Egg Snowball Splash Potion Lingering Potion	Thrown in the direction the dispenser is facing as if the player had right-clicked the item in their inventory. Splash potions and lingering potions are fired farther.
Bucket	Collects lava or water source block the dispenser is facing, adding the newly filled bucket to an empty slot in the dispenser's inventory. If there isn't room in the dispenser for the newly-filled bucket (i.e. the empty bucket was part of a stack and all other slots in the dispenser are also full), drops the filled bucket. If no source block is in front of the dispenser, drops an empty bucket, which is unintentional.
Fire Charge	Launches fireball (as if produced by a blaze) in the direction the dispenser is facing. When a dispensed fireball hits a mob (including a player) or a block, the mob or block is set on fire. When a dispensed fireball hits a boat or minecart, the vehicle is destroyed and drops itself as an item.
Firework Rocket	Launches in the direction the dispenser is facing. It can be used to inflict damage if it was crafted with stars.
Flint and Steel	If the dispenser is facing an air block and having an available block below this air block, places fire in the air block and reduces the durability of the flint and steel. If the dispenser is facing TNT, it ignites the TNT, if facing to a obsidian frame, it ignites the Nether portal. Otherwise, does nothing.
Lava Bucket Water Bucket Cod Bucket Salmon Bucket Tropical Fish Bucket Pufferfish Bucket Powder Snow	Places lava or water in the block the dispenser is facing (replacing the lava or water bucket in the dispenser with an empty bucket) if the block the dispenser is facing is one that the player could use lava or water buckets on (e.g., air, flowers, grass, etc. — doesn't work with a cauldron) — otherwise dropped - not an intentional feature. Water dispensed in The Nether disappears instantly, leaving only the empty bucket in the dispenser. If the bucket contains a fish, the fish is spawned along with the block of water. Πρότυπο:INUpcoming, a dispenser can place or remove powder snow in the block in front of where the dispenser is facing.
Minecart Minecart with Chest Minecart with Command Block Minecart with Furnace Minecart with Hopper Minecart with TNT	Placed as an entity (i.e., a right-clickable vehicle) in the block the dispenser is facing, if the dispenser is facing a type of rails — otherwise dropped - not intentional.
Heads Carved Pumpkin	If placement completes the construction of an iron golem, snow golem, or wither, the entity is created as if constructed by a player. Equips on a player, mob or armor stand with an empty helmet slot, within the block the dispenser is facing. Otherwise, does nothing.
Shulker Box	Placed as a block.
Spawn Egg	Summons a mob in front of the dispenser.
TNT	Places and ignites TNT in the block the dispenser is facing, with a small velocity in a random direction.
Trident	Thrown in the direction the dispenser is facing.[Bedrock edition only]java Combat Tests
Shears	Shear any sheep, snow golem [Java edition only], or mooshroom[Java edition only] that is in the block in front of it. Harvests honeycombs from a full beehive or nest.
Glass Bottle	Fills bottle with water if the dispenser is facing a water source block. Fills the bottle with honey if the dispenser is facing a full beehive or bee nest. If cannot be used, the item is dropped, which is both intentional and not intentional.
Horse Armor	Place horse armor on any tamed horse that is in the block in front of it.[Java edition only]
Saddle	Place a saddle on any pig, tamed horse, donkey, mule or strider that is in the block in front of it.[Java edition only]
Carpet	Place a carpet on any tamed llama that is in the block in front of it.[Java edition only]
Chest	Place a chest on any tamed llama, donkey, or mule that is in the block in front of it.[Java edition only]
Glowstone	Charges any empty or partially filled respawn anchor. If facing a full respawn anchor, it does nothing.
Honeycomb	Wax any copper block that is in the block in front of it. java 1.17
Others	Dropped: Ejected toward the block the dispenser is facing as if a player had used the Drop Item control.

When a dispenser dispenses an item, it emits a clicking sound (unless the item is a projectile or a spawn egg) and a smoke particle. If it is empty when activated, it emits a slightly higher-pitched click. The noise of a dispenser can be heard up to 16 blocks away.

A dispenser is a full solid opaque block, so powering it directly can cause adjacent mechanism components (including other dispensers) to activate as well.

Sounds

Unique

Java Edition: Πρότυπο:Sound table Πρότυπο:Sound table Πρότυπο:Sound table

Data values

ID

Πρότυπο:Edition:

Icon	Dec	Hex	Name	Block
	0	0		(unused)

Icon	Dec	Hex	Name	Block
	1	1		(unused)

Πρότυπο:Edition:

Icon	Dec	Hex	Name	Block
	2	2		(unused)

Icon	Dec	Hex	Name	Block
	3	3		(unused)

Metadata

See also: Data values

Πρότυπο:IN, a dispenser uses its block data field to store its orientation and activation status:

Bits	Values
0x1 0x2 0x4	Three bits storing a value from 0 to 5: 0: Dispenser facing down 1: Dispenser facing up 2: Dispenser facing north 3: Dispenser facing south 4: Dispenser facing west 5: Dispenser facing east
0x8	If set, the dispenser is activated.

Block states

See also: Block states

Name	Value	Description
facing	north south east west up down	The direction the dispenser will dispense its contents. The opposite from the direction the player faces while placing the dispenser.
triggered	true false	True if the dispenser is activated.

Block data

See also: Block entity format

A dispenser has a block entity associated with it that holds additional data about the block.

• Block entity data
  • Tags common to all block entities see Template:Nbt inherit/blockentity/template
  •  CustomName: Optional. The name of this container, which will display in its GUI where the default name ordinarily is.
  •  Lock: Optional. When not blank, prevents the container from being opened unless the opener is holding an item whose name matches this string.
  •  Items: List of items in the container.
    • : An item, including the slot tag. Dispenser slots are numbered 0-8 with 0 in the top left corner.
      • Tags common to all items see Template:Nbt inherit/item/template
  •  LootTable: Optional. Loot table to be used to fill the dispenser when it is next opened, or the items are otherwise interacted with.
  •  LootTableSeed: Optional. Seed for generating the loot table. 0 or omitted will use a random seed.

History

java beta
1.2				Added dispensers.
				The top and bottom textures of dispensers currently remain fixed regardless of the facing direction.
java
1.0.0		Beta 1.9 Prerelease 6		Dispensers now take much shorter to destroy, and the breaking time is now tier dependent.
1.2.1		12w03a		Dispensers are now able to spawn mobs from a spawn egg.
		12w04a		The texture of dispensers has been changed.
1.3.1		12w15a		Dispensers can now place boats and minecarts.
		12w21a		Dispensers can now shoot the liquids inside water and lava buckets.
				Dispensers can now suck up liquids if activated again, filling up the buckets with the liquid dropped.
		12w22a		Dispensers can now naturally generate within jungle temples and are filled with a random amount of arrows that shoot the player should they touch the tripwire connected to it or destroy it without shears.
January 18, 2013				Dinnerbone stated that dispensers are to have more features in the future, so players should stick to using droppers to dispense items.
1.5		13w04a		Dispensers can now face all 6 directions.
				Dispensers now use many new items. These items include TNT, bone meal, flint and steel and armor.
		13w10b		Powered dispensers no longer fire if they receive a redstone update.
1.8		14w04a		Dispensers can now be used to place pumpkins to activate iron golems and snow golems.
				Dispensers can now place wither skeleton skulls to activate the wither.
		14w07a		Dispensers can now place command blocks instead of shooting them out.
		14w10a		Upwards facing dispensers now have a missing model.
		14w10b		Upwards facing dispensers now have a valid model again.
		14w25a		The models of dispenser have been changed - the top and bottom faces for horizontal dispensers now rotate accordingly, and are rotated for downwards facing.
1.8.6				Dispensers no longer place command blocks, as it constituted a vulnerability.
1.9		15w33a		Dispensers can now shoot splash potions and lingering potions much farther than before.
		15w33c		Dispensers can now shoot fire charges as ender dragon fireballs, instead of as blaze fireballs.
		15w39c		Dispensers can now equip mob heads and pumpkins.
		15w44b		Dispensers can now once again shoot fire charges as blaze fireballs.
1.9.1		pre1		Dispensers can now use loot tables.
				Dispensers generated in jungle temples now use loot tables.
1.10		16w21a		Dispensers can now equip shields, like armor.
1.11		16w32a		The block entity ID for dispensers has been changed from Trap to dispenser.
		16w39c		Dispensers can now dispense boats facing the same way as the dispenser, instead of toward the dispenser.
1.13		17w47a		Crafting a dispenser no longer requires the bow to be at full durability.
				Prior to The Flattening, this block's numeral ID was 23.
1.14		18w43a		The textures of the dispenser have been changed.
				Dispensers with shears in them now shear sheep with wool.
1.15		19w34a		Dispensers can now harvest honeycombs when dispensing shears on bee nests and bee hives filled with honey.
				Dispensers can now collect honey bottles when dispensing glass bottles on bee hives.
				Dispensers can now collect water bottles when dispensing glass bottles on water.
		19w36a		Fireworks dispensed from a dispenser now travel in the direction fired.
		19w41a		Dispensers now eject empty bottles properly when not facing water.
		19w42a		Dispensers can now place armor stands.
1.16		20w15a		Dispensers can now saddle pigs, striders and tamed horses, donkeys and mules.
				Dispensers can now put horse armor on horses.
				Dispensers can now put carpets on llamas.
				Dispensers can now put chests on llamas, donkeys, and mules.
				Dispensers can now shear a Mooshroom.
				Dispensers can now shear snow golems.
Upcoming Java
1.17		20w46a		Can now place powder snow using a powder snow bucket. Also can remove it using a bucket.
		21w11a		Dispensers can now dispense honeycomb onto copper blocks to wax them.
Pocket Edition Alpha
v0.14.0		build 1		Added dispensers.
		build 5		The inventory for dispensers is now more consistent with other inventories.
v0.15.0		build 1		Dispensers can now be moved by pistons.
bedrock
1.10.0		beta 1.10.0.3		The textures of the dispenser have been changed.
				Dispensers with shears in them now shear sheep with wool.
1.13.0		?		Damaged bows can no longer be used to craft dispensers.
1.14.0		beta 1.14.0.1		Dispensers can now harvest honeycombs when dispensing shears on bee nests and bee hives filled with honey.
				Dispensers can now collect honey bottles when dispensing glass bottles on bee hives.
				Dispensers can now collect water bottles when dispensing glass bottles on water.
1.16.0		beta 1.15.0.51		Crafting a dispenser no longer requires the bow to be at full durability.
1.16.210		beta 1.16.210.57		Dispensers can now wax copper blocks.
Console Edition
TU1	CU1	1.0	Patch 1	Added dispensers.
TU3				The dispenser texture has been changed to the Java Edition 1.2.1 (12w04a) texture.
TU5				Added quick move to the dispenser.
TU9				Dispensers are now able to spawn mobs from a spawn egg.
				Dispensers can now shoot out the liquids inside water and lava buckets.
				Dispensers can now suck up the liquids if activated again, but do not fill up the buckets with the liquid dropped due to a bug.
TU10				The bug where the liquid from dispensers did not properly fill empty buckets has been fixed.
TU19	CU7	1.12		Dispensers can now face in any direction.
TU31	CU19	1.22	Patch 3	Dispensers can now place pumpkins or wither skeleton skulls to spawn golems and withers providing the body is already built in a valid configuration.
Ps4
1.90				The textures of the dispenser have been changed.
				Dispensers with shears in them now shear sheep with wool.
3ds
0.1.0				Added dispensers.

• 

  The first image released by Mojang showing the new placement of Dispensers and Droppers. The Dispenser can be seen on the top.

Issues

Issues relating to “Dispenser” are maintained on the issue tracker. Report issues there.

Trivia

• A dispenser was shown inside a minecart in one of the 1.5 teaser images, although this was never added to the game.

• Dispensers resemble a face when not facing up or down.

Gallery

• 

  Dispensers can be placed facing up and down, as well as the side orientation.

• 

  A distribution of arrows shot straight up by a dispenser.

See also

Some other blocks can also be used to move items:

• Droppers can throw items or push them into adjacent containers.
• Hoppers can push items into adjacent containers.
• Ice and packed ice have reduced friction to the item entity movement.
• Slime blocks can impart velocity to item entities when pushed by a piston.
• Water can push item entities.
• Quasi-connectivity Applies to Dispensers.

References

Blocks

View at: Template:Blocks/content [edit]