minecraft.wiki-mirror/wiki_backup/debug screen.txt

{{about|the screen|other uses|Debug}}
{{exclusive|java}}
{{update|1.20.2 debug screen changes}}

[[File:DebugScreen.png|thumb|Screenshot showing the debug information]]

The '''debug screen''' (Commonly also "F3" or "F3 screen") is triggered when {{key|F3}} is pressed. It functions as a menu for accessing debugging information, but it also provides useful in-game information like [[Coordinates|player coordinates]]. 

The debug screen consists of info text lines and three toggleable graphs: The profiler, frame time, and server performance graphs.

== Graphs ==
{| class="wikitable"
|+
!Name(s)
!Profiler graph
!FPS graph
!TPS graph
!Bandwidth graph
!Ping graph
|-
|Image
|[[File:F3 Profiler Graph.png|center|frameless|width=227x227]]
|[[File:F3 Frametime Graph.png|center|frameless]]
|[[File:TPS.png|center|frameless|width=262x262]]
|[[File:F3 Bandwith Graph.png|center|frameless]]
|[[File:F3 Ping Graph.png|center|frameless]]
|-
|Toggle Keybind
|{{key|F3+1}}
|{{key|F3+2}} (Left)
|{{key|F3+2}} (Right)
|{{key|F3+3}} (Left)
|{{key|F3+3}} (Right)
|-
|Description
|Displays profiling information. To access a sub-section, press Shift + the section number (in square brackets).
|Shows the last 240 frames. Higher is slower. 
The minimum, average, and maximum frame times for the last 240 ticks are shown on top.
|Shows the last 240 ticks. Higher is slower. 
The minimum, average, and maximum tick times for the last 240 ticks are shown on top.
This graph is not accessible for [[Commands/op|non-OP]] players on a ''server''.
|Shows the last 240 packets. Higher is larger. The minumum, average, and maximum size is shown on top, typically in KiB.
|Shows the last 240 ping times. Higher is longer time. The minimum, average and maximum are shown on top. 
|-
|Colors
| -
|The colors are on a gradient from neon green (good) (#00FF00) to neon red (bad) (#FF0000). 
First red is added, when red is at FF, green is reduced.
|The colors stack. From top to bottom

*Green/yellow/red - Idling (Color represents tick time - see FPS graph)
* Purple: Miscellanious.
* Beige: Scheduled tasks
* Burgundy - Main logic of the server
|The colors are cyan for small packets and light purple for larger ones.
|The colors are on a gradient from neon green (good) (#00FF00) to neon red (bad) (#FF0000). 
First red is added, when red is at FF, green is reduced.
|}

== Info Lines ==
The debug screen is split into two parts, displayed on either side of the screen.

=== Left side ===
The left side of the debug screen contains information about the game.

{| class="wikitable" data-description="Legend"
|-
! style="width: 25%" | Line format
! Description
! Visible with [[Game rule|reduced debug info]]
|-
! colspan="3" | First paragraph
|-
| Minecraft ''version'' (''version''/vanilla/snapshot)
| General information about the game:
* ''version'' is the current [[Java_Edition_version_history|version]];
* If the game is [[mod]]ded, "vanilla" is replaced with the mod or mod loader name;
* "/snapshot" is present for snapshots, pre-releases and release candidates.
| {{tc|yes}}
|-
| ''fps'' fps T: ''max'' vsync ''graphics'' ''clouds'' B: ''blend'' GPU: ''gpu''
| General information about the renderer:
* ''fps'' is the current framerate;
* ''max'' is the value of the Max Framerate option ("inf" if Unlimited);
* "vsync" is present if the VSync option is on;
* ''graphics'' is the value of the [[graphics]] option:
** "fast" if Fast,
** "fancy" if Fancy,
** "fabulous" if ''Fabulous!'';
* ''clouds'' is the value of the clouds option:
** "fast-clouds" if Fast,
** "fancy-clouds" if Fancy,
** Hidden if OFF;
* ''blend'' is the current biome blend transition;{{Verify}}
* ''gpu'' is the GPU utilization percentage.
| {{tc|Yes}}
|-
| ''brand'' server @ ''mst'' ms, ''up'' tx, ''down'' rx
| Information about the [[server]]:
* ''brand'' is the server brand ("Integrated" for [[singleplayer]] world);
* ''mst'' is present only on single player worlds and corresponds to the time it takes for a [[game tick]] to be processed on the integrated server;
* ''up'' is the average number of packets sent by the client during a game tick;
* ''down'' is the average number of packets received by the client during a game tick.
| {{tc|Yes}}
|-
| C: ''sections'' (s) D: ''distance'', pC: ''batch'', pU: ''uploads'', aB: ''buffers''
| Information about loaded [[chunk]]s:
* ''sections'' is the number of [[section]]s rendered over the total number of sections in the loaded area;
* "(s)" is present if smart culling is enabled, which is always the case in vanilla;
* ''distance'' is the effective client-side render distance, that is, the value of the [[render distance]] option or the [[Server.properties#view-distance|server view-distance]], whichever is less;
* ''batch'' is the number of pending chunks to be batched;
* ''uploads'' is the number of pending uploads to the video card;
* ''buffers'' is the number of available buffers to use in the batching process.
| {{tc|Yes}}
|-
| E: ''entities / total entities'', B: 0, SD: ''distance''
| Information about loaded [[entities]]:
* ''entities'' is the number of entities in your [[field of view]] (FOV)
* ''total entities'' is the number of entities in the loaded area.
* The "B" value is unused and always 0<ref group="note" name="B">Possibly the number of entities removed due to hidden chunks, hence is intended to be removed as being redundant.</ref>;
* ''distance'' is the server's [[simulation distance]].
| {{tc|Yes}}
|-
| P: ''particles''. T: ''total'' ''entities''
| Miscellaneous information:
* ''particles'' is the number of particles in the loaded area;
* ''total entities'' is the number of entities in the loaded area.
| {{tc|Yes}}
|-
| Chunks[C] W: ''cached'', ''loadedC'' E: ''loadedE'',''sections'',''ticking''
| Information about client-side chunks:
* ''cached'' is the number of cached chunks;{{verify|See net.minecraft.client.multiplayer.ClientChunkCache#gatherStats}}
* ''loadedC'' is the number of loaded chunks;
* ''loadedE'' is the number of loaded entities;
* ''sections'' is the number of entity sections;{{verify|What does this mean? See net.minecraft.world.level.entity.TransientEntitySectionManager#sectionStorage}}
* ''ticking'' is the number of entity ticking chunks.{{verify|Almost sure for this one}}
| {{tc|Yes}}
|-
| Chunks[S] W: ''chunks'' E: ''entities'',''visible'',''sections'',''chunks'',''ticking'',''load'',''unload''
| Information about server-side chunks (integrated server only):
* ''chunks'' is the number of loaded chunks;
* ''entities'' is the number of registered entities;
* ''visible'' may be the number of ticking entities;{{verify|See net.minecraft.world.level.entity.PersistentEntitySectionManager#visibleEntityStorage}}
* ''sections'' is the number of entity sections;{{verify|What does this mean? See net.minecraft.world.level.entity.PersistentEntitySectionManager#sectionStorage}}
* ''chunks'' may be the number of loaded (or loading) chunks;{{verify|See net.minecraft.world.level.entity.PersistentEntitySectionManager#chunkLoadStatuses}}
* ''ticking'' is the number of ticking or tracked chunks;{{verify|What does "tracked" mean? See net.minecraft.world.level.entity.PersistentEntitySectionManager#chunkVisibility}}
* ''load'' is the number of chunks that are waiting to be loaded;
* ''unload'' is the number of chunks that are waiting to be unloaded.
Made in mind for [[Tutorial:Setting up a LAN world|LAN connection]]s for server caching.{{verify}}
| {{tc|No}}
|-
| ''dimension'' FC: ''forced''
| Information about the current [[dimension]]:
* ''dimension'' is the [[resource location]] of the current dimension;
* ''forced'' is the amount of [[Commands/forceload|force loaded]] chunks.
| {{tc|No}}
|-
! colspan="3" | Second paragraph
|-
| XYZ: ''x'' / ''y'' / ''z''
| The player's location:
* ''x'' is the player's location in blocks East of the origin (negative values are to the West);
* ''y'' is the player's feet [[altitude]] in blocks;
* ''z'' is the player's location in blocks South of the origin (negative values are to the North).
| {{tc|No}}
|-
| Block: ''coordinates'' [''relative'']
| The location of the block the player's feet are in:
* ''coordinates'' is the coordinates of the block in the world;
* ''relative'' is the coordinates of the block within its [[section]].
| {{tc|No}}
|-
| Chunk-relative: ''relative''
| The location of the block the player's feet are in relative to the section:
* ''relative'' is the coordinates of the block within its section.
| {{tc|Yes|{{tooltip|Only reduced|Only visible with reduced debug info}}}}
|-
| Chunk ''coordinates'' [''relative'' in ''file'']
| The location of the section the player's feet are in:
* ''coordinates'' is the coordinates of the section (in sections, meaning section ''x'' ''y'' ''z'' contains the block 16''x'' 16''y'' 16''z'');
* ''relative'' is the coordinates of the chunk (without the vertical component) within its [[region]];
* ''file'' is the name of the file in which the chunk is stored.
| {{tc|No}}
|-
| Facing ''direction'' (toward ''axis'') (''yaw''/''pitch'')
| The orientation of the player:
* ''direction'' is the cardinal direction the player is facing;
* ''axis'' is the horizontal axis and the direction along this axis that the player is looking toward ("negative Z", "positive Z", "negative X", or "positive X");
* ''yaw'' is the player's [[Wikipedia:Aircraft principal axes|yaw]], 0 meaning facing South (positive is to the West, negative is to the East);
* ''pitch'' is the player's [[Wikipedia:Aircraft principal axes|pitch]], 0 meaning looking horizontally (positive is down, negative is up).
|{{tc|No}}
|-
| Client Light: ''light'' (''skylight'' sky, ''blocklight'' block)
| The client-side light values at the player's feet:
* ''light'' is the total [[light level]] (maximum of the [[Light#Sky light|sky light level]] and [[Light#Block light|block light level]], not to be confused with the [[Light#Internal light level|internal light level]]);
* ''skylight'' is the sky light level;
* ''blocklight'' is the block light level.
| {{tc|No}}
|-
| CH S: ''[[Heightmap#WORLD_SURFACE|WORLD_SURFACE]]'' M: ''[[Heightmap#MOTION_BLOCKING|MOTION_BLOCKING]]''
| The values of the corresponding client-side [[heightmap]]s at the player's position.
| {{tc|No}}
|-
| SH S: ''WORLD_SURFACE'' O: ''[[Heightmap#OCEAN_FLOOR|OCEAN_FLOOR]]'' M: ''MOTION_BLOCKING'' ML: ''[[Heightmap#MOTION_BLOCKING_NO_LEAVES|MOTION_BLOCKING_NO_LEAVES]]''
| The values of the corresponding server-side [[heightmap]]s at the player's position.
| {{tc|No}}
|-
| Biome: ''biome''
| The [[biome]] at the player's position:
* ''biome'' is the [[resource location]] of the biome.
| {{tc|No}}
|-
| Local Difficulty: ''difficulty'' // ''clamped'' (Day ''day'')
| [[Regional difficulty]]-related values:
* ''difficulty'' is the regional difficulty in the chunk the player is in;
* ''clamped'' is the [[Difficulty#Clamped regional difficulty|clamped regional difficulty]];
* ''day'' is the number of in-game whole days the player has been in the world.
| {{tc|No}}
|-
| Blending: Old.
| Present if the current chunk was generated using old method.
| {{tc|No}}
|-
| NoiseRouter: T: ''temperature'' V: ''vegetation'' C: ''continents'' E: ''erosion'' D: ''depth'' W: ''ridges'' PV: ''peaksAndValleys'' AS: ''initial_density_without_jaggedness'' N: ''final_density''
| The [[Custom world generation#Noise settings|noise values]] at the current position, used to generate terrain and biomes:
* ''temperature'' is the [[Biome#Temperature|temperature]] value;
* ''vegetation'' is the [[humidity]] value;
* ''continents'' is the [[continentalness]] value;
* ''erosion'' is the [[World_generation#Biomes|erosion]] value;
* ''depth'' is the [[depth]] value;
* ''ridges'' is the [[weirdness]] value;
* ''peaksAndValleys'' is the "peaks and valleys" value derived from the weirdness value: {{math|(-abs(abs(ridges) - 2/3) + 1/3) * 3}};
* ''initial_density_without_jaggedness'' is the initial density without jaggedness value;
* ''final_density'' is the final density value.
For more information, see {{slink|Custom world generation|JSON format}}.

Only present when using the <code>multi_noise</code> biome source.
| {{tc|No}}
|-
|id="biome_builder" | Biome builder PV: ''peaksAndValleys'' C: ''continentalness'' E: ''erosion'' T: ''temperature'' H: ''humidity''
| Categorized noise values:
* ''peaksAndValleys'' is:
** "Valley" if the corresponding value is less than 0.05,
** "Low" if the corresponding value is between 0.05 and {{frac|4|15}},
** "Mid" if the corresponding value is between {{frac|4|15}} and 0.4,
** "High" if the corresponding value is between 0.4 and {{frac|17|30}},
** "Peak" if the corresponding value is greater than {{frac|17|30}};
* ''continentalness'' is:
** "Mushroom fields" if the corresponding value is less than −1.05,
** "Deep ocean" if the corresponding value is between −1.05 and −0.455,
** "Ocean" if the corresponding value is between −0.455 and −0.19,
** "Coast" if the corresponding value is between −0.19 and −0.11,
** "Near inland" if the corresponding value is between −0.11 and 0.03,
** "Mid inland" if the corresponding value is between 0.03 and 0.3,
** "Far inland" if the corresponding value is greater than 0.3;
* ''erosion'' is a number between 0 and 6 (both included), where a lower number corresponds to a lower corresponding value;
* ''temperature'' is a number between 0 and 4 (both included), where a lower number corresponds to a lower corresponding value;
* ''humidity'' is a number between 0 and 4 (both included), where a lower number corresponds to a lower corresponding value.
Only present when using the <code>multi_noise</code> biome source.
| {{tc|No}}
|-
| SC: ''chunks'', M: ''monsters'', C: ''creatures'', A: ''ambient'', A: ''axolotls'', U: ''underground'', W: ''water'', W: ''fish'', M: ''misc''
| Information about loaded entities:
* ''chunks'' is the total amount of loaded mob-spawning chunks (usually 289);
* ''monsters'' is the total amount of [[hostile mob]]s that count toward the [[mob cap]];
* ''creatures'' is the total amount of creatures ([[passive mob]]s that spawn on a surface);
* ''ambient'' is the total amount of ambient mobs ([[bat]]s);
* ''axolotls'' is the total amount of [[axolotl]]s;
* ''underground'' is the total amount of underground water creatures ([[glow squid]]s);
* ''water'' is the total amount of water creatures ([[squid]]s and [[dolphin]]s);
* ''fish'' is the total amount of water ambient mobs (all 4 types of [[Fish#Mobs|fish]]);
* ''misc'' is the total amount of misc entities.
| {{tc|No}}
|-
| Sounds: ''static'' + ''streaming'' (Mood ''mood'')
| Information about sounds:
* ''static'' is the number of "static" sounds (like breaking or placing a block, moving or burning fire) playing over the maximum number of static sounds that can be played (typically, 247);
* ''streaming'' is the number of "streaming" sounds ([[music]], music from [[music disc]]s, and loop [[ambience]] sounds) playing over the maximum number of streaming sounds that can be played (typically, 8);
* ''mood'' is the [[mood]] value.
| {{tc|No}}
|-
| Shader: ''path''
| Information about the currently-active shader:
* ''path'' is the file path of the currently-active shader (within the "assets" directory of [[minecraft.jar]]).
Only present if a [[shader]] is active.
| {{tc|No}}
|-
! colspan="3" | Third paragraph
|-
| Debug: Pie [shift]: ''pie'' FPS [alt]: ''chart''
| The visibility of the debug pie and charts:
* ''pie'' is "visible" if the debug pie is visible, "hidden" otherwise;
* ''chart'' is "visible" if the chart is visible, "hidden" otherwise.
On integrated servers, "FPS" is replaced by "FPS + TPS".
| {{tc|Yes}}
|-
| For help: press F3 + Q
| Indication that the player can press {{key|F3+Q}} for help; see [[Debug hotkey]].
| {{tc|Yes}}
|}

=== Right side ===
The right side of the debug screen contains information about the system.

{| class="wikitable"
|-
! Line format
! Description
! Visible with reduced debug info
|-
! colspan="3" | First paragraph
|-
| Java ''version''
|Shows the current Java version being used
| {{tc|Yes}}
|-
|Mem: ''percentage'' ''ratio''
| Information about the memory used by the game:
* ''percentage'' is the percentage of used memory;
* ''ratio'' is the amount of used of memory over the total amount of memory, in [[Wikipedia:Mebibyte|{{abbr|MiB|Mebibytes}}]]{{fn|name=MB|Displayed as "MB" in the game instead of "MiB"}}.
| {{tc|Yes}}
|-
| Allocation rate: ''rate''
| The current allocation rate:
* ''rate'' is the rate of heap memory that the game allocates, in {{abbr|MiB|Mebibyte}}{{fn|name=MB}}/{{abbr|s|Second}}.
| {{tc|Yes}}
|-
| Allocated: ''percentage'' ''amount''
| The amount of allocated memory:
* ''percentage'' is the percentage of memory the game has allocated from the maximum it can use;
* ''amount'' is the amount of allocated memory, in {{abbr|MiB|Mebibyte}}{{fn|name=MB}}.
| {{tc|Yes}}
|-
! colspan="3" | Second paragraph
|-
| CPU: ''# of threads, name, # of cores ([https://www.amd.com/en/products/processors/desktops/ryzen.html AMD Ryzen]), base clock speed ([https://www.intel.com/content/www/us/en/products/details/processors/core.html Intel Core])''
| Information about the CPU:

* ''# of threads'' x; the amount of threads on your CPU
* ''name'' is the name of the CPU including its brand.
* ''# of cores'' is the amount of cores on your CPU. This only appears with [https://www.amd.com/en/products/processors/desktops/ryzen.html AMD CPU]'s.
* ''base clock speed'' is the base clock speed of your CPU (Measured in GHz). This only appears with [https://www.intel.com/content/www/us/en/products/details/processors/core.html Intel CPU]'s.
| {{tc|Yes}}
|-
! colspan="3" | Third paragraph
|-
| Display: ''resolution'' (''vendor'')
| Information about the display:
* ''resolution'' is the resolution of ''Minecraft'' (''width''x''height'');
* ''vendor'' is the display vendor.
| {{tc|Yes}}
|-
|''Graphics Card, additional information ([https://www.amd.com/en/products/graphics/desktops/radeon.html AMD Radeon])''
|Information about the Graphics Card:

*''Graphics Card'' is the Graphics Card name including the brand. E.G: "[https://www.nvidia.com/en-us/geforce/rtx/ NVIDIA GeForce RTX] 3060". If you have a [https://www.nvidia.com/en-us/ NVIDIA] GPU, after ''Graphics Card'' "/PCIe/SSE2" will appear next to it.
*''additional information'' is shown if you have a GPU from [https://amd.com AMD].
| {{tc|Yes}}
|-
| ''renderer''
| Information about the renderer.
| {{tc|Yes}}
|-
| ''version''
| Information about [[Wikipedia:OpenGL|OpenGL]]:
* ''version'' is the OpenGL version. (Generally 3.2)
| {{tc|Yes}}
|-
! colspan="3" | Targeted Block paragraph
|-
| Targeted Block: ''coordinates''
| rowspan="4" | Information about the targeted block:
* ''coordinates'' is the [[coordinates]] of the block;
* ''identifier'' is the [[resource location]] of the block;
* ''state'' is the [[Block states|state]] of the block (one line per state property);
* ''tags'' is the list of [[tag]]s containing this block (one line per tag).
Only present when looking at a [[block]].
| rowspan="4" class="tc-no" | No
|-
| ''identifier''
|-
| ''state''
|-
| ''tags''
|-
! colspan="3" | Targeted Fluid paragraph
|-
| Targeted Fluid: ''coordinates''
| rowspan="4" | Information about the targeted fluid:
* ''coordinates'' is the coordinates of the fluid;
* ''identifier'' is the resource location of the fluid;
* ''state'' is the state of the fluid (one line per property);
* ''tags'' is the list of tags containing this fluid (one line per tag).
Only present when looking at a block or [[fluid]].
| rowspan="4" class="tc-no" | No
|-
| ''identifier''
|-
| ''state''
|-
| ''tags''
|-
! colspan="3" | Targeted Entity paragraph
|-
| Targeted Entity
| rowspan="2" | Information about the targeted entity:
* ''type'' is the type of the entity.
Only present when looking at an [[entity]].
| rowspan="2" class="tc-no" | No
|-
| ''type''
|}

{{notelist|fn}}

== History ==
[[File:DebugScreenAlpha.png|200px|thumb|The debug information from Indev, Infdev, and early Alpha.]]

{{HistoryTable
|{{HistoryLine|java classic}}
|{{HistoryLine||0.0.2a|The version number is now displayed in the top-left corner.
|Includes the fps and chunk updates.}}
|{{HistoryLine||0.0.23a|Added an option to turn on the debug screen. The current version name is always displayed even when the option is disabled.}}
|{{HistoryLine|java indev}}
|{{HistoryLine||0.31|dev=20100202|Added "E" entities value, "P" particles value, and "LT" value.
|Upon placing chests, the second value of "LT" would go up upon every chest placed.
|The first value seemingly is unaffected by this.}}
|{{HistoryLine||20100206-2034|Removed "LT" value.
|FPS and chunk updates have been moved next to the version number and are now contained within parentheses.
|Moved "E" value below "C" value, and moved "P" value below "E" value.
|"C", "F", "O", "B", "I", and "T" values have been added.
|"C" values cover rendered/total chunks, "F" values are chunks outside the field of view, "O" values are chunks culled by occlusion culling, "B" values are culled entities that are hidden in a chunk and can't be seen, "I" values are individually culled entities, and "T" values are terrain and lighting data.}}
|{{HistoryLine||20100212-1210|Added "L" lighting updates value.}}
|{{HistoryLine||20100212-1622|Added Free memory and Allocated memory.
|Displayed in §8 (dark gray) color code.
|It always displays even when the option to turn on the debug screen is disabled.}}
|{{HistoryLine||20100213|Free memory and Allocated memory now display in §7 (light gray) color code.
|Now displays only when the option is enabled.}}
|{{HistoryLine|java infdev}}
|{{HistoryLine||20100227-1414|Removed "L" value.
|"T" value no longer displays a value.
|"O", "E", "B", and "I" values no longer function.}}
|{{HistoryLine||20100316|"E" and "I" values now function again.}}
|{{HistoryLine||20100413|Added "All" and "Counted" values.
|"All" displays the total number of loaded entities.
|"Counted" seemingly serves the same function as "All".}}
|{{HistoryLine||20100420|Removed slash from "All" value.
|Removed "Counted" value.}}
|{{HistoryLine||20100624|Added second "E" value.
|Second "E" is located right next to "O" value.
|Second "E" displays number of empty chunk sections that may be skipped due to not yet being loaded and rendered, or has nothing to draw in the current render pass; all render passes are counted.
|Lagometer added.
|Separate from debug screen, requires {{key|F6}} to be held down and can be displayed with the debug screen.}}
|{{HistoryLine||20100627|Changed Free memory to Used memory.
|Now displays MB in parentheses right next to the value percentage.}}
|{{HistoryLine|java alpha}}
|{{HistoryLine||v1.1.1|The debug screen is no longer listed as an option and now requires {{key|F3}} to be held down to activate.}}
|{{HistoryLine||v1.2.0|dev=?|The lagometer is now part of the debug screen.}}
|{{HistoryLine||v1.2.3|The coordinates have been added to the debug screen.}}
|{{HistoryLine|java beta}}
|{{HistoryLine||1.3|The debug screen, along with other function key controls, has now become a toggle.
|When the debug screen is open, it now shows numbers above every [[mob]]; these numbers being the mob's Entity ID. These numbers are visible through [[block]]s, making {{key|F3}} a useful mob-finder.}}
|{{HistoryLine||1.7|The "f" coordinate has been made visible in the debug screen (facing direction).}}
|{{HistoryLine||1.8|dev=Pre-release|The ability to see the level's [[Seed (world generation)|seed]] has been added to the debug screen.
|Entity numbers being shown above a [[mob]]'s head have been removed from the debug screen. Some players felt that it was cheating and that it took away from the game.}}
|{{HistoryLine|java}}
|{{HistoryLine||1.0.0|dev=October 2, 2011|slink={{tweet|notch|120525867045765120}}|The first images of a runtime performance profiler with a pie chart is revealed.}}
|{{HistoryLine|||dev=Beta 1.9 Prerelease 3|The profiler has been added to the debug screen.}}
|{{HistoryLine||1.2.1|dev=1.2|Information about the [[biome]] and light level of the [[player]]'s location have been added to the debug screen. 
|The seed in [[multiplayer]] has been made hidden from the debug screen and now shows as "0".}}
|{{HistoryLine||1.2.4|Pressing {{key|F3}} ({{key|Fn+F3}} on Mac and some laptops) brings up the debug screen, but without the graphs. The graph appears upon pressing {{key|Shift+F3}} ({{key|Fn+Shift+F3}} on Mac and some laptops).}}
|{{HistoryLine||1.3.1|dev=12w18a|Information about the player's speed and whether the player is touching the ground have added to the debug screen.
|Coordinates within the debug screen are now rounded to 5 digits.}}
|{{HistoryLine|||dev=12w21a|Information about the world's seed has been removed from the debug screen, seen instead by pressing the chat key and typing {{cmd|seed}}.
|The frame time graph has been removed from the debug screen.}}
|{{HistoryLine|||dev=12w30a|The y coordinate now shows both the feet level and the eye level.}}
|{{HistoryLine||1.4.2|dev=12w39a|Fl, x and z chunk coordinates, and more rotation (f) information have been added to the debug screen.}}
|{{HistoryLine|||dev=12w41a|{{key|Shift+F3}} now shows the profiler graph in the debug screen.
|{{key|F3+H}} now shows [[durability]] on damaged tools, weapons and armor pieces.}}
|{{HistoryLine||1.4.4|dev=1.4.3|{{key|F3+B}} now shows the [[hitbox]] around [[entities]]. At this point, the hitbox is white and opaque and does not have an outline.}}
|{{HistoryLine||1.7.2|dev=1.7.1|{{key|F3+B}} visual changed. The entity hitbox is now completely transparent, with a thin white outline.}}
|{{HistoryLine||1.8|dev=14w02a|The debug screen now shows which axis the [[player]] is facing after the cardinal direction: "Toward positive/negative X/Z".}}
|{{HistoryLine|||dev=14w04a|The crosshair in the debug screen now displays 3 short colored lines to indicate the direction of each axis: x/red, y/green, z/blue.
|The x coordinate line in the debug screen now appears bold when looking east/west, similarly the z coordinate line now appears bold when looking south/north.}}
|{{HistoryLine|||dev=14w05a|Text within the debug screen now has a background.
|X, y, z, b, bl and other labels within the debug screen have been replaced with more understandable labels.
|"Light" is now the light levels at feet, not eyes.}}
|{{HistoryLine|||dev=14w06a|X, Y, and Z title in the debug screen has been changed from 'Feet' in the previous snapshot, to 'XYZ'.
|A day counter, which increases by 1 every dawn, has been added to the debug screen.
|The debug screen now displays [[regional difficulty]]: Peaceful starts at 0.00, Easy starts at 0.75, Normal starts at 1.50, and Hard starts at 2.25.
|The debug screen now displays player rotation in degrees and quadrants.}}
|{{HistoryLine|||dev=14w11a|On the right-hand side of the debug screen, a display now shows up if the [[player]] is looking at a [[block]], showing its ID and block states.}}
|{{HistoryLine|||dev=14w17a|All [[block]]s now have their info displayed on the right-hand side of the debug screen.
|The "Facing negative/positive x/z" from the debug screen has been removed.}}
|{{HistoryLine|||dev=14w20a|The "Facing negative/positive x/z" has been readded to the debug screen.}}
|{{HistoryLine|||dev=14w25b|{{key|F3+B}} now also shows which direction [[entities]] are looking using a blue line.
|The line on the right-hand side that had displayed the name of the block [[model]] the [[player]] was looking at has been removed from the debug screen.}}
|{{HistoryLine|||dev=14w29a|A 'Reduced Debug Info' toggle now exists within multiplayer settings to enable/disable reduced information on the debug screen.
|The <code>reducedDebugInfo</code> gamerule allows the [[player]] to enable/disable reduced information on the debug screen. This overrides all 'reduced debug info' settings in clients.}}
|{{HistoryLine|||dev=14w30a|The debug screen now displays how many [[chunk]] sections are being rendered currently and how many chunk sections are out of view in percent, the OpenGL version, display size, vendor and GPU.
|"Vanilla" has been added to the version number within the debug screen.}}
|{{HistoryLine||1.8.2|dev=pre1|The frame time graph within the debug screen has been readded and redesigned, so that it can now be activated using {{key|Alt+F3}}.}}
|{{HistoryLine||1.9|dev=15w32a|{{key|F3+N}} now toggles between [[Creative]] and [[Spectator]] modes, when the [[player]] is in either of them. The player needs to be allowed to use {{Command|gamemode}} for this to work.}}
|{{HistoryLine|||dev=15w43a|The debug screen now shows more information.
|{{keys|F3+Q}} gives help and shows all {{key|F3}} + key combinations.
|{{keys|F3+F}} now increases render distance by 1 (Minimum and Maximum are 2-32).
|{{keys|F3+Shift+F}} now decreases render distance by 1 (Min and Max are 2-32).
|The debug screen now shows if the pie chart and fps chart are shown on screen.
|The debug screen now shows text in chat when the [[player]] reloads [[chunk]]s, [[sound]]s, etc.
|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}} has been removed from the debug screen, which previously reloaded sounds.
|{{keys|F3+T}} now reloads all [[resource pack]] content, including [[sound]]s.
|Red, blue and green lines have now changed in size within the debug screen and now change relative to the GUI scale.
|The debug screen is now toggled when the {{key|F3}} key is released, instead of when it is pressed.}}
|{{HistoryLine||1.10|dev=16w20a|{{keys|F3+G}} toggles the visible chunk borders around the [[player]].
|The 3 lines indicating direction now have a small black outline when looking at an area with bad contrast.}}
|{{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, though 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.}}
|{{HistoryLine|||dev=18w22c|The debug overlay now shows the [[fluid]] the [[player]] is looking at, separately from [[block]]s.}}
|{{HistoryLine|||dev=pre6|{{key|F3+I}} copies block or entity data to the clipboard.
|Added information about the time it takes for a tick on the integrated server, number of packets sent by the client (tx), and number of packets received by the client (rx).}}
|{{HistoryLine|||dev=pre7|Added "Looking at liquid" row, which displays the targeted fluid's coordinates.
|"Looking at" row within the debug screen has been renamed to "Looking at block".
|"Targeted Block" information now targets through [[fluid]]s. It displays information for [[block]]s up to 16 blocks away.
|Added "Targeted Entity", which displays information for [[entities]] up to 16 blocks away.
|{{key|F3+I}}<ref group="note">{{key|F3+I}} was used to copy targeted block or entity data to clipboard.</ref> 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 [[operator]]s.}}
|{{HistoryLine||1.13.1|dev=18w30a|Added {{keys|Control+F3+C}} to force a JVM crash, instead of a regular crash.}}
|{{HistoryLine|||dev=18w31a|Added new fields for the current dimension and the related force loaded chunks.}}
|{{HistoryLine||1.14|dev=18w43c|Pressing {{key|Alt+F3}} now shows TPS (ticks per second).
|Added {{code|delimiter=/|min|avg|max}} tick times to help find stutters.}}
|{{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|dev=19w38a|The chunk update counter has been removed from the debug screen.}}
|{{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=20w18a|The "Looking at block" and "Looking at fluid" were integrated into "Targeted block" and "Targeted fluid" located on the right side of the debug screen.
|Added a new line detailing mob spawning in different categories.}}
|{{HistoryLine|||dev=20w20a|Added gamemode switcher accessible with {{key|F3+F4}}.
|{{key|F3+N}} now toggles between Spectator mode and the previous gamemode.}}
|{{HistoryLine||1.17|dev=21w11a|Added {{key|F3+L}} to generate [[performance metrics]].}}
|{{HistoryLine||1.18|dev=Experimental Snapshot 1|Added two new lines: Multinoise and Terrain.}}
|{{HistoryLine||1.18.2|dev=22w03a|Now contains the chunk position in the region file, and the name of this region file that player is currently in, in the end of the "Chunk" row.
|Moved the location of the player within a chunk from "Chunk" row, into the new square brackets at the end of the "Block" row.}}
|{{HistoryLine|||dev=22w07a|Merged the "Terrain" and "Multinoise" row into the "NoiseRouter" row.}}
|{{HistoryLine||1.19|dev=22w11a|Added estimated GPU utilization percentage to performance profiling metrics and F3 debug screen, available only for graphics devices that support GPU timer queries.
|Added "Blending" row, above the "Noise Router" row.
|The H for "humidity" has been changed for a V for "vegetation".}}
|{{HistoryLine|||dev=22w12a|Removed the {{key|F3+F}} and {{key|F3+Shift+F}} hotkeys that change render distance.}}
|{{HistoryLine|||dev=22w16a|Added "Allocation Rate" row, which shows heap memory allocation rate.}}
|{{HistoryLine||1.19.1|dev=1.19.1-rc1|The "Blending" row now disappears when the chunk that the player is in uses the new method, instead of displaying "Blending: New".}}
|{{HistoryLine||1.19.4|dev=Pre-release 3|Pressing {{key|F3+S}} now dump contents of dynamic textures (like atlases, maps, etc.) to {{samp|screenshots/debug/}}.}}
|{{HistoryLine||1.20|dev=23w17a|Font textures are included in debug texture dump ({{key|F3+S}}).}}
|{{HistoryLine||1.20.2|dev=23w31a|{{key|F3+B}} now shows the passenger's attachment point on the entity it's riding.
|Values in the {{cd|SH}} row now appear as question marks when playing on a server, instead of wrong values.}}
|{{HistoryLine|||dev=23w32a|Opening it with <code>CTRL + F3</code> now shows charts for ping and received network traffic.}}
|{{HistoryLine|||dev=23w33a|The debug charts can now be toggled with {{key|F3+1}} (pie chart), {{key|F3+2}} (FPS and TPS) and {{key|F3+3}} (bandwidth and ping) instead of {{key|Shift}}, {{key|Alt}} or {{key|Ctrl}} while opening the screen.}}
|{{HistoryLine||1.20.5|dev=24w04a|Updated the bottom right graph shown via F3+2}}
}}

=== Pre-1.8 legend ===
{{Outdated feature|section=1}}
{| class="wikitable" data-description="Pre-1.8 legend"
|-
!Name
!Description<ref>http://gaming.stackexchange.com/questions/14990/minecraft-debug-screen</ref><ref>http://www.minecraftforum.net/viewtopic.php?f=35&t=13231</ref>
|-
|C
|Number of chunk sections rendered over total number of chunks. Counts all render passes: if a chunk section is rendered twice (because it contains both water and normal blocks, for example) then it is counted twice. 
|-
|F
|Number of chunk sections loaded outside the viewing distance. Counts all render passes.
|-
|O
|Number of chunk sections removed through [[wikipedia:Hidden surface determination|occlusion culling]]. Counts all render passes.
|-
|E (first row)
|Number of empty chunk sections. These sections are skipped for one of two reasons: Either the chunk has not yet been loaded and rendered into polygons, or the section has nothing to draw in the current render pass. Counts all render passes.
|-
|E (second row)
|Number of rendered entities over total entities
|-
|''B''
|Unused, always 0.<ref group="note" name="B" />
|-
|I
|Number of invisible entities
|-
|P
|Number of particles on screen
|-
|T
|Displays the player's max framerate
|-
|ALL
|Displays the total number of loaded entities (including mobs and dropped items)
|-
|ServerChunkCache<br> ChunkCache
|The most chunks that can be loaded
|-
|x
|Player's location in blocks East of 0,0 (negative values are to the West) and after the // is the player's chunk number with the block within the chunk in ()
|-
|y
|Player's altitude in blocks (63 (62.9) is [[Overworld]] sea level, 11 (10.9) is Overworld lava flood level, 32 (31.9) is [[Nether]] lava sea).
|-
|z
|Player's location in blocks South of 0,0 (negative values are to the North) and after the // is the player's chunk number with the block within the chunk in ()
|-
|f
|The direction in which a player is facing (south=0, west=1, north=2, east=3) and if the player walks toward x or z respectively
|-
|lc
|Max section height for the [[chunk]] the player is in (uses cubic chunk sections, so heights display in multiples of 16 minus 1).
|-
|b
|Shows the player what [[biome]] they are in.
|-
|bl
|(for "'''b'''lock '''l'''ight") The amount of [[light]] from other [[block]]s (e.g. [[torch]]es) at the block the player's head is in. If the player stands on top of a torch, this field shows a light level of 13 instead of the expected 14, due to the player's head being one block away from it.
|-
|sl
|(for '''s'''ky '''l'''ight) The amount of light from the sky at the block the player's head is in. Note that the number shown here is accurate only during the day. It shows the light level the block would get from the sun in full daylight, but does not account for the lower light levels at night or during a storm.
|-
|rl
|(for '''r'''aw''' l'''ight) The total light level where the player's head is, equal to max (bl,sl). Note that because the "sl" field is factored in here, this field has the same caveats as that one.
|-
|ws
|Walking speed.
|-
|fs
|Flying speed.
|-
|g
|On ground, Boolean value, true if the player touches the ground.
|-
|fl
|The y-coordinate of the highest block where the player is able to stand, rounded up when standing on half-blocks, such as [[slab]]s. When above the void (where there is no block), it equals 0.
|-
|shader
|The file path of the currently-active [[shader]] (within the "assets" directory of [[minecraft.jar]]). Displayed only if a shader is active.
|}

== Issues ==
{{issue list|debug screen|F3}}

== Trivia ==
* Biome, and the lighting values do not display when the player is outside of the build limits.
* Deeper into the profiler ({{key|Shift+F3}}), some tasks have numbers higher than 9 and can't be accessed. Pressing the two keys simultaneously does not open the task.
* The profiler graph is commonly used by players to find structures, such as [[nether fortress]]es. This tactic is commonly known as "pie-ray".

== Gallery ==
<gallery>
File:Notch DRM.png|Image from Notch showing an "unlicensed copy" message on the top corner of the screen.
File:Debug Screen Performance Profiler Sneak Peek.png|A sneak peek of the performance profiler shown on Notch's Twitter on October 2, 2011<ref>{{tweet|notch|120525867045765120|Very useful runtime performance profiling with PIE CHARTS: http://i.imgur.com/ZuJXC.png|October 2, 2011}}</ref>
File:Jeb Debug 1.png|Jeb using the debug screen.
File:Jeb Debug 2.png|Jeb using the debug screen.
File:Dinnerbone Render Distance.png|Dinnerbone using the debug screen.
File:Rockenroll4life Debug 1.jpg|Rockenroll4life using the debug screen.
File:Rockenroll4life Debug 2.jpg|Rockenroll4life using the debug screen.
File:Dinnerbone Debug 1.png|Door block data in the debug screen.
File:Dinnerbone Debug 2.png|Redstone block data in the debug screen.
File:Dinnerbone Debug 3.png|Tripwire hook block data in the debug screen.
</gallery>

== Notes ==
{{notelist}}

== References ==
{{reflist}}

== External links ==
* [https://help.minecraft.net/hc/en-us/articles/360059146051-What-is-in-the-Debug-Menu-in-Minecraft-Java-Edition What is in the Debug Menu in ''Minecraft: Java Edition''?] – [[Minecraft Help Center]]

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

[[Category:Development]]
[[Category:UI]]

[[de:Debug-Bildschirm]]
[[es:Pantalla de información]]
[[fr:Écran de débogage]]
[[ja:デバッグ画面]]
[[ko:디버그 화면]]
[[nl:Debug-scherm]]
[[pl:Ekran debugowania]]
[[pt:Tela de depuração]]
[[ru:Экран отладки]]
[[uk:Екран налагодження]]
[[zh:调试屏幕]]