View source for Minecraft:Debug Stick

{{for||Debug|Stick (disambiguation)}}
{{Exclusive|java}}
{{Infobox item
| image = Debug Stick.gif
| rarity =
* Epic {{only|java|short=1}}
* Common {{only|bedrock|short=1}}
| renewable = No
| stackable = No
}}

The '''debug stick''' is an [[Minecraft:item]] used to edit the block states of [[Minecraft:block]]s. It is visually identical to a regular [[Minecraft:stick]], but with a glint (as if enchanted).

== Obtaining ==
{{IN|je}}, the debug stick is obtainable via [[Minecraft:commands]] such as {{cmd|/give}} or {{cmd|/item}}, or the [[Minecraft:Creative inventory]] if the player has the appropriate permissions. It can be obtained only in worlds with commands on.

{{IN|be}}, this item only exists in internal versions and privately released versions.

== Usage ==
The debug stick can be used to change block states. {{control|Hitting}} the block allows players to select the block state key they wish to change. For example, switching between the ''conditional'' and the ''facing'' block state keys for a command block. {{control|Using}} the block allows them to cycle through the valid values for the block state key, again as an example, the player can make the command block face, ''down'', ''east'', ''north'', ''south'', ''up'', or ''west'' if they chose the ''facing'' block state key. {{control|Sneaking}} while {{control|hitting}} or {{control|using}} cycles through the block state keys or values in reverse order.

It is notable that {{Control|using}} debug stick directly on an interactive block without {{Control|sneaking}} uses the block itself instead of the stick.<ref>{{bug|MC-200199||Right-Clicking on an Interactive Block with Debug Stick Uses the Block Instead of Changing Its States if Not Holding Shift|Invalid}} </ref>

The debug stick cannot be used while in Survival or Adventure mode. It works only in Creative mode with cheats enabled. In modes other than Creative, it acts like a regular item — although when {{control|using}} it on a block, the player swings the stick as if interacting with it (but nothing happens).

== Data values ==
=== ID ===
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Debug Stick
|spritetype=item
|nameid=debug_stick
|form=item
|foot=1}}

=== Item data ===
{{see also|Data component format}}
<div class="treeview">
* {{nbt|compound|components}}: the item's '''components''' tag.
{{:Data component format/debug_stick_state}}
</div>

== History ==
=== ''Java Edition'' ===
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||1.13|dev=17w47a|[[File:Debug Stick.gif|32px]] Added debug sticks.}}
|{{HistoryLine||1.16|dev=20w10a|Debug sticks are now capable of editing [[Minecraft:fire]] due to its added hitbox.}}
|{{HistoryLine||1.17|dev=21w20a|The rarity of debug sticks has been changed from "Common" to "Epic".}}
|{{HistoryLine||1.19.3|dev=22w44a|The debug stick is now available in the Creative inventory, but only if cheats are enabled.}}
|{{HistoryLine|||dev=22w45a|Moved the debug stick behind the Operator Utilities tab in the Creative inventory. The tab is only available if cheats are enabled and the "Operator Items Tab" option in the controls menu is turned on.}}
}}

=== ''Bedrock Edition'' ===
{{HistoryTable
|{{HistoryLine|bedrock}}
|{{HistoryLine||1.14.0|dev=beta 1.14.0.1|[[File:Debug Stick.gif|32px]] By this point, the debug stick had been added to private developer versions, but was not available in any public version.}}
}}

== Issues ==
The debug stick is not supported, and any issues resulting of its usage are closed as "Won't Fix" in the issue tracker.<br/> Issues with the stick itself are considered valid.<ref>https://bugs.mojang.com/browse/MC-122323?focusedCommentId=419481&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-419481</ref><ref>{{reddit|7es23r||Just be aware that any weird state you create with it you cannot naturally create and any bugs that come from it will be shot down as 'Wont fix' :D|_Grum|November 22, 2017}}</ref>

{{issue list|projects=mc}}

== Trivia ==
*An [[Minecraft:add-on]] made by Mineplex was showcased in MINECON Live 2019, which had an editor stick for {{el|be}}, similar to the Debug Stick.<ref>{{ytl|OZqNaEX8208|MINECON Live 2019 @ 1:05:02|Minecraft|September 28, 2019|t=3902}}</ref>

== Gallery ==
=== In other media ===
<gallery>
Technically Updated.jpg|Artwork of Steve and Alex wielding debug sticks.
</gallery>

== See also ==
*Block states

== References ==
{{Reflist}}

== Navigation ==
{{Navbox items|Creative}}

de:Debug-Stab
es:Palo de desarrollo
fr:Bâton de débogage
ja:デバッグ棒
ko:디버그 막대기
lzh:勘誤棍
pl:Patyk debugujący
pt:Graveto de Depuração
ru:Палка отладки
uk:Палиця налагодження
zh:调试棒