/debugconfig
< Commands
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 |
{
"title": "<code>/debugconfig</code>",
"rows": [
{
"field": "3",
"label": "(link to Permission level article, displayed as Permission level<br>required)"
},
{
"field": "Dedicated server and <br /><code>-DMC_DEBUG_DEV_COMMANDS</code> (link to debug property article, displayed as debug property)",
"label": "(link to Commands#Restrictions article, displayed as Restrictions)"
}
],
"invimages": [],
"images": []
}
/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 unconfiganddebugconfig 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, and0-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_dialogorminecraft:server_links). These are stored in theminecraft:dialogregistry. - An inline SNBT defining the dialog structure directly in the command. See Dialog § Dialog format for the structures.
- A namespaced ID of a dialog defined in a data pack (e.g.,
Result
| Command | Trigger | Java Edition |
|---|---|---|
| Any | The command is incomplete, or any argument is not specified correctly. | Unparseable |
| Otherwise | Successful |
Output
| Command | Edition | Situation | Success Count | /execute store success ... | /execute store result ... |
|---|---|---|---|---|---|
/debugconfig config <target> | Java Edition | On success | 1 | 1 | 1 |
/debugconfig unconfig <target> | On success | 1 | 1 | 1 if a player in the configuration phase was found and fully connected, 0 otherwise | |
/debugconfig dialog <target> <dialog> | On success | 1 | 1 | 1 if a player in the configuration phase was found and shown a dialog, 0 otherwise |
History
| Java Edition | |||||||
|---|---|---|---|---|---|---|---|
| 1.21.9 | Pre-Release 1 | Added debug property -DMC_DEBUG_DEV_COMMANDS, making the command accessible in the vanilla game. | |||||