Minecraft:Debug screen
More actions
 |
For the {{{Description}}} of the same name, see [[{{{Destination}}}]]. |
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 Template:Key is pressed.
The debug screen consists of info text lines and five toggleable graphs: profiler, frame rate, Minecraft:tick rate, bandwidth, and ping time graphs.
Information lines
The debug screen consists of 28 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 Template:Key:
- "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 Template:Gmr 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 Template:Nowrap is set to true | |
|---|---|---|---|---|---|
| Default profile |
Performance profile | ||||
| biome | Biome: biome
|
Displays in which Minecraft:biome the player is.
|
Template:Tc | Template:Tc | Template:Tc |
| 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.
|
Template:Tc | Template:Tc | Template:Tc |
| chunk_render_stats | C: C (s) D: D, pC: pC, pU: pU, aB: aB
|
Displays information about loaded Minecraft:chunks.
|
Template:Tc | Template:Tc | Template:Tc |
| chunk_source_stats | Chunks[C] W: W1, W2 E: E1,E2,E3
|
Displays information about client-side chunks.
|
Template:Tc | Template:Tc | Template:Tc |
| day_count | Day #DAY
|
Displays the number of days that have elapsed in the world.
|
Template:Tc | Template:Tc | Template:Tc |
| entity_render_stats | E: E/T, SD: SD
|
Displays information about loaded Minecraft:entities.
|
Template:Tc | Template:Tc | Template:Tc |
| entity_spawn_counts | SC: SC, M: M, C: C, A: A1, A: A2, U: U, W: W1, W: W2, M: MTemplate:UntilSC: SC, M: M, C: C, AM: A1, AX: A2, U: U, W: W1, W: W2, M: MTemplate:Upcoming
|
Displays the amount of entities that count toward the Minecraft:mob cap.
|
Template:Tc | Template:Tc | Template:Tc |
| fps | FPS fps T: T vsyncTemplate:Until
|
Displays the framerate.
|
Template:Tc | Template:Tc | Template:Tc |
| game_version | Minecraft V (V/M/S)
|
Displays the game version.
|
Template:Tc | Template:Tc | Template:Tc |
| gpu_utilization | GPU: GPU%
|
Displays the Template:W utilization.
|
Template:Tc | Template:Tc | Template:Tc |
| 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 Minecraft:heightmaps at the player's position. The SH line displays values of the corresponding server-side heightmaps at the player's position.
|
Template:Tc | Template:Tc | Template:Tc |
| light_levels | Client Light: L (S sky, B block)
|
Displays the client-side Minecraft:light values at the player's feet.
|
Template:Tc | Template:Tc | Template:Tc |
| local_difficulty | Local Difficulty: D // C
|
Displays Minecraft:local difficulty-related values.
|
Template:Tc | Template:Tc | Template:Tc |
| looking_at_block_state | Targeted Block: CBS
|
Displays information about the targeted Minecraft:block.
|
Template:Tc | Template:Tc | Template:Tc |
| looking_at_block_tags | T
|
Displays the list of tags containing the targeted block (one line per tag). | Template:Tc | Template:Tc | Template:Tc |
| looking_at_entity | Targeted EntityE
|
Displays the Minecraft:identifier of the targeted Minecraft:entity. | Template:Tc | Template:Tc | Template:Tc |
| looking_at_entity_tags | T
|
Displays the list of tags containing the targeted entity (one line per tag). | Template:Tc | Template:Tc | Template:Tc |
| looking_at_fluid_state | Targeted Fluid: CBS
|
Displays information about the targeted Minecraft:fluid.
|
Template:Tc | Template:Tc | Template:Tc |
| looking_at_fluid_tags | T
|
Displays the list of tags containing the targeted fluid (one line per tag). | Template:Tc | Template:Tc | Template:Tc |
| 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.
|
Template:Tc | Template:Tc | Template:Tc |
| particle_render_stats | P: P
|
Displays the number of particles in the loaded area. | Template:Tc | Template:Tc | Template:Tc |
| 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
|
|
Template:Tc | Template:Tc | Template:Tc |
| player_section_position | Section-relative: X Y Z
|
Displays the relative coordinates of the block the player's feet are in within the chunk. | Template:Tc | Template:Tc | Template:Tc |
| post_effect | Template:Info needed | Template:Info needed | Template:Tc | Template:Tc | Template:Tc |
| simple_performance_impactors | C B: BFiltering: F
|
Displays various video setting options.
|
Template:Tc | Template:Tc | Template:Tc |
| sound_mood | Sounds: S1 + S2 (Mood M%)
|
Displays how many Minecraft:sounds are being played and the Minecraft:mood value.
|
Template:Tc | Template:Tc | Template:Tc |
| system_specs | Java: JAVA VERSIONCPU: THREAD NAME CORES SPEEDDisplay: RES (VENDOR)GRAPHICS CARD GRAPHICS CARD INFOOpenGL OPENGL VERSION RENDERER
|
Displays various computer specifications.
|
Template:Tc | Template:Tc | Template:Tc |
| tps | BRAND server @ MST ms, UP tx, DOWN rx
|
Displays information about the Minecraft:server.
|
Template:Tc | Template:Tc | Template:Tc |
Graphs
Profiler graph
Template:Info needed section The profiler graph, known informally as the pie chart, can be toggled using Template:Key (previously Template:Key) and displays profiling information. To access a sub-section, press Template:Key + Template:Key, 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
The frame rate graph (or simply FPS graph) displays on the left side of the screen when enabled with Template:Key (previously Template:Key). 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 Template:Ws for the last 240 frames are shown on top.
The colors are on a gradient from neon green (good) (Template:Color) through yellow (Template:Color) to neon red (bad) (Template:Color).
TPS graph
The tick rate graph (or simply TPS graph) displays on the right side of the screen when enabled with Template:Key if in Minecraft:singleplayer or playing as an Minecraft:operator on a server. It shows the last 240 Minecraft: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<ref>https://www.minecraft.net/en-us/article/minecraft-snapshot-24w04a</ref>:
- 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
The bandwidth graph displays on the left side of the screen when enabled with Template:Key. 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
The ping graph displays on the right side of the screen when enabled with Template:Key. 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) (Template:Color) through yellow (Template:Color) to neon red (bad) (Template:Color).
History
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 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">Previously used as the number of entities removed due to hidden chunks during Minecraft:Indev. It was removed in snapshot Minecraft:24w33a as being considered to be completely redundant.</ref> |
| 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 Minecraft:Overworld sea level, 11 (10.9) is Overworld lava flood level, 32 (31.9) is Minecraft: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 Minecraft:chunk the player is in (uses cubic chunk sections, so heights display in multiples of 16 minus 1). |
| b | Shows the player what Minecraft:biome they are in. |
| bl | (for "block light") The amount of Minecraft:light from other Minecraft:blocks (e.g. Minecraft: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 Minecraft:slabs. When above the void (where there is no block), it equals 0. |
| shader | The file path of the currently-active Minecraft:shader (within the "assets" directory of Minecraft:minecraft.jar). Displayed only if a shader is active. |
Issues
Trivia
- The biome and lighting values do not display when the player is outside of the build limits.
- Deeper into the profiler (Template:Key), 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
Historical screenshots
Most of these screenshots show debug screen exclusively used by the Minecraft: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<ref>Template:Tweet</ref>
-
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
References
External links
Template:Navbox Java Edition technical
Minecraft:de:Debug-Bildschirm Minecraft:es:Pantalla de desarrollo Minecraft:fr:Écran de débogage Minecraft:ja:デバッグ画面 Minecraft:ko:디버그 화면 Minecraft:nl:Debug-scherm Minecraft:pl:Ekran debugowania Minecraft:pt:Tela de depuração Minecraft:ru:Экран отладки Minecraft:uk:Екран налагодження Minecraft:zh:调试屏幕