Debug screen


The debug screen, debug overlay or F3 screen functions as a menu for accessing debugging information, but it also provides useful in-game information like player coordinates. It is triggered when F3 is pressed.
The debug screen consists of info text lines and five toggleable graphs: profiler, frame rate, tick rate, bandwidth, and ping time graphs.
Information lines
[edit | edit source]
The debug screen consists of 25[until JE 26.1]/28[upcoming JE 26.1] elements (referred to as "debug screen text" in the debug options menu). Each of these elements can be individually disabled through the debug options menu, which is accessed by pressing F3 + F6:
- "OFF" removes the given element from the debug overlay.
- "In Overlay" adds the given element to the debug overlay.
- "Always" causes the element to display on-screen even when the debug overlay is not open.
There are 2 built-in configurations: "Default Profile" and "Performance Profile".
Setting the reduced_debug_info game rule to true prevents some elements from being displayed, even if the player has toggled them to "In Overlay" or "Always".
| Name | Line syntax | Description | Built-in profiles | Visible when reduced_debug_info is set to true
| |
|---|---|---|---|---|---|
| Default profile |
Performance profile | ||||
| biome | Biome: biome
|
Displays in which biome the player is.
|
OFF | OFF | No |
| chunk_generation_stats | NoiseRouter T: T V: V C: C E: E D: D W: W PV: PV PS: PS N: NBiome builder PV: PV C: C E: E T: T H: H
|
The NoiseRouter line displays the noise values used to generate the terrain.
The Biome builder line displays categories for the noise values.
|
OFF | OFF | No |
| chunk_render_stats | C: C (s) D: D, pC: pC, pU: pU, aB: aB
|
Displays information about loaded chunks.
|
OFF | OFF | Yes |
| chunk_source_stats | Chunks[C] W: W1, W2 E: E1,E2,E3
|
Displays information about client-side chunks. | OFF | OFF | Yes |
| day_count [upcoming JE 26.1] | Day #DAY
|
Displays the number of days that have elapsed in the world.
|
OFF | OFF | No |
| entity_render_stats | E: E/T, SD: SD
|
Displays information about loaded entities.
|
OFF | OFF | Yes |
| entity_spawn_counts | SC: SC, M: M, C: C, A: A1, A: A2, U: U, W: W1, W: W2, M: M
|
Displays the amount of entities that count toward the mob cap.
|
OFF | OFF | No |
| fps | FPS FPS T: T vsync
|
Displays the framerate.
|
In overlay | Always | Yes |
| game_version | Minecraft V (V/M/S)
|
Displays the game version.
|
In overlay | OFF | Yes |
| gpu_utilization | GPU: GPU%
|
Displays the GPU utilization.
|
OFF | In overlay | Yes |
| heightmap | CH S: S M: M ML: MLSH S: S O: O M: M ML: ML
|
The CH line displays values of the corresponding client-side heightmaps at the player's position. The SH line displays values of the corresponding server-side heightmaps at the player's position.
|
OFF | OFF | No |
| light_levels | Client Light: L (S sky, B block)
|
Displays the client-side light values at the player's feet.
|
OFF | OFF | No |
| local_difficulty | Local Difficulty: D // C (Day DAY) [until JE 26.1]
Local Difficulty: |
Displays local difficulty-related values.
|
OFF | OFF | No |
| looking_at_block[until JE 26.1] looking_at_block_state[upcoming JE 26.1] |
Targeted Block: CBST[until JE 26.1]
|
Displays information about the targeted block.
|
OFF | OFF | No |
| looking_at_block_tags[upcoming JE 26.1] | T
|
Displays the list of tags containing the targeted block (one line per tag). | OFF | OFF | No |
| looking_at_entity | Targeted EntityE
|
Displays the identifier of the targeted entity. | OFF | OFF | No |
| looking_at_entity_tags[upcoming JE 26.1] | T
|
Displays the list of tags containing the targeted entity (one line per tag). | OFF | OFF | No |
| looking_at_fluid[until JE 26.1] looking_at_fluid_state[upcoming JE 26.1] |
Targeted Fluid: CBST[until JE 26.1]
|
Displays information about the targeted fluid.
|
OFF | OFF | No |
| looking_at_fluid_tags[upcoming JE 26.1] | T
|
Displays the list of tags containing the targeted fluid (one line per tag). | OFF | OFF | No |
| memory | Mem: P% RMBAllocation rate: AMB/sAllocated: AP% ARMB
|
Displays information about the memory being actively used by Minecraft and the allocated memory to Minecraft.
|
In overlay | In overlay | Yes |
| particle_render_stats | P: P
|
Displays the number of particles in the loaded area. | OFF | OFF | No |
| player_position | XYZ: PX / PY / PZBlock: BX BY BZChunk: CX CY CZ [RX RZ in F]Facing: D (Towards T) (Y P)DIM FC: FC
|
|
In overlay | OFF | No |
| player_section_position | Section-relative: X Y Z
|
Displays the relative coordinates of the block the player's feet are in within the chunk. | In overlay | OFF | Yes |
| post_effect | [more information needed] | [more information needed] | OFF | OFF | No |
| simple_performance_impactors | C B: BFiltering: F
|
Displays various video setting options.
|
In overlay | In overlay | Yes |
| sound_mood | Sounds: S1 + S2 (Mood M%)
|
Displays hovw many sounds are being played and the mood value.
|
OFF | OFF | No |
| system_specs | Java: JAVA VERSIONCPU: THREAD NAME CORES SPEEDDisplay: RES (VENDOR)GRAPHICS CARD GRAPHICS CARD INFOOpenGL OPENGL VERSION RENDERER
|
Displays various computer specifications.
|
In overlay | OFF | Yes |
| tps | BRAND server @ MST ms, UP tx, DOWN rx
|
Displays information about the server.
|
In overlay | In overlay | Yes |
Graphs
[edit | edit source]Profiler graph
[edit | edit source]
The profiler graph, known informally as the pie chart, can be toggled using F3 + 1 (previously ⇧ Shift + F3) and displays profiling information. To access a sub-section, press ⇧ Shift + N, which N is the section number within square brackets under the pie chart.
While the profiler graph is open, clicking a number on the keyboard results in going into that profiler category. Where 0 is used to traverse back. It's currently impossible to navigate to numbers past 9. Traversal is limited to KeyCode 48 to 57, where input -- 48 results into the number category to traverse into.
While the chart is open, any entry that gets added into the chart may not disappear unless the chart is reopened by re-toggling F3, thus giving the player a refreshed result. For instance, if inspecting the blockRenderer, if the player were in the range of a specific block and went out of it, the block may still be visible in the chart while actually not being rendered anymore; to have better results, the player would have to open the Debug Screen.
FPS graph
[edit | edit source]
The frame rate graph (or simply FPS graph) displays on the left side of the screen when enabled with F3 + 2 (previously Alt + F3). It shows the last 240 frames of gameplay. The height of each bar is proportional to the time a frame took to generate.
The minimum, average, and maximum frame times for the last 240 frames are shown on top.
The colors are on a gradient from neon green (good) (
#00FF00) through yellow (
#FFFF00) to neon red (bad) (
#FF0000).
TPS graph
[edit | edit source]
The tick rate graph (or simply TPS graph) displays on the right side of the screen when enabled with F3 + 2 if in singleplayer or playing as an operator on a server. It shows the last 240 ticks of gameplay. The height of each bar is proportional to the time a tick took to process.
The minimum, average, and maximum tick times for the last 240 ticks are shown on top.
The colors stack. From top to bottom[1]:
- Light green/yellow/red: Idling, waiting for next tick (color gradient like the FPS graph above)
- Purple: Miscellaneous (all other code during the tick)
- Light brown: Scheduled tasks
- Dark red: Main logic of the server tick
Bandwidth graph
[edit | edit source]
The bandwidth graph displays on the left side of the screen when enabled with F3 + 3. It shows the last 240 packets. Higher the bar is, the higher the bandwidth it uses. The minimum, average, and maximum size is shown on top, typically in KiB.
The colors are cyan for small-sized packets and light purple for larger ones.
Ping graph
[edit | edit source]
The ping graph displays on the right side of the screen when enabled with F3 + #. It shows the last 240 ping times. Higher is longer time. The minimum, average and maximum are shown on top.
The colors are on a gradient from neon green (good) (
#00FF00) through yellow (
#FFFF00) to neon red (bad) (
#FF0000).
History
[edit | edit source]
| Java Edition Classic | |||||||
|---|---|---|---|---|---|---|---|
| 0.0.2a | The version number is now displayed in the top-left corner. | ||||||
| Includes the fps and chunk updates. | |||||||
| 0.0.23a | Added a Show FPS option to toggle current framerate being displayed. It is on by default. | ||||||
| Java Edition Indev | |||||||
| 0.31 | 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. | |||||||
| 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. | |||||||
| 20100212-1210 | Added "L" lighting updates value. | ||||||
| 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. | |||||||
| 20100213 | Free memory and Allocated memory now display in §7 (light gray) color code. | ||||||
| Displays only when the option is enabled. | |||||||
| Java Edition Infdev | |||||||
| 20100227-1414 | Removed "L" value. | ||||||
| "T" value no longer displays a value. | |||||||
| "O", "E", "B", and "I" values no longer function. | |||||||
| 20100316 | "E" and "I" values now function again. | ||||||
| 20100413-1951 | Added "All" and "Counted" values. | ||||||
| "All" displays the total number of loaded entities. | |||||||
| "Counted" seemingly serves the same function as "All". | |||||||
| 20100420 | Removed slash from "All" value. | ||||||
| Removed "Counted" value. | |||||||
| 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 (initially separate, requires F6). | |||||||
| 20100627 | Changed Free memory to Used memory. | ||||||
| Now displays MB in parentheses right next to the value percentage. | |||||||
| Java Edition Alpha | |||||||
| v1.1.1 | The debug screen is no longer listed as an option and now requires F3 to be held down to activate. | ||||||
| v1.2.0 | ? | The lagometer is now part of the debug screen. | |||||
| v1.2.3 | The coordinates have been added to the debug screen. | ||||||
| Java Edition Beta | |||||||
| 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 blocks. | |||||||
| 1.7 | The "f" coordinate has been made visible in the debug screen (facing direction). | ||||||
| 1.8 | Pre-release | The ability to see the level's seed has been added to the debug screen. | |||||
| Entity numbers being shown above a mob's head have been removed from the debug screen. | |||||||
| Java Edition | |||||||
| 1.0.0 | October 2, 2011 | The first images of a runtime performance profiler with a pie chart is revealed. | |||||
| Beta 1.9 Prerelease 3 | The profiler has been added to the debug screen. | ||||||
| 1.2.1 | 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". | |||||||
| 1.2.4 | Pressing F3 (Fn + F3 on Mac and some laptops) brings up the debug screen, but without the graphs. The graph appears upon pressing ⇧ Shift + F3 (Fn + ⇧ Shift + F3 on Mac and some laptops). | ||||||
| 1.3.1 | 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. | |||||||
| 12w21a | Information about the world's seed has been removed from the debug screen, seen instead by pressing the chat key and typing /seed.
| ||||||
| The frame time graph has been removed from the debug screen. | |||||||
| 12w30a | The y coordinate now shows both the feet level and the eye level. | ||||||
| 1.4.2 | 12w39a | Fl, x and z chunk coordinates, and more rotation (f) information have been added to the debug screen. | |||||
| 12w41a | ⇧ Shift + F3 now shows the profiler graph in the debug screen. | ||||||
| 1.8 | 14w02a | The debug screen now shows which axis the player is facing after the cardinal direction: "Toward positive/negative X/Z". | |||||
| 14w04a | 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. | ||||||
The 3d_crosshair debug renderer is now active when the debug screen is open. | |||||||
| 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. | |||||||
| 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. | |||||||
| 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. | ||||||
| 14w17a | All blocks 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. | |||||||
| 14w20a | The "Facing negative/positive x/z" has been readded to the debug screen. | ||||||
| 14w25b | 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. | ||||||
| 14w29a | A 'Reduced Debug Info' toggle now exists within multiplayer settings to enable/disable reduced information on the debug screen. | ||||||
The reducedDebugInfo gamerule allows the player to enable/disable reduced information on the debug screen. This overrides all 'reduced debug info' settings in clients. | |||||||
| 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. | |||||||
| 1.8.2 | pre1 | The frame time graph within the debug screen has been readded and redesigned, so that it can now be activated using Alt + F3. | |||||
| 1.9 | 15w43a | The debug screen now shows more information. | |||||
| 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 chunks, sounds, etc. using other F3 hotkeys. | |||||||
| The debug screen is now toggled when the F3 key is released, instead of when it is pressed. | |||||||
| 1.13 | 18w22c | The debug overlay now shows the fluid the player is looking at, separately from blocks. | |||||
| pre6 | 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). | ||||||
| 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 fluids. It displays information for blocks up to 16 blocks away. | |||||||
| Added "Targeted Entity", which displays information for entities up to 16 blocks away. | |||||||
| 1.13.1 | 18w31a | Added new fields for the current dimension and the related force loaded chunks. | |||||
| 1.14 | 18w43c | Pressing Alt + F3 now shows TPS (ticks per second). | |||||
Added min/avg/max tick times to help find stutters. | |||||||
| 1.15 | 19w38a | The chunk update counter has been removed from the debug screen. | |||||
| 1.16 | 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. | |||||||
| 1.18 | Experimental Snapshot 1 | Added two new lines: Multinoise and Terrain. | |||||
| 1.18.2 | 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. | |||||||
| 22w07a | Merged the "Terrain" and "Multinoise" row into the "NoiseRouter" row. | ||||||
| 1.19 | 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". | |||||||
| 22w16a | Added "Allocation Rate" row, which shows heap memory allocation rate. | ||||||
| 1.19.1 | Release Candidate 1 | The "Blending" row now disappears when the chunk that the player is in uses the new method, instead of displaying "Blending: New". | |||||
| 1.20.2 | 23w31a | Values in the SH row now appear as question marks when playing on a server, instead of wrong values. | |||||
| 23w32a | Opening it with Ctrl + F3 now shows charts for ping and received network traffic. | ||||||
| 23w33a | The hotkeys for debug charts have changed.
| ||||||
| 1.20.5 | 24w04a | Updated the TPS graph (bottom right graph) shown via F3 + 2. | |||||
| 1.21.2 | 24w33a | The unused value "B" in the row "E" has been removed as being redundant. | |||||
| 1.21.9 | 25w31a | The player can now use F3 when in menus. | |||||
| Minimized default debug screen to display less information. | |||||||
| Added debug screen configure menu shown via F3 + F5 with separation of debug information into parts that can be individually configured to display in debug screen and are classified into two categories: Debug Screen Text and Debug Renderers. | |||||||
| "Biome: biome" changed to "Biome:biome" (biome) as the space between title and displayed biome name disappeared. | |||||||
| "Chunk-relative: relative" renamed to "Section-relative: relative" (player_section_position) with the relative 3-integer coordinates being fixed to always show 2 digits. It can now be showned on screen even without reducedDebugInfo enabled, therefore replacing "[relative]" section in Block line, making the line changed from "Block: coordinates [relative]" to "Block: coordinates". | |||||||
| Removed redundant total entities attribute from (particle_render_stats), changing "P: particles. T: total entities" to "P: particles". | |||||||
| "Chunks[S] W: chunks E: entities,visible,sections,chunks,ticking,load,unload" line is now merged with "Chunks[C] W: cached, loadedC E: loadedE,sections,ticking" under (chunk_source_stats), making information about server-side chunks available with reducedDebugInfo enabled. | |||||||
| particle_render_stats is no longer available with reducedDebugInfo enabled. | |||||||
| Help line text changed from "For help: press F3 + Q" to "For help: press F3 + Q. To edit: press F3 + F5". Debug charts with help information becomes visible when debug screen is opened and has at least one text part not turned off in configuration options. | |||||||
| Pre-Release 4 | The Debug Options screen is now accessible using F3 + F6 instead of F3 + F5. | ||||||
| Upcoming Java Edition | |||||||
| 26.1 | snap1 | The looking_at_block and looking_at_fluid debug entries no longer show tags. | |||||
New debug entries have been added: looking_at_block_tags, looking_at_fluid_tags, and looking_at_entity_tags. | |||||||
Renamed debug entries: looking_at_block -> looking_at_block_state, looking_at_fluid -> looking_at_fluid_state. | |||||||
| snap3 | The local_difficulty debug entry no longer shows the day count. | ||||||
Added the day_count debug entry. | |||||||
| snap8 | Added the detailed_memory debug entry. | ||||||
Pre-1.8 legend
[edit | edit source]| Name | Description[2][3] |
|---|---|
| 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 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.[note 2] |
| 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 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 "block light") The amount of light from other blocks (e.g. torches) 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 sky light) 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 raw light) 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 slabs. 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
[edit | edit source]Issues relating to "Debug screen" or "F3" are maintained on the bug tracker. Issues should be reported and viewed there.
Trivia
[edit | edit source]- The biome and lighting values do not display when the player is outside of the build limits.
- Deeper into the profiler (⇧ 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 warning stating that the Debug Options is for testing purposes contains a joke possibility as the last item in the list. This joke is changed depending on the game language.
Gallery
[edit | edit source]Historical screenshots
[edit | edit source]Most of these screenshots show debug screen exclusively used by the developers of Minecraft.
-
Image from Notch showing an "unlicensed copy" message on the top corner of the screen.
-
A sneak peek of the performance profiler shown on Notch's Twitter on October 2, 2011[4]
-
Jeb using the debug screen.
-
Ditto.
-
Dinnerbone using the debug screen.
-
Rockenroll4life using the debug screen.
-
Ditto.
-
Door block data in the debug screen.
-
Redstone block data in the debug screen.
-
Tripwire hook block data in the debug screen.
Notes
[edit | edit source]References
[edit | edit source]- ↑ https://www.minecraft.net/en-us/article/minecraft-snapshot-24w04a
- ↑ http://gaming.stackexchange.com/questions/14990/minecraft-debug-screen
- ↑ http://www.minecraftforum.net/viewtopic.php?f=35&t=13231
- ↑ "Very useful runtime performance profiling with PIE CHARTS: http://i.imgur.com/ZuJXC.png" – @notch (Markus Persson) on X (formerly Twitter), October 2, 2011