Syntax

open [new] dialog list dialog to %audiences%

Description

A dialog screen with scrollable list of buttons leading directly to other dialogs, arranged in columns. Titles of those buttons will be taken from external_title fields of targeted dialogs. If `exit_action` is present, a button for it will appear in the footer, otherwise the footer is not present. `exit_action` is also used for the Escape action. See [**Dialog List Dialog**](https://minecraft.wiki/w/Dialog#dialog_list) on McWiki for further details. See [**snippets**](https://github.com/ShaneBeee/SkriptSnippets/tree/master/snippets/dialog) for comprehensive examples.

You can either register a dialog in the `registry registration` structure, and open it later or you can create/open a dialog on the fly. **Register**: Register a dialog with an `id` (The id that represents this dialog, accepts a string or NamespacedKey). **Open**: Create a dialog and directly open it to a player without registration.

**Entries**: - `title` = Screen title, appearing at the top of the dialog, accepts a string/text component. - `external_title` = Name to be used for a button leading to this dialog (for example, on the pause menu), accepts a string.text component. If not present, `title` will be used instead. [Optional] - `body` = Optional section for body elements or a single body element. See [**Body Format on SkBee wiki**](https://github.com/ShaneBeee/SkBee/wiki/Dialogs#body-format) and [**Body Format on McWiki**](https://minecraft.wiki/w/Dialog#Body_format) for further info. - `inputs` = Optional section for input controls. See [**Input Control on SkBee wiki**](https://github.com/ShaneBeee/SkBee/wiki/Dialogs#input-control)and [**Input Control on McWiki**](https://minecraft.wiki/w/Dialog#Input_control_format) for further info. - `can_close_with_escape` = Can dialog be dismissed with Escape key. Defaults to true. [Optional] - `after_action` = An additional operation performed on the dialog after click or submit actions (accepts a string).Options are "close", "none" and "wait_for_response".See [**Common Entries on SkBee wiki**](https://github.com/ShaneBeee/SkBee/wiki/Dialogs#common-entries) for further info. - `dialogs` = A list of strings of previously defined dialogs. Will accept the ID of the other dialogs, whether registered by you or from datapacks. - `exit_action` = Action for leaving the dialog. Same as action sections but will only accept one action. [Optional] - `columns` = Positive integer describing number of columns. Defaults to 2. [Optional] - `button_width` = Integer value between 1 and 1024 — Width of the button. Defaults to 150.