/debugconfig

Not to be confused with Commands/debugmobspawning or Commands/debugpath.
This feature is exclusive to Java Edition.
 
This feature is intended for debugging purposes only, and should not be used during normal play. It might cause crashes and corrupt world saves.
/debugconfig
Permission level
required

3

Restrictions

Dedicated server and
-DMC_DEBUG_DEV_COMMANDS debug property

/debugconfig is a command that can be enabled with the debug property -DMC_DEBUG_DEV_COMMANDS. It allows sending a player back to configuration phase.

Syntax

debugconfig config <target>

Removes the target player's avatar from the world and switches their connection back to the configuration phase. While in this state, the player's client sees a "Reconfiguring..." screen with a "Disconnect" button that is initially grayed out, and is enabled after 20 seconds.

debugconfig unconfig <target>

Fully connects the player with the target UUID back into the server, if a player with the target UUID is connected and in the configuration phase.

debugconfig dialog <target> <dialog>

Shows the player with the target UUID the specified dialog, if a player with the target UUID is connected and in the configuration phase.

Arguments

<target>: entity

Only for debugconfig config. Specifies the target player to switch to the configuration phase.
Must be a player name, a target selector or a UUID. And the target selector must be of single-player type.

<target>: uuid

Only for debugconfig unconfig and debugconfig dialog. Specifies the UUID of a connected player in the configuration phase to fully connect to the server or to show a dialog to.
Must be a UUID in the hyphenated hexadecimal format. Allowed characters include: -, A-F, a-f, and 0-9.

<dialog>: dialog

Specifies the dialog to show to a player in the configuration phase.
Must be either:
  • A namespaced ID of a dialog defined in a data pack (e.g., custom:my_dialog or minecraft:server_links). These are stored in the minecraft:dialog registry.
  • An inline SNBT defining the dialog structure directly in the command. See Dialog § Dialog format for the structures.

Result

CommandTriggerJava Edition
AnyThe command is incomplete, or any argument is not specified correctly. Unparseable
OtherwiseSuccessful

Output

CommandEditionSituationSuccess Count/execute store success .../execute store result ...
/debugconfig config <target>Java EditionOn success111
/debugconfig unconfig <target>On success111 if a player in the configuration phase was found and fully connected, 0 otherwise
/debugconfig dialog <target> <dialog>On success111 if a player in the configuration phase was found and shown a dialog, 0 otherwise

History

Java Edition
1.21.9Pre-Release 1Added debug property -DMC_DEBUG_DEV_COMMANDS, making the command accessible in the vanilla game.

Navigation