View source for Minecraft:Debug hotkey

{{about|the hotkey|other uses|Debug}}
{{exclusive|java}}
[[File:Debug controls.png|thumb|The list of debug keybinds as shown in-game under {{UI|[[Options]]|Controls|Key Binds}}.]]
A '''debug hotkey''' (or '''key binding''' in game) is used to access hidden information and trigger advanced settings in the game through {{Keys|F3 + ''<key>''}}, where ''key'' is usually a letter (A&ndash;Z), or just a single {{Key|F3}}, which is used to open the [[Minecraft:debug screen]]. When {{Key|F3}} is used as a modifier for debug hotkey combination, the debug screen is not opened (or closed if enabled).

The list for debug hotkeys can be viewed and changed under the "Debug" section of {{UI|[[Minecraft:Options]]|Controls|Key Binds}}.

Some debug hotkeys may be disabled by {{gmr|reduced_debug_info}} game rule.

__TOC__
{{clear}}
== List of debug hotkeys ==
{| class="wikitable"
! Default key bind
! In-game name
! Description
|-
| {{Key|F3}} (toggle)
| Toggle Overlay
| Toggles the [[Minecraft:debug screen]].
|-
| {{Key|F3}} (modifier)
| Debug Modifier Key
| Used as a modifier for all {{Keys|F3 + <key>}}-based debug hotkeys.
|-
| {{Keys|F3 + A}}
| Reload [[Minecraft:Chunk]]s
| &mdash;
|-
| {{Keys|F3 + B}}
| Show [[Minecraft:Hitbox]]es
| Toggles the {{cd|entity_hitboxes}} [[Minecraft:debug renderer]].

''Disabled by {{cd|reduced_debug_info}} gamerule.''
|-
| {{Keys|F3 + C}}
| Copy Location
| Copies current location data with the format {{Cmd|execute in <dimension> run tp @s <position> <rotation>}}.

''Disabled by {{cd|reduced_debug_info}} gamerule.''
|-
| {{Keys|F3 + C}} (hold)
| Debug [[Minecraft:Crash]]
| When the players hold the key combination for 10 seconds (8 seconds countdown), it [[Minecraft:crash]]es the game with the code -1, caused by an exception.{{note|Specifically, it was caused by {{jcp|java.lang.Throwable}} class.}}

In the game log, the exception has a message of "Manually triggered debug crash" followed by "Reported exception thrown!" and other reported chat messages (including the crash countdown).
|-
| {{Keys|F3 + D}}
| Clear Chat
| Retains typed messages accessible through {{Keys|Up}}/{{Keys|Down}}
|-
| {{Keys|F3 + G}}
| Show Chunk Boundaries
| Toggles the {{cd|chunk_borders}} [[Minecraft:debug renderer]].

''Disabled by {{cd|reduced_debug_info}} gamerule.''
|-
| {{Keys|F3 + H}}
| Show Advanced [[Minecraft:Tooltip]]s
| Shows additional information on the item [[Minecraft:tooltip]]s:
* item [[Minecraft:Java Edition data values|identifier]]s,
* tool and armor durability as a fraction on damaged items,
* [[Minecraft:Dye#Dyeing armor|armor color]],
* map scale, and
* details of what type [[Minecraft:firework]] is loaded in a [[Minecraft:crossbow]].
|-
| {{Keys|F3 + I}}
| Copy Data
| Copies entity or block data with the format {{Cmd|summon <entity_type> <position> {[Data, eg. OnGround: 0b, Air: 300s]} }}. Alternatively, the {{Keys|F3 + ⇧ Shift + I}} combination copies the client-side data, which often returns the same values as {{Keys|F3 + I}}.

''Disabled by {{cd|reduced_debug_info}} gamerule.''
|-
| {{Keys|F3 + L}}
| Start/Stop Profiling
| See [[Minecraft:performance metrics]].{{info needed|Maybe related to Jave Flight Recorder, see [[Minecraft:Commands/jfr]]}}
|-
| {{Keys|F3 + N}}
| Cycle Spectator
| Toggles [[Minecraft:Spectator]] mode and previous game mode.
|-
| {{Keys|F3 + P}}
| Toggle Lost Focus Pause
| Toggles automatic pause when the game loses focus, or not selected as the primary window.
|-
| {{Keys|F3 + S}}
| Dump Dynamic Textures
| All loaded [[Minecraft:dynamic textures]] are exported to {{cd|[[Minecraft:.minecraft]]/screenshots/debug}} as image files alongside associated text metadata where necesary.
|-
| {{Keys|F3 + T}}
| Reload [[Minecraft:Resource Pack]]s
| Reloads the changes from adding and removing resource packs in the <code>[[Minecraft:.minecraft]]/resourcepacks</code> folder (either by drag and drop in a file explorer, or activating and deactivating certain packs on {{UI|[[Minecraft:Options]]|Resource Packs}} settings). This is useful for reloading resource packs without having to restart the game.
|-
| {{Keys|F3 + V}}
| Dump Version Info
| Presents the client's game version information, in the order of the version's ID, the version's name, [[Minecraft:data version]], series, [[Minecraft:protocol version]], build time, [[Minecraft:Pack format|resource pack and data pack formats]], and whether the version is stable or not. Further information on [[Minecraft:version.json]].
|-
| {{Keys|F3 + 1}}
| Profiling Chart
| Toggles the [[Minecraft:Debug screen#Profiler graph|profiling chart]] in debug screen.
|-
| {{Keys|F3 + 2}}
| FPS Charts
| Toggles the [[Minecraft:Debug screen#FPS graph|FPS charts]] in debug screen.
|-
| {{Keys|F3 + 3}}
| Network Charts
| Toggles multiple [[Minecraft:Debug screen#TPS graph|network charts]] (such as TPS, bandwidth, and ping graph) in debug screen.
|-
| {{Keys|F3 + Esc}}
| N/A
| Pause without [[Minecraft:pause menu]]. Only works on singleplayer.

''Not available as a configurable key binding.''
|-
| {{Keys|F3 + F4}}
| Game Mode Switcher
| Opens the [[Minecraft:game mode switcher]], and selects last used game mode.
|-
| {{Keys|F3 + F6}}
| Debug Options
| Opens the [[Minecraft:debug options]] screen, which allows the player to customize the debug screen.
|}

=== Disabled hotkeys ===
These hotkeys are disabled by default, but can be enabled using the <code>-DMC_DEBUG_HOTKEYS</code> [[Minecraft:debug property]].
{| class="wikitable"
|-
! Hotkey
! Info
|-
| {{keys|F3 + E}}
| Toggles the <code>chunk_section_paths</code> [[Minecraft:debug renderer]].
|-
| {{keys|F3 + O}}
| Toggles the <code>chunk_section_octree</code> debug renderer.
|-
| {{keys|F3 + V}}
| Toggles the <code>chunk_section_visibility</code> debug renderer.
|-
| {{keys|F3 + W}}
| Toggles wireframe rendering.
|-
| {{keys|F3 + L}}
| Toggles "smart culling" that culls individual [[Minecraft:chunk|chunk sections]].
|-
| {{keys|F3 + U}}
| Locks the [[Minecraft:w:Viewing_frustum|viewing frustum]] used for culling in place and makes it visible.
|-
| {{keys|F3 + Shift + U}}
| Unlocks and hides the viewing frustum.
|-
| {{keys|F3 + F}}
| Toggles [[Minecraft:fog]].
|}

== History ==
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||1.4.2|dev=12w41a|{{key|F3+H}} was added to show [[Minecraft:durability]] on damaged tools, weapons and armor pieces.}}
|{{HistoryLine||1.4.4|dev=1.4.3|{{key|F3+B}} now toggles the "entity hitboxes" [[Minecraft:debug renderer]].}}
|{{HistoryLine||1.8|dev=14w29a|The {{cd|reducedDebugInfo}} game rule allows the server [[Minecraft:operator]]s to disable certain hotkeys or reduce some information being shown.}}
|{{HistoryLine||1.9|dev=15w32a|{{key|F3+N}} was added to toggle between [[Minecraft:Creative]] and [[Minecraft:Spectator]] modes, when the [[Minecraft:player]] is in either of them. The player needs to be allowed to use {{Command|gamemode}} for this to work.}}
|{{HistoryLine|||dev=15w43a|[[File:Debug hotkey F3+Q.png|50px]] {{keys|F3+Q}} was added, which gives help and shows all {{key|F3}} + key combinations.
|{{keys|F3+F}} was added to increase render distance by 1 (Minimum and Maximum are 2-32).
|{{keys|F3+Shift+F}} was added to decrease render distance by 1 (Min and Max are 2-32).
|The debug screen now does not open when the player uses a specific key combination like {{keys|F3+N}}, {{keys|F3+B}}, etc.
|{{keys|F3+S}} (which previously reloaded sounds) has been removed.
|{{keys|F3+T}} now reloads all [[Minecraft:resource pack]] content, including [[Minecraft:sound]]s.}}
|{{HistoryLine||1.10|dev=16w20a|{{keys|F3+G}} now toggles the "chunk borders" debug renderer.}}
|{{HistoryLine||1.13|dev=18w11a|Pressing {{keys|F3+C}} now copies the player's current location to the clipboard in the form of a {{cmd|tp}} command. Holding for 10 seconds and releasing still forces a debug crash.}}
|{{HistoryLine|||dev=18w14a|The debug screen now gives a warning before forcing a debug crash via {{keys|F3+C}}.}}
|{{HistoryLine|||dev=pre6|{{key|F3+I}} was added to copy block or entity data to the clipboard.}}
|{{HistoryLine|||dev=pre7|{{key|F3+I}} has been changed to now be {{key|Shift+F3+I}}. It is now clarified that it copies the client-side data of targeted block or entity. It still can be used by anyone.
|Added {{key|F3+I}} to copy targeted block or entity server-side data to clipboard. It can be used only by [[Minecraft:operator]]s.}}
|{{HistoryLine||1.13.1|dev=18w30a|Added {{keys|Control+F3+C}} to force a JVM crash, instead of a regular crash.}}
|{{HistoryLine||1.14.1|dev=Pre-Release 1|Pressing {{key|F3+Esc}} now toggles pause without pause menu (if pausing is possible).
|Pressing {{key|F3+N}} when in Survival or Adventure mode now changes the player into Creative mode, if cheats are enabled.}}
|{{HistoryLine||1.15.2|dev=Pre-Release 1|{{key|F3+D}} no longer clears recently typed messages and commands from {{key|UP}} and {{key|DOWN}}.}}
|{{HistoryLine||1.16|dev=20w20a|Added game mode switcher accessible with {{key|F3+F4}}.
|{{key|F3+N}} now toggles between Spectator mode and the previous game mode.}}
|{{HistoryLine||1.17|dev=21w11a|Added {{key|F3+L}} to generate [[Minecraft:performance metrics]].}}
|{{HistoryLine||1.19|dev=22w12a|Removed the {{key|F3+F}} and {{key|F3+Shift+F}} hotkeys that change render distance.}}
|{{HistoryLine||1.19.4|dev=Pre-release 3|Pressing {{key|F3+S}} now dump contents of [[Minecraft:dynamic textures]] (like atlases, maps, etc.) to {{cd|[[Minecraft:.minecraft]]/screenshots/debug}}.}}
|{{HistoryLine||1.21.6|dev=25w15a|Added {{key|F3+V}} which prints client side version information.}}
|{{HistoryLine||1.21.9|dev=25w31a|Added {{key|F3+F5}} hotkey to access debug screen options menu.}}
|{{HistoryLine||1.21.9|dev=Pre-Release 4|Changed hotkey to access debug screen options menu to {{key|F3+F6}}.}}
|{{HistoryLine||1.21.11|dev=25w41a|Removed the {{key|F3+Q}} hotkey.}}
}}

== Issues ==
{{issue list|debug hotkey|debug key binding|F3|projects=MC}}

== Gallery ==
<gallery>
Game mode switcher.png|Game mode switcher ({{Keys|F3 + F4}})
F3 + C Crash Alert.png|Screenshot of the crash alert given in the chat while holding {{keys|F3+C}}.
Debug Options.png|Debug options ({{keys|F3 + F6}})
</gallery>

== Notes ==
<references group="note"/>

== Navigation ==
{{Navbox Java Edition technical|general}}

[[Minecraft:fr:Raccourci clavier de débogage]]