Debug mode

From Minecraft Wiki
Jump to: navigation, search
The world creation using the debug mode

Debug mode is a world type used to test block models, states and textures. It is thereby useful not only to Mojang but also to creators of resource packs.


To select the debug mode, hold the ⇧ Shift key while clicking the "World Type" button. Debug mode will then be the world type directly after Customized, and just before Default.


Debug mode contains all Minecraft blocks in all their different block states in a single world, in a grid across height y=70, with a barrier floor at y=60.

When choosing this world, the only game mode available is Spectator, and further options (such as generated structures, bonus chest, etc.) are unavailable; however, the game mode can be changed from inside the world with console commands. Breaking blocks is possible in game modes which normally allow blocks to be broken; however, any blocks broken will instantly regenerate. Meanwhile, placing blocks is impossible, and the commands /setblock, /clone and /fill are unavailable. Some blocks allow right-click interactions (e.g. chests, beds, and especially those blocks whose interactions do not change any block state), while others do not (e.g. levers, redstone repeaters).

If a Nether or End portal is used, the player will spawn in a Nether version of the debug world or the End credits will appear, depending on the portal used. If the End is reached through the Nether, an End version of the debug world generates, with the Ender Dragon flying around.

The block grid is approximately 180×180 in size, occupying the +X,+Z quadrant, although the barrier floor extends past the grid to the world border at X/Z ±29,999,984. Starting at 0,0, the blocks are arranged first in rows of 89 block states from north to south, then in 87 rows from east to west (with an additional partial row of 63 states), following first the numerical data values of the blocks, then the block state names and values in alphanumeric order. There are a total of 7806 block states.



Official release
1.8 14w26a Added Debug Mode world type.
14w27a Different block states are used instead of metadata.
Options are disabled when creating the world, and the only game mode available is Spectator Mode.
Block states generate in a square pattern rather than in an infinite repeating grid.
14w32a Duplicate block states along the southern edge are eliminated.


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

Note that any bugs relating to using other game modes than spectator are resolved as invalid due to the fact that the world type can only be legitimately accessed in spectator.


  • Every block state generates only once. The remainder of the map is empty.
  • Below the blocks the ground seems to be made of barriers, but as soon as one is broken another is placed, so you cannot pass through without using spectator mode.
  • The sun is displayed as if it were the beginning of day (time 1000), but there is no day/night cycle. The daytime can be adjusted, and the day/night cycle can be toggled as usual using console commands. The time can be advanced to sunrise by using a bed.
  • The biome is plains (except when in the Nether or the End).
  • Breaking a sign, a chest or an ender chest will make it invisible, but will preserve all other interactions. Similarly, breaking an enchanting table will render the book invisible. The banners are invisible to begin with.
  • Activating a button or lever will cause it to drop one of itself as a resource. Activating a pressure plate will cause it to generate enormous quantities of dropped plates, make weird noises, and likely crash the game.
  • By traveling through the end portal the sky will be dark, like the End, but it does not generate the 'normal' End, it generates a 'Debug-world-end' (see picture below in gallery)