Minecraft:Commands/dialog: Difference between revisions

Latest revision as of 11:17, 9 August 2026

Template:Distinguish Template:Exclusive Template:Infobox command

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

Syntax

Template:Cd

Shows a dialog screen from inline Minecraft:SNBT or Template:Cd registry (usually defined in a Minecraft: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.

Template:Arg desc

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

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

@@ Line 1: / Line 1: @@
-{{MC/Distinguish|/dialogue}}
+{{Distinguish|/dialogue}}
-{{MC/Exclusive|java}}
+{{Exclusive|java}}
 {{Infobox command
 | name = dialog
@@ Line 7: / Line 7: @@
 }}
-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.
+Manages [[Minecraft:dialog]] screens displayed to [[Minecraft:player]]s. Allows server [[Minecraft:operator]]s to show custom or predefined dialogs in [[Minecraft:data pack]] to specified players, and clear any displayed dialogs on their screen.
 ==Syntax==
-: {{MC/Cd|/dialog show <targets> <dialog>}}
+: {{cd|/dialog show <targets> <dialog>}}
-:: Shows a dialog screen from inline SNBT or {{MC/Cd|minecraft:dialog}} registry (usually defined in a data pack) to specified players.
+:: Shows a dialog screen from inline [[Minecraft:SNBT]] or {{cd|minecraft:dialog}} registry (usually defined in a [[Minecraft:data pack]]) to specified players.
-: {{MC/Cd|/dialog clear <targets>}}
+: {{cd|/dialog clear <targets>}}
 :: Clears currently displayed dialogs for specified players.
 ==Arguments==
-{{MC/Argument|targets|entity}}
+{{argument|targets|entity}}
 : Specifies the players whose dialog is shown or cleared.
-: {{MC/Arg desc|je=entity|amount=multiple|type=players}}
+: {{arg desc|je=entity|amount=multiple|type=players}}
-{{MC/Argument|dialog|dialog}}
+{{argument|dialog|dialog}}
-: Specifies the dialog to show to the players. This argument is only used with {{MC/Cmd|link=none|dialog show}}.
+: Specifies the dialog to show to the players. This argument is only used with {{cmd|link=none|dialog show}}.
-: Must be either:
+: {{arg desc|je=dialog}}
-:* A namespaced ID of a dialog defined in a data pack (e.g., {{MC/Code|custom:my_dialog}} or {{MC/Code|minecraft:server_links}}). These are stored in the {{MC/Cd|minecraft:dialog}} registry.
+<!--:* A namespaced ID of a dialog defined in a data pack (e.g., {{code|custom:my_dialog}} or {{code|minecraft:server_links}}). These are stored in the {{cd|minecraft:dialog}} registry.
-:* An inline SNBT defining the dialog structure directly in the command. See {{slink|Dialog|Dialog format}} for the structures.
+:* An inline [[Minecraft:SNBT]] defining the dialog structure directly in the command. See {{slink|Dialog|Dialog format}} for the structures.-->
 ==Result==
 {{Result table|onlyje=1}}
 {{Result table|The command is incomplete, or any argument is not specified correctly.|unparseable}}
-{{Result table|cmd=/dialog (show{{!}}clear) <targets>|{{MC/Cd|targets}} is a target selector that includes any entities other than the player.|fail}}
+{{Result table|cmd=/dialog (show{{!}}clear) <targets>|{{cd|targets}} is a target selector that includes any entities other than the player.|fail}}
-{{Result table|cmd=/dialog show <targets> <dialog>|{{MC/Cd|dialog}} is not a valid dialog SNBT, or dialog does not exist in {{MC/Cd|minecraft:dialog}} registry (usually in a data pack).|fail}}
+{{Result table|cmd=/dialog show <targets> <dialog>|{{cd|dialog}} is not a valid dialog [[Minecraft:SNBT]], or dialog does not exist in {{cd|minecraft:dialog}} registry (usually in a [[Minecraft:data pack]]).|fail}}
 {{Result table|cmd=|succeed}}
 {{Result table}}
 == Output ==
-{{MC/Output table}}
+{{Output table}}
-{{MC/Output table|edition=je|On fail|0|0|0}}
+{{Output table|edition=je|On fail|0|0|0}}
-{{MC/Output table|On success|1|1|the number of targeted players}}
+{{Output table|On success|1|1|the number of targeted players}}
-{{MC/Output table}}
+{{Output table}}
 ==Examples==
@@ Line 49: / Line 49: @@
 *:<code>/dialog show @a minecraft:server_links</code>
-* To show nearest players a notice dialog with title "Hello" and an "Ok" button in the footer:
+* To show nearest players a [[Minecraft:Dialog#notice|notice dialog]] with title "Hello" and an "Ok" button in the footer:
 *:<code>/dialog show @p {type:"minecraft:notice",title:"Hello"}</code>
-* 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:
+* To show all players a simple [[Minecraft:Dialog#confirmation|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:
 *:<code>/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"}}</code>
@@ Line 60: / Line 60: @@
 == History ==
 {{HistoryTable
-|{{MC/HistoryLine|java}}
+|{{HistoryLine|java}}
-|{{HistoryLine||1.21.6|dev=25w20a|Added {{MC/Command|dialog|link=none}}|Added {{MC/Code|minecraft:custom_options}} and {{MC/Code|minecraft:server_links}} as blank built-in dialogs.}}
+|{{HistoryLine||1.21.6|dev=25w20a|Added {{command|dialog|link=none}}|Added {{code|minecraft:custom_options}} and {{code|minecraft:server_links}} as blank built-in dialogs.}}
-|{{HistoryLine|||dev=Pre-Release 1|Added {{MC/Code|minecraft:quick_actions}} as a blank built-in dialog.}}
+|{{HistoryLine|||dev=Pre-Release 1|Added {{code|minecraft:quick_actions}} as a blank built-in dialog.}}
 }}
@@ Line 75: / Line 75: @@
 == Navigation ==
-{{MC/Navbox commands}}
+{{Navbox commands}}
-de:Befehl/dialog
+[[Minecraft:de:Befehl/dialog]]
-es:Comandos/dialog
+[[Minecraft:es:Comandos/dialog]]
-ja:コマンド/dialog
+[[Minecraft:ja:コマンド/dialog]]
-pt:Comandos/dialog
+[[Minecraft:pt:Comandos/dialog]]
-zh:命令/dialog
+[[Minecraft:zh:命令/dialog]]