minecraft
This article is about the world type. For other uses, see Debug.
Information icon
This feature is exclusive to Java Edition. 
The world generation in an SUPER early version of debug mode

The world generation in an SUPER early version of debug mode

Debug mode usually refers to a world preset used to test block states, block models, and textures.

Debug mode can also refer to a dimension generator type (minecraft:debug) that generates a blocks grid, which is used in the "Debug mode" world preset, and can also be used in custom dimension.

Debug mode can also refer to a state of a world, if the overworld uses the "debug" generator, the world goes into the debug mode state. In this state, blocks can't be changed even in creative mode or with commands.

Debug Mode World Preset

Debug mode selected; note that all of the other world settings are unavailable.

Debug mode selected; note that all of the other world settings are unavailable.

To select the debug mode, hold the Alt key while clicking the "World Type" button in the world creation menu. Debug mode is the world type directly after Single Biome, and just before default preset.

Upon selecting debug mode, the "Bonus Chest", "Generate Structures", "Allow Cheats" and "Data Pack" options are removed from the menu. The game mode is set to Spectator, and the difficulty is locked on peaceful, and cheats are enabled. The game rule doDaylightCycle is forced to false, while other game rules are forced to default value.

Debug Generator

The minecraft:debug generator contains all blocks, in all of their existing block states, organized in a single world. The world updates automatically to include any new registered block IDs that are added. Therefore, this mode is useful not only to Mojang developers, but also to creators of resource packs and mods.

Block grid

Every block state generates only once. They are sorted in a grid spread across an altitude of y=70. The block grid changes its size according to the number of blocks and block states available, roughly resembling a square (as of 1.14.2, 213 in width and 211 eastward), occupying the +X,+Z (southeast) quadrant.[1]

A barrier floor at y=60 also spawns, extending past the grid in all directions to the world boundary. Other than the barrier floor, the remainder of the map is empty.

Debug Mode State

Debug mode can refer to a state of the world. If the Overworld uses the "debug" generator, the world goes into the debug world state.

World Generation

View of the Nether debug world

View of the Nether debug world

View of the End debug world

View of the End debug world

If a Nether portal or End portal is used, or teleported using /execute, the player enter other dimensions. The sky, light level and other properties remain appropriate to the dimension.

In this state, all the dimensions are forced to use the "debug" generator. The chunk rendering may not update by itself in these dimensions, resulting in the need to right-click a block to render a new chunk.

In the vanilla End, the ender dragon and its end crystals still spawn, although the dragon cannot break or interact with blocks.

World behavior

It is impossible to change, place or remove any block, even by the game itself.

Chunk's chunk tick (including random ticks) does not execute.

No entity spawns naturally.

Any block whose interactions do not change its block state can still be used (including chests, beds, cake, etc.). Although a block's state cannot change, its block entity data can change, either through normal player interaction or with the use of the /data command.

These unique properties of debug mode can cause certain blocks to behave in unexpected ways, though due to the arrangement of blocks next to one another, not all may be seen in every version:

History

Java Edition
1.814w26aAdded Debug Mode world type.
Block entity graphics would disappear when a block is hit, door and trapdoor hitboxes were inconsistent with their state, and not all interfaces were accessible.
14w27aDifferent block states are used instead of metadata.
Options are disabled when creating the world, and the only game mode you can get upon world creation is Spectator Mode.
Block states now generate in a square pattern rather than in an infinite repeating grid.
1.915w31aAll interfaces are now accessible.
15w37aBlock entity graphics are now regenerated (and set to default), when the block is hit.
15w38aDoor and trapdoor hitboxes are now consistent with their state.
1.1620w22aBlocks in the debug world have been changed to be breakable and interactable with, unlike previously where they would regenerate and the world would not be able to be modified.[2]
Pre-release 1Blocks now reappear again.
1.1720w46aAlt is now used instead of ⇧ Shift to access debug mode in the world creation menu.

Issues

Note that any bugs relating to using game modes other than spectator are resolved as "Invalid" or "Won't Fix" due to the fact that the world type can be legitimately accessed only in spectator.

Issues relating to "Debug mode" are maintained on the bug tracker. Report issues there.

Trivia

Gallery

Referance

  1. Due to a bug (MC-122412 — resolved as "WON'T FIX".), the block grid was not a correct square, and in some versions the blocks in the southernmost and northernmost columns duplicate, and whether duplication occurs is related to the total number of block states.
  2. MC-184638