# BedrockDialog<\/p>\n
A Paper plugin library that lets you show interactive dialogs to players on both Java Edition and Bedrock Edition (via Geyser\/Floodgate) through a single unified API.<\/p>\n
Intended to be used as a **dependency library** by other plugins. The bundled `\/bdialog` command and `config.yml` dialog definitions are provided as a demo and for simple use cases only.<\/p>\n
## Requirements<\/p>\n
– Paper 1.21.8+
\n– Java 21+
\n– Geyser and\/or Floodgate (optional, for Bedrock Edition support)<\/p>\n
## API Usage<\/p>\n
See [API.md]([API.md](https:\/\/github.com\/f0reachARR\/BedrockDialog\/blob\/main\/API.md)) for details on using BedrockDialog as a library in your own plugin.<\/p>\n
## Demo \/ Standalone Usage<\/p>\n
The plugin ships with a built-in command and `config.yml` for testing dialogs without writing code. This is intended for demonstration and simple use cases.<\/p>\n
### Commands<\/p>\n
| Command | Description | Permission | Both permissions default to **OP only**.<\/p>\n ### config.yml Example<\/p>\n “`yaml confirm_pvp: notice_rules: item_form: ### Config Actions<\/p>\n | Type | Description | Fields | **Placeholders**: `{player}` (player name), `{input. ## License<\/p>\n MIT License. See [LICENSE](LICENSE) for details.<\/p>\n","protected":false},"excerpt":{"rendered":" BedrockDialog is a Dialog wrapper for both Paper 1.21.8+ and Geyser (or Floodgate)<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"bedrockdialog","_minecraft_project_id":"9UKGJdgG","_minecraft_author":"f0reachARR","_minecraft_license":"MIT","_minecraft_downloads":38,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bedrockdialog.zip","_minecraft_size_bytes":64223,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:40:27.879405Z","_minecraft_date_created":"2026-03-04T23:32:45.990879Z","_minecraft_date_modified":"2026-03-03T03:58:38.431240Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bedrockdialog","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-01T10:13:59+00:00","_minecraft_import_hash":"54414ba48576cb967952d360bde7744f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[873,127,128,92],"mod_loader":[132,133],"minecraft_version":[40,41,81,82],"class_list":["post-27022","mod","type-mod","status-publish","hentry","mod_category-library","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———————–|———————————–|———————————|
\n| `\/bdialog open
\n| `\/bdialog reload` | Reload `config.yml` | `bedrockdialog.dialog.reload` |<\/p>\n
\ndialogs:
\n welcome:
\n type: multi_button
\n title: “Welcome!”
\n body: “Welcome,
\n buttons:
\n – label: “Go to Spawn”
\n actions:
\n – type: run_as_player
\n command: “spawn”
\n – label: “Check Rules”
\n actions:
\n – type: open_dialog
\n dialog_id: “notice_rules”
\n – label: “Close”
\n actions: []<\/p>\n
\n type: confirm
\n title: “Join PVP?”
\n body: “
\n yes_label: “Join”
\n no_label: “Cancel”
\n on_yes:
\n – type: run_as_console
\n command: “pvp join {player}”
\n on_no: []<\/p>\n
\n type: notice
\n title: “Server Rules”
\n body: “1. No griefingn2. No cheatingn3. Have fun!”
\n dismiss_label: “Got it”
\n on_dismiss: []<\/p>\n
\n type: input
\n title: “Item Distribution Form”
\n body: “Select what you want to receive”
\n submit_label: “Submit”
\n inputs:
\n – type: text
\n key: player_name
\n label: “Target Player Name”
\n placeholder: “e.g. Steve”
\n default: “”
\n – type: slider
\n key: amount
\n label: “Amount”
\n min: 1
\n max: 64
\n step: 1
\n default: 1
\n – type: boolean
\n key: checkbox
\n label: “Checkbox Test”
\n default: true
\n – type: dropdown
\n key: item
\n label: “Item”
\n default: 0
\n options:
\n – id: diamond
\n label: “Diamond”
\n – id: gold_ingot
\n label: “Gold Ingot”
\n on_submit:
\n – type: run_as_console
\n command: “give {input.player_name} {input.item} {input.amount}”
\n on_close: []
\n“`<\/p>\n
\n|—————–|————————————–|————-|
\n| `run_as_player` | Execute a command as the player | `command` |
\n| `run_as_console`| Execute a command as the console | `command` |
\n| `open_dialog` | Open another dialog by config ID | `dialog_id` |<\/p>\n