Debug mode

From Minecraft Wiki
Jump to: navigation, search
The world generation in 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.

Accessing[edit | edit source]

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.

Upon selecting debug mode, the "Bonus Chest", "Generate Structures", and "Allow Cheats" options are removed from the menu. The game mode is set to Spectator, and the difficulty is locked on peaceful; however, /gamemode and /difficulty will work as usual within the world.

Properties[edit | edit source]

The entire grid as seen from above (14w32d1.8.8). East is up.
The entire grid as seen from above (15w35a15w40b)[upcoming]. East is up.

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. Every block state generates only once. The remainder of the map is empty.

Breaking any block, including those in the barrier floor, is impossible in this mode. Likewise, placing blocks is impossible, and the commands /setblock, /clone and /fill are unavailable. Some blocks allow right-click interactions (e.g. chests, beds, cake, and generally speaking, those interactions which do not change any block state), while others do not (e.g. levers, redstone repeaters). A block's state cannot change, but its block entity data can change, for instance through using /blockdata or through normal player interaction. When /summon FallingSand is used, the FallingSand entity instantly despawns.

The block grid is approximately 180×180 in size, occupying the +X,+Z (southeast) quadrant, although the barrier floor extends past the grid in all directions to the world border. Starting at 0,0, the blocks are arranged first in rows of 89 block states from north to south, then in 87 rows from west to east (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 7,806 block states.

As of snapshot 15w35a for 1.9[upcoming], the block grid is approximately 146×150 in size. The blocks are arranged in 73 rows of 75, with an additional partial row of 12 states. The southernmost (75th) column contains duplicates of 73 states from the northernmost column. There are 5,414 unique block states. 2,560 fire states have been eliminated, 10 states for the original command block have been added, and 158 additional states representing new blocks have been added.

Video[edit | edit source]

History[edit | edit source]

Official release
1.8 14w26a Added Debug Mode world type
Block entity graphics would disappear when block is hit, door and trapdoor hitboxes were inconsistent with their state, and not all interfaces were accessible.
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.
1.9 15w31a All interfaces are now accessible.
15w37a Block entity graphics are now regenerated (and set to default), when the block is hit.
15w38a Door and trapdoor hitboxes are now consistent with their state.

Issues[edit | edit source]

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.

Trivia[edit | edit source]

  • The biome is plains (except when in the Nether or the End).
  • 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.
  • In game modes which normally allow blocks to be broken, if the player attempts to break a block, all the usual signs will occur – the player's arm swings, cracks appear, and block-breaking particles spill out – except that the block remains unbroken.
  • Water and lava cannot be removed by buckets, but will fill an empty bucket in survival mode.
  • Cauldrons will clean leather armor and banners, but cannot be filled by buckets.
  • The inventories of chests (normal, ender or trapped), anvils and crafting tables are usable, but those of furnaces, dispensers, droppers, hoppers, enchantment tables, brewing stands and beacons are unavailable. The anvil, when used, will never lose durability. All inventories are usable in 1.9[upcoming].
  • Either TNT block will drop a primed TNT when activated by flint and steel.
  • Using a button or lever will drop one of itself as an item.
    • Activating those blocks schedules a block tick for its own block, which drops one of itself because those blocks cannot be suspended in mid-air.
  • Using an unactivated pressure plate will cause it to generate enormous quantities of dropped plates, make weird noises, and likely crash the game.
    • The pressure plate schedules a block tick for itself, which drops an item because it cannot be suspended in mid-air.
    • Since it never changes to an activated pressure plate, it never stops receiving activation from the entity or the items on it, and never stops scheduling block ticks.
    • Certain pressure plates, when activated, cause an error in the game output, stating that the dropped item entity has no entity.
  • Using a comparator in subtract mode, a lever or an unpowered button will cause the block in the direction opposite its facing property to drop as an item. If that block is a repeater or a comparator, it will drop 36 stacks of itself.
    • These types of blocks schedule a block tick in the adjacent block.
    • If that block could not normally remain suspended in the air, it will drop one of itself as an item.
    • If it is a repeater or a comparator, it will start to repeatedly schedule its own block-state-changing tick, which will fail continually a large number of times.
  • Rails and minecarts operate as usual.
  • Certain doors, fence gates, glass panes, iron bars and fences have incorrect hitboxes. Door and fence gate hitboxes are correct in 1.9[upcoming].
  • Breaking a sign, an end portal, an end gateway[upcoming 1.9], a chest, or an ender chest will make it invisible, but will preserve all other interactions. Similarly, breaking the enchanting table will render the book invisible, and breaking the mob spawner will cause the pig and its fire particles to disappear. These effects do not occur in 1.9[upcoming]. The banners are invisible to begin with.
  • If a Nether or End portal is used, the player will spawn in a Nether version or an End version of the debug world, respectively. The sky, light level and other properties will be appropriate to the dimension. In the End, the Ender Dragon is present flying around, though it does not break or interact with blocks. If the End portal is used in the End, the end credits will appear. The end gateway block[upcoming 1.9] does not teleport the player, no matter the dimension.
  • If you open or close the doors or trapdoors, they will not move, but you will still hear the sound.

Gallery[edit | edit source]