Minecraft:Debug property

Template:Exclusive Template:Debug warning Debug properties or debug flags are JVM properties that enable various debug features in the game.

Usage

To enable debug features, JVM properties must be set when launching the game. To enable any feature, the global flag Template:Cd must be set. Then a specific feature can be enabled using Template:Cd or Template:Cd flag.

List of debug properties

Name	Description
Template:Nbt ENABLED	Enables the effects of all properties listed below.
Template:Nbt PRINT_PROPERTIES	Prints all available debug properties to the output log on startup.
Template:Nbt OPEN_INCOMPATIBLE_WORLDS	Allows opening worlds otherwise deemed incompatible without confirmation, such as from Minecraft:April Fools' versions.
Template:Nbt ALLOW_LOW_SIM_DISTANCE	Allows setting the client Minecraft:simulation distance to a value as low as Template:Cd, instead of Template:Cd.
Template:Nbt HOTKEYS	Adds additional Minecraft:debug hotkeys. See Template:Slink for the full list.
Template:Nbt UI_NARRATION	Allows narration code to run even when the text-to-speech library cannot load the operating system's narrator (as long as the operating system is supported).
Template:Nbt SHUFFLE_UI_RENDERING_ORDER	Constantly shuffles the rendering order of many UI elements.
Template:Nbt SHUFFLE_MODELS	Constantly shuffles the render order of entity and block entity model elements.
Template:Nbt RENDER_UI_LAYERING_RECTANGLES	Renders bounding boxes for UI elements as translucent blue rectangles.
Template:Nbt PATHFINDING	Enables debug rendering of the pathfinding of mobs.
Template:Nbt SHOW_LOCAL_SERVER_ENTITY_HIT_BOXES	Extends the entity Minecraft:hitbox debug renderer with the hitbox as seen by the server (only works in singleplayer).
Template:Nbt SHAPES	Renders the general shape (white), Minecraft:collision box (gray), occlusion shape (green, the part of the block that occludes other blocks for culling) and Minecraft:interaction box (blue) of the targeted block.
Template:Nbt NEIGHBORSUPDATE	Enables debug rendering showing the amount of Minecraft:block updates each block received in a single tick the last time it got updated, using white, shrinking cubic outlines with an accompanying number representing the number of block updates in that specific coordinate, that persist for 10 seconds until ultimately disappearing.
Template:Nbt EXPERIMENTAL_REDSTONEWIRE_UPDATE_ORDER	Enables debug rendering of the orientation of Minecraft:redstone wire when the "Minecraft:Redstone Experiments" experiment is enabled. Shows the forward (blue), side (yellow), and up (red) directions of each redstone wire update.
Template:Nbt STRUCTURES	Enables debug rendering of the bounding boxes of Minecraft:structures and structure pieces.
Template:Nbt GAME_EVENT_LISTENERS	Highlights blocks and entities that listen to game events. When a game event occurs, its origin position is shown along with the game event type.
Template:Nbt DUMP_TEXTURE_ATLAS	Dumps all texture atlases to the .minecraft/screenshots/debug directory on every resource load or reload, similarly to the Template:Key + Template:Key debug keybind.
Template:Nbt STRUCTURE_EDIT_MODE	When loading a Minecraft:structure file in a Minecraft:structure block, Minecraft:structure voids are preserved. Also, containers with random loot do not get the Template:Nbt field set. This allows re-saving the structure file without modifications.
Template:Nbt SAVE_STRUCTURES_AS_SNBT	When saving a structure using a Minecraft:structure block, the structure is saved as SNBT in a .snbt file, instead of NBT in a .nbt file.
Template:Nbt SYNCHRONOUS_GL_LOGS	Sets the GL_DEBUG_OUTPUT_SYNCHRONOUS OpenGL flag. See the OpenGL docs and LWJGL docs for details. Requires OpenGL 4.3 or later.
Template:Nbt VERBOSE_SERVER_EVENTS	Adds lines in the game log: When a chunk's load level changes. When a new chunk task (new chunk generation, light engine, or player load) is submitted. When the game computes chunk load levels. When a chunk's lighting is updated. When a chunk is sent to a client. When a chunk load ticket is added. When a chunk load ticket is removed.
Template:Nbt NAMED_RUNNABLES	Adds debugging names to certain Runnable and Supplier objects, useful for modders and developers. Has no effect on the vanilla game.
Template:Nbt GOAL_SELECTOR	Displays the goals of most Minecraft:mobs above their head, highlighting the currently running goals in green. Goal names are not readable without modding due to obfuscation.
Template:Nbt VILLAGE_SECTIONS	Highlights chunk sections within the bounds of a Minecraft:village.
Template:Nbt BRAIN	Displays information about the brain AI of Minecraft:villagers, Minecraft:armadillos, Minecraft:frogs, Minecraft:goats, Minecraft:sniffers, Minecraft:camels, Minecraft:axolotls, Minecraft:allays, Minecraft:breezes, Minecraft:piglins, Minecraft:piglin brutes, Minecraft:hoglins, Minecraft:zoglins, Minecraft:tadpoles, Minecraft:wardens, Minecraft:creakings, Minecraft:happy ghasts, and Minecraft:copper golems.
Template:Nbt POI	Visualizes the location of points of interest and shows data about them.
Template:Nbt BEES	Renders the goals of bees like with brains, and assigns each bee a unique, randomly generated name. When a bee seeks for a flower to pollinate, that flower is highlighted with a yellow transparent cube with the name of said bee attached to it, and beehives list the names of bees that are expected to return. Names are unique and randomly constructed using a prefix and a suffix based on their UUID.
Template:Nbt RAIDS	Displays the following information about Minecraft:raids: Raid center position Raid wave number in the bossbar Number of raiders alive in the bossbar If the wave is an extra wave in the bossbar Raid status (ongoing, victory, loss, or stopped) in the bossbar
Template:Nbt BLOCK_BREAK	Adds lines in the game log when the player starts, aborts, or completes the breaking of a block, and when receiving a block breaking event from the server.
Template:Nbt MONITOR_TICK_TIMES	Whenever a single tick takes longer than 300ms, saves profiler results to debug/Renderer (if on the client), or debug/Server (if on the server).
Template:Nowrap	Prevents replacing Minecraft:jigsaw blocks when generating Minecraft:jigsaw structures.
Template:Nbt DONT_SAVE_WORLD	Disables saving Minecraft:chunks, entities (excluding Minecraft:players), and points of interest to disk. This results in all chunks to be regenerated every time they get reloaded, and all player modifications to be deleted. Minecraft:Advancements, Minecraft:statistics, active Minecraft:raids, Minecraft:world borders, random sequences, and everything in level.dat are still saved.
Template:Nbt LARGE_DRIPSTONE	When generating large dripstone features: Replaces all Minecraft:dripstone blocks with glass. Places a diamond block at the top of the stalactite and a gold block at the bottom of the stalagmite. Places creeper heads in the empty space between the stalactite and the stalagmite.
Template:Nbt CARVERS	Enables debug_mode for all cave carvers. For vanilla worldgen: Fills the area carved with crimson buttons (cave carvers), oak buttons ("extra underground" cave carvers), or warped buttons (canyon carvers). Places candles in water. Replaces lava with orange stained glass. Places glass on the barrier between aquifers and the carved area.
Template:Nbt ORE_VEINS	Generates oak buttons instead of the filler blocks when generating Minecraft:ore veins. No other blocks are generated other than structures and bodies of water and lava.
Template:Nbt SCULK_CATALYST	Stores additional statistics in the Minecraft:sculk catalyst block entity data about the total, single maximum value and average cursor charge, as well as how many cursors are present. Template:Nbt stats.total: The sum of all sculk charge experience. Template:Nbt stats.count: The number of sculk charges. Template:Nbt stats.max: The amount of experience stored in the largest sculk charge. Template:Nbt stats.avg: The average experience stored across all sculk charges.
Template:Nbt BYPASS_REALMS_VERSION_CHECK	Bypasses all Minecraft:Realms availability checks, including version checking, authentication, and whether the user is allowed to access Realms. This only allows opening the Realms menus and cannot be used to join Realms without authentication.
Template:Nbt SOCIAL_INTERACTIONS	Allows opening the Minecraft:social interactions menu in singleplayer. Adds the current player and any blocked players to the reporting screen. Allows opening the report screen even if chat is disabled due to options, a launcher argument, or Minecraft account settings.
Template:Nbt CHAT_DISABLED	In multiplayer servers, acts as if chat is disabled in the user's account settings.
Template:Nbt VALIDATE_RESOURCE_PATH_CASE	Forces resource packs to only load files if the case matches exactly (for example, if a resource pack tries to find path/to/file.json but the file is actually at path/to/File.json, it will fail). If the file is on a different file system type than the system's default (such as the file system for loading files bundled with the game's JAR file), validation is skipped.
Template:Nbt UNLOCK_ALL_TRADES	Minecraft:Villagers immediately choose and unlock trades up to their max level.
Template:Nbt BREEZE_MOB	Draws a blue line from every Minecraft:breeze to its current target, and draws three concentric rings around it: a green ring with radius 4, an orange ring with radius 8, and a red ring with radius 24. A breeze must be within the green and red ring (4-24 blocks) to jump, and it will pick a block to jump to within the green and orange rings (4-8 blocks). The breeze's jump target is highlighted in red, and a pink line is drawn from the breeze to its jump target.
Template:Nbt TRIAL_SPAWNER_DETECTS_SHEEP_AS_PLAYERS	Makes Minecraft:trial spawners react to nearby sheep instead of players.
Template:Nbt VAULT_DETECTS_SHEEP_AS_PLAYERS	Makes Minecraft:vaults react to nearby sheep instead of players.
Template:Nbt FORCE_ONBOARDING_SCREEN	Shows the accessibility onboarding screen on game startup, even if this is not the first startup.
Template:Nbt CURSOR_POS	Shows the current cursor coordinates below the cursor, with (0, 0) being the top left of the Minecraft window.
Template:Nbt DEFAULT_SKIN_OVERRIDE	Disables custom Minecraft:skins, causing all players to have a default skin.
Template:Nbt PANORAMA_SCREENSHOT	Allows pressing Template:Key + Template:Key to capture a panoramic screenshot. Saved as panorama_0.png to panorama_5.png in the screenshots folder, overwriting any previously captured panoramic screenshot.
Template:Nbt CHASE_COMMAND	Enables the Template:Cmd command.
Template:Nbt VERBOSE_COMMAND_ERRORS	Instead of printing "An unexpected error occurred trying to execute that command", prints the error message and logs the exception stack trace.
Template:Nbt DEV_COMMANDS	Enables the Template:Cmd, Template:Cmd, Template:Cmd, Template:Cmd, Template:Cmd, and Template:Cmd commands. On a dedicated server also enables the Template:Cmd command.
Template:Nbt ACTIVE_TEXT_AREAS	Highlights text components rendered in the UI. The highlights alternate between light and dark colors every character. Normal text is highlighted in blue. Text with a click_event tag is highlighted in light purple. Text with a hover_event tag is highlighted in aqua. Text with both click_event and hover_event tags is highlighted in yellow.
Template:Nbt PREFER_WAYLAND	On linux, when both X11 and Wayland are available, prefer Wayland instead of X11.
Template:Nbt IGNORE_LOCAL_MOB_CAP	Mob spawns ignore the local, per-player mob cap. The global mob cap is not ignored.
Template:Nbt DISABLE_LIQUID_SPREADING	Disables the flowing of Minecraft:liquids.
Template:Nbt AQUIFERS	At positive Z coordinates, places strips of slime blocks (below sea level) and honey blocks (above sea level) marking the position 8 blocks above the preliminary surface height.
Template:Nbt JFR_PROFILING_ENABLE_LEVEL_LOADING	Automatically enables JFR profiling for the level loading, and stops when level loading is complete.
Template:Nbt ENTITY_BLOCK_INTERSECTION	Highlights blocks in green that intersect an entity, e.g. when a chicken is standing inside tall grass. Also highlights all air blocks in grey that the player touched recently.
Template:Nbt GENERATE_SQUARE_TERRAIN_WITHOUT_NOISE	Only generates terrain between 0, 0 and 8207, 1039. In the Overworld, generates simplified terrain where: Desert and badlands biomes generate when erosion noise matches certain ranges. Snowy taiga biomes generate when continentalness noise matches certain ranges. Plains biomes generate everywhere else.
Template:Nbt ONLY_GENERATE_HALF_THE_WORLD	Only generate blocks with Z ≥ 0. Minecraft:Features may extend into negative Z positions. Liquids can't flow onto blocks with Z < 0. If WORLD_RECREATE is also enabled, the spawn point is set to 0, -100.
Template:Nbt DISABLE_FLUID_GENERATION	Disables fluid generation. Minecraft:Features and structures can still generate fluids.
Template:Nbt DISABLE_AQUIFERS	Disables Minecraft:aquifer generation.
Template:Nbt DISABLE_SURFACE	Disables Minecraft:surface rules, causing the Overworld to generate without its surface grass and dirt layers.
Template:Nbt DISABLE_CARVERS	Worlds generate without cave carvers.
Template:Nbt DISABLE_STRUCTURES	Worlds generate without structures.
Template:Nbt DISABLE_FEATURES	Disables Minecraft:feature generation. Minecraft:Explorer maps will not try to find nearby structures.
Template:Nbt DISABLE_ORE_VEINS	Disables Minecraft:ore vein generation.
Template:Nbt DISABLE_BLENDING	Disables easing the transition between chunks generated in different versions, known as blending. Also disables scheduling ticks for blocks in old chunks on the border of a newly generated chunk to assist with blending.
Template:Nbt DISABLE_BELOW_ZERO_RETROGENERATION	Worlds created before 1.18 will not generate caves under the old bedrock floor.
Template:Nbt SUBTITLES	Shows IDs of Minecraft:sound events for the subtitles, and a warning when a sound event is missing.
Template:Nbt FAKE_LATENCY_MS	Introduces artificial latency between the client and server, similar to slow internet connections.
Template:Nbt FAKE_JITTER_MS	Introduces a random artificial latency within 0 and jitter - 1 milliseconds between the client and server, similar to slow internet connections.
Template:Nbt COMMAND_STACK_TRACES	Adds stack traces to Minecraft:Brigadier CommandSyntaxException, allowing developers to investigate the code path before the exception occurred.
Template:Nbt WORLD_RECREATE	Adds a "DEBUG recreate" button to the world selection screen, that creates a world with name "DEBUG world" (deleting a world with that name if it already exists) with seed "test1" (110251487) in Minecraft:Spectator mode. Changes the default values for the Template:Cd and Template:Cd Minecraft:game rules to Template:Cd in all new worlds.
Template:Nbt SHOW_SERVER_DEBUG_VALUES	Adds server-side biome and light levels to the Minecraft:debug screen, and replaces the client-side looking at block/fluid values with server-side values.
Template:Nbt FEATURE_COUNT	Keeps track of how many times features were placed over time. Press Template:Keys to print feature counts and other debugging information in the following order: Whether the dimension is "running" or "dead". The dimension. The number of times the feature was placed. The average feature placements per chunk. The Minecraft:placed feature used for biome checking, may or may not be present. The Minecraft:configured feature. The Minecraft:feature itself that was placed. Press Template:Keys to reset the feature placement counts.
Template:Nbt FORCE_TELEMETRY	Forces recording telemetry data when the game is run in an IDE. Has no effect in the vanilla game.
Template:Nbt DONT_SEND_TELEMETRY_TO_BACKEND	Disables sending any telemetry to Mojang servers when the game is run in an IDE. Has no effect in the vanilla game.
Template:Nbt SIMULATE_LIBRARY_LOAD_FAILURETemplate:Upcoming	Simulates a library load failure.