Show Dialog

Configuration 0x12, server → client.

config · 0x12 · clientbound (server → client)

Opens a server-defined dialog screen on the client. dialog is either a registry id of a known dialog or an inline NBT dialog definition. Player interaction comes back through CustomClickAction or other click events.

Sent by the server, read by the client. Listen for it with client.on("ShowDialog", (data) => …) on the receiving side.

Fields

Send it

await client.sendPacket("ShowDialog", {
  dialog: {
    type: "minecraft:notice",
    title: { text: "Welcome" },
    body: [{ type: "minecraft:plain_message", contents: { text: "Have fun!" } }],
  },
});

dialog is an inline NBT dialog definition or a registry reference. Buttons and inputs may trigger serverbound CustomClickAction packets; send ClearDialog to close the screen programmatically.

Field aliases listed under Notes are accepted as alternative keys when writing.

Source: src/Core/Versions/776/Packets/config/clientbound/ShowDialog.ts