Minecraft:Commands/dialog

Template:Distinguish Template:Exclusive Template:Infobox command

Manages dialog screens displayed to players. Allows server operators to show custom or predefined dialogs in data pack to specified players, and clear any displayed dialogs on their screen.

Syntax

Template:Cd

Shows a dialog screen from inline SNBT or Template:Cd registry (usually defined in a data pack) to specified players.

Template:Cd

Clears currently displayed dialogs for specified players.

Arguments

Template:Argument

Specifies the players whose dialog is shown or cleared.

Template:Arg desc

Template:Argument

Specifies the dialog to show to the players. This argument is only used with Template:Cmd.

Must be either:

A namespaced ID of a dialog defined in a data pack (e.g., Template:Code or Template:Code). These are stored in the Template:Cd registry.
An inline SNBT defining the dialog structure directly in the command. See Template:Slink for the structures.

Result

Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table

Output

Template:Output table Template:Output table Template:Output table Template:Output table

Examples

File:Dialog simple confirmation.png

A simple confirmation dialog from an example.

File:Dialog command execution confirmation.png

Pressing "Yes" results in a command execution, which requires a confirmation from the player.

To show the nearest player a dialog located at data/custom/dialog/example/test.json in a loaded data pack:
/dialog show @p custom:example/test

To show all players the built-in minecraft:server_links dialog:
/dialog show @a minecraft:server_links

To show nearest players a notice dialog with title "Hello" and an "Ok" button in the footer:
/dialog show @p {type:"minecraft:notice",title:"Hello"}

To show all players a simple confirmation dialog with two action buttons with the label "Yes please" and "Nope". If the player presses "Yes please", the game runs a command to give the player a Minecraft:diamond, otherwise, if they press "Nope", the game closes the dialog:
/dialog show @a {type:"minecraft:confirmation",title:"Give yourself diamond?",yes:{label:"Yes please","action":{"type":"run_command","command":"give @s diamond"}},no:{label:"Nope"}}

To clear any currently visible dialogs for all players:
/dialog clear @a

History

Template:HistoryTable

Gallery

An example dialog created by ioblackshaw, showcased by xisumavoid on YouTube.<ref>Template:YouTube link</ref>

An example dialog created by ioblackshaw, showcased by xisumavoid on YouTube.<ref>Template:YouTube link</ref>
An entity summoner made and shown off by u/SmoothTurtle872 on Reddit

An entity summoner made and shown off by u/SmoothTurtle872 on Reddit

References

Navigation

Template:Navbox commands

de:Befehl/dialog es:Comandos/dialog ja:コマンド/dialog pt:Comandos/dialog zh:命令/dialog