in game editor

DialogMaster includes a built-in, categorized in-game visual GUI editor. It allows server administrators to create, edit, customize, test, and translate menus directly inside Minecraft without manually editing YAML files or restarting the server.

Opening the Editor

• Command: /ydm editor or /ydm editor <menu_id>
• Permission: dialogmaster.editor or dialogmaster.admin

Running /ydm editor opens the Menu Selection Browser, where you can create a new menu draft or pick an existing menu to edit.

The 5-Hub Categorized Dashboard

When editing a menu, DialogMaster organizes all settings into five specialized hubs:

┌─────────────────────────────────────────────────────────────┐
│                   Menu Editor Dashboard                     │
├──────────────────────────────┬──────────────────────────────┤
│  Identity & Commands      │  Visuals & Layout         │
│  Buttons & Content        │  Platforms & Triggers     │
│  Tools & Publishing       │  Test Run                 │
│  Save & Apply             │  Exit Editor              │
└──────────────────────────────┴──────────────────────────────┘

Identity & Commands

Configure menu identification, titles, and slash command bindings:

• Menu ID: Unique internal file identifier (e.g. server-hub, shop).
• Internal Title: Dialog title for Modern Paper 1.21+ clients with full MiniMessage & <tr:...> support.
• External Title: Container title displayed on Chest GUIs and Bedrock forms.
• Menu Type Archetype: Switch between multiAction, confirmation, notice, form, and serverlinks.
• Primary Slash Command: Bind custom commands (e.g. /hub, /profile) directly to open this menu.
• Target Player Argument: Enable allowTargetPlayer so /stats Notch opens Notch's menu.

Visuals & Layout

Control presentation, grid sizing, and menu lifecycle rules:

• Columns (1 to 6): Configure the button grid column width for modern dialogs.
• ESC Close: Toggle whether pressing Escape closes the menu.
• Pause Mode: Toggle whether single-player pause is triggered when viewing the dialog.
• Swap Buttons: In confirmation dialogs, swap the visual positions of Confirm and Deny buttons.
• After Action Behavior: Choose what happens when an action finishes (NONE, CLOSE, RESET).
• Generate Auto-Layout: Automatically balances buttons into a clean, symmetric grid.

Buttons & Content

Manage the dialog body, action buttons, inputs, and interactive components:

• Body Components
  • Add rich text blocks, banners, and 3D item displays.
  • One-Click "Grab from Hand" Importer: Click [ Grab from Hand ] to instantly import any item in your main hand. Extracts:
    • Material & Item Model
    • Display Name (MiniMessage-serialized)
    • Lore lines
    • CustomModelData
    • Enchantment Glint
    • Armor Trims (Trim Pattern & Trim Material)
    • Leather Armor RGB Hex Dye
    • Potions (Potion Type & Custom Liquid Color)
• Action Buttons: Add, edit, reorder, and remove buttons. Configure labels, icons (<item:...>), tooltips, and click actions.
• Stateful Toggle & Cycle Buttons: Configure buttons that dynamically synchronize with external plugin states via PlaceholderAPI (%essentials_fly%), permissions, or conditions.
• Interactive Inputs: Add text fields, numeric range sliders, boolean toggles, and dropdown selectors.

Platforms & Triggers

Cross-platform compatibility, physical item triggers, and refresh engines:

• Chest GUI Layout & Fallback
  • Enable/disable Chest GUI override.
  • Configure inventory rows (1-6) and filler glass pane materials.
  • Generate from Dialog: Automatically converts your Modern Dialog layout into a matching Chest GUI inventory layout.
• Bedrock Forms & Rendering Mode (Geyser / Floodgate)
  • Bedrock Mode Selector: Cycle between AUTO (smart translation), FORM (force Bedrock Forms), and CHEST_GUI (force inventory chest layout for Bedrock players).
  • Enable/disable dedicated Bedrock Form overrides (SimpleForm, ModalForm, CustomForm).
  • Configure Bedrock button icons (textures, URLs, item sprites).
  • Generate from Dialog: Automatically converts dialog buttons and content into Bedrock Form components.
• Physical Item Triggers
  • Bind an inventory item that opens the menu upon right-clicking.
  • Configure material (or grab from hand), display name matcher, cooldowns, and sneak-to-open requirements.
• Auto-Refresh Ticker
  • Set auto-refresh interval (in ticks) to re-evaluate placeholders live without reopening menus.
• Dynamic Pagination & Search
  • Enable multi-page item grids, items per page, and live keyword search filtering.

Tools & Publishing

Localization, migration tools, live testing, and saving:

• Auto-Extract Translations: Scans the draft, writes all text strings to locales/en_us.yml, and replaces draft text with <tr:...> translation tags with one click.
• Language Manager: View all loaded language files and inspect missing translation keys.
• Export to DeluxeMenus: Converts the active DialogMaster menu into a standalone DeluxeMenus YAML configuration file.
• Run Live Test: Opens a temporary preview of the draft so you can test button clicks, actions, and layouts without saving.
• Save & Apply (Hot Reload): Writes changes to disk in plugins/DialogMaster/menus/<menu_id>.yml and applies them instantly across the server with zero restarts.

Interactive Input Editors

The editor uses native dialog prompts to make editing smooth:

• Text Prompts: Clean modal text inputs for names, commands, and MiniMessage strings.
• Sliders: Interactive sliders for rows, columns, widths, and cooldowns.
• Item Icon Picker: Browse the complete Minecraft item catalog with categorized search to pick item icons visually.
• Boolean Toggles: One-click YES / NO switches for settings.