Paper Dialog

Displays a native Paper dialog menu with various button types and input fields. Requires Paper 1.21.6+.

Configuration

Field	Type	Description
displayName	Var<String>	Dialog title
message	Var<String>	Body text (supports multiline)
bodyItem	Var<Item>	Optional item showcased in the dialog body (empty for none)
buttons	List<DialogButtonConfig>	List of buttons and inputs
showExitButton	Var<Boolean>	Show/hide the exit button
columns	Var<Int>	Number of button columns
dialogType	Enum	Window layout: MULTI_ACTION (grid), CONFIRMATION (yes/no), NOTICE (single button)
afterAction	Enum	Client behaviour after a click: CLOSE, NONE, WAIT_FOR_RESPONSE

Dialog Types

• MULTI_ACTION — the default grid of buttons, columns per row.
• CONFIRMATION — vanilla yes/no window: the first button confirms, the exit button declines.
• NOTICE — single-button notice window using the first button (or the exit button).

Button Types

Action Button

Simple button that executes a command when clicked.

Field	Type	Description
label	Var<String>	Button text
command	Var<String>	Command to execute
asOp	Var<Boolean>	Execute the command with OP elevation

Trigger Button

Fires Typewriter entries directly when clicked — no command detour.

Field	Type	Description
label	Var<String>	Button text
triggers	List<Ref<TriggerableEntry>>	Entries triggered on click

Text Input

Text field with a submit button.

Field	Type	Description
label	Var<String>	Input label
key	Var<String>	Key used in the command macro (default input)
buttonLabel	Var<String>	Submit button text
command	Var<String>	Command (use $(<key>) for value)
initial	String	Default text value
maxLength	Int	Maximum character limit
maxLines	Int	Maximum lines for multiline

Boolean Toggle

On/Off toggle switch.

Field	Type	Description
key	Var<String>	Variable key for placeholder (default boolean)
label	Var<String>	Toggle label
onTrue	Var<String>	Text when enabled
onFalse	Var<String>	Text when disabled
command	Var<String>	Command (use $(<key>) for value)

Multiple Choice

Dropdown/list selector.

Field	Type	Description
label	Var<String>	Selector label
key	Var<String>	Key used in the command macro (default choice)
options	Var<String>	Comma-separated options (suffix * for default)
command	Var<String>	Command (use $(<key>) for value)

Number Range

Slider for numeric values.

Field	Type	Description
key	Var<String>	Variable key for placeholder (default value)
label	Var<String>	Slider label
start	Var<Int>	Minimum value
end	Var<Int>	Maximum value
step	Var<Int>	Step increment
command	Var<String>	Command (use $(<key>) for value)

[!TIP] Every input type has its own configurable key, so several inputs of the same type can coexist in one dialog — each command macro reads its own $(<key>).

Requirements

[!IMPORTANT] This extension requires Paper 1.21.6+ with the native Dialog API.