Minecraft:Commands/dialogue

Template:Hatnote Template:Infobox command Opens an NPC dialogue screen to the player(s), or changes the dialogue displayed by an Minecraft:NPC.

Usage

Dialogue can be branched with the use of a scene file. The scene file is a Json file located inside the dialogue folder in the root directory of the active behavior pack that contains all the information needed for branching dialogue. There is no limit to the amount of scene files, as the game reads all the files in the folder and call based on scene_tag property indicated in the given scene data.

See this documentation for scene file setup.

Syntax

dialogue open <npc: target> <player: target> [sceneName: string]

Forces open the targeted NPC's dialogue box to the targeted player(s), simulating the experience of clicking on an NPC.

• A targeted scene can also be indicated.

dialogue change <npc: target> <sceneName: string> [player: target]

Changes the content of the targeted NPC according to the targeted scene, including dialogue, commands, and name.

• This closes the dialogue box and update for the next time the NPC is interacted.
• The content can be updated on a per-player basis. If no player is targeted, the dialogue updates for all players.

Arguments

npc: target: CommandSelector<Actor>

Specifies the target to open an NPC screen from.

{{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|inapplicability}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}} And it should target only one entity that has the minecraft:npc component.

player: target: CommandSelector<Player>

Specifies the player(s) to display the NPC screen.

Must be specified in open mode. In change mode, all players are affected if not specified.

{{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|inapplicability}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

sceneName: string: basic_string

Specifies what scene to show from the dialogue folder in a behavior pack from the scene_tag property.

Must be specified in change mode. In open mode, the last dialogue shown is used if not specified.

{{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|string}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

Output

{{#vardefine:output-table-lines|}}{{#vardefine:output-table-lines|-2}}{{#vardefine:output-table-lines-now|}}{{#vardefine:command-num-now|}}{{#vardefine:command-line-now|}}{{#vardefine:commands-num|}}{{#vardefine:output-edition-num-now|}}{{#vardefine:output-edition-line-now|}}{{#vardefine:output-editions-num|}}{{#vardefine:je-outputs-dis|}}

{{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On fail}}{{#vardefine:output1-{{#var:output-table-lines}}|0}}{{#vardefine:output2-{{#var:output-table-lines}}|N/A}}{{#vardefine:output3-{{#var:output-table-lines}}|N/A}}{{#vardefine:command-row-{{#var:commands-num}}|}}{{#vardefine:output-editions-num|}}{{#vardefine:output-edition-{{#var:output-editions-num}}|be}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|1}} {{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On success}}{{#vardefine:output1-{{#var:output-table-lines}}|1}}{{#vardefine:output2-{{#var:output-table-lines}}|N/A}}{{#vardefine:output3-{{#var:output-table-lines}}|N/A}}{{#vardefine:command-row-{{#var:commands-num}}|}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|}}

{{#vardefine:output-table-lines|}}{{#vardefine:output-table-lines|-2}}{{#vardefine:output-table-lines-now|}}{{#vardefine:command-num-now|}}{{#vardefine:command-line-now|}}{{#vardefine:commands-num|}}{{#vardefine:output-edition-num-now|}}{{#vardefine:output-edition-line-now|}}{{#vardefine:output-editions-num|}}{{#vardefine:je-outputs-dis|}}

Examples

• Open the dialogue of an NPC with tag "ducky" toward the nearest player showing scene "ducky_intro":

dialogue open @e[type=npc, tag=ducky] @p ducky_intro

• Change the dialogue of an NPC with tag "ducky" into scene "duck_intro" toward the initiator:

dialogue change @e[type=npc, tag=ducky] ducky_intro @initiator

History

External links

• Template:Cite

Navigation

All editions	clear clone damage deop difficulty effect enchant execute fill function gamemode gamerule give help kick kill list locate loot me msg op particle place playsound recipe reload ride say schedule scoreboard setblock setworldspawn spawnpoint spreadplayers stopsound summon tag teleport tell tellraw time title tp transfer w weather xp Removed placefeature
Template:El only	advancement attribute ban ban-ip banlist bossbar data datapack debug defaultgamemode dialog experience fetchprofile fillbiome forceload item jfr pardon pardon-ip publish random return save-all save-off save-on seed setidletimeout spectate stopwatch swing team teammsg tm test tick trigger version waypoint worldborder Debug chase debugconfig debugmobspawning debugpath raid serverpack spawn_armor_trims warden_spawn_tracker Removed ? achievement banip blockdata broadcast chunk entitydata home iron locatebiome replaceitem setspawn solid stats testfor testforblock testforblocks toggledownfall unban wood
Template:Els only	stop whitelist
Template:El only	aimassist allowlist changesetting clearrealmevents controlscheme dedicatedwsserver gametips packstack project reloadconfig reloadpacketlimitconfig save sendshowstoreoffer set_movement_authority Removed aigoals automate automateactivetool automatebreakblock automatefindblock automatefly automategetinteractionpositionforblock automatelookat automatemove automatemoveto automateplaceblock bhave bossbar bounds cleanroom clearslot clearinventory crash crashclient crashserver createlocalworld destroyblock detect dumpblocknames dumpentitiesclient dumpentitiesserver enchantrandom fillchestblock filldrive findanchoredbuildpos findflatarea findnearbypickups fixbiomes fly getactivescreen getavgendframerate getavgremaindertimepercent getavgrendertime getavgticktime getavgunaccountedtimepercent getblockname getbrightness getchestcontents getchunkdirtycount getchunkrebuildcount getchunksortcount getcpu getdurability getexperience getfps getgpu getgpumemory getguiscale getmsaalevel getos getplayerbiome getplayerid getpos getpower getprofilersecondsperupdate getresolution getselecteditemcount getskin getstructure getsysteminfo getsystemmem getviewdistance getworldname health hunger islargechestblock isplayercrouching isplayerflying isplayergrounded isworldloaded kit leaveworld loadbehaviortreedefinitions log lookat memwarn mixer nearbyentityisbaby networkstats notifyprofiler paths pause placefromhand playerstat profile redstonetest register3pserver resupply rot selectinventoryitem sendmodalform setbrightness setguiscale setskin setviewdistance showallitems showfrustum simlock simscale simulationtype skin spawnfeature spawning spawnitem spawnmob stoptime systemstat testassets timelock tptobiome tptosuitabletree villages volumearea wipeout
Template:El only	classroommode closechat code codebuilder lesson remove videostream Removed position videostreamaction
Template:Els only	? ability agent alwaysday camera camerashake clearspawnpoint codebuilder_actorinfo connect daylock dialogue drop enableencryption event fog getlocalplayername gettopsolidblock hud immutableworld inputpermission listd mobevent music ops permission playanimation querytarget replaceitem script scriptevent setmaxplayers structure takepicture testfor testforblock testforblocks tickingarea titleraw toggledownfall wb worldbuilder wsserver Removed clearfixedinv executeasself move place setfixedinvslot setfixedinvslots test transferserver
Joke	debugdim transform vote warp
Related	Argument types Permission level Slot Target selectors

ja:コマンド/dialogue lzh:令/dialogue pt:Comandos/dialogue zh:命令/dialogue de:Befehl/dialogue