sDialogMenus | Custom Dialog Menus, PNG Banners & YAML Configuration

sDialogMenus lets server owners create interactive menus using Minecraft's native Dialog screen. Menus are defined in easy-to-edit YAML files, so you can customize them without recompiling the plugin.

Use native text and buttons for lightweight menus, or add custom PNG artwork. When textures are used, sDialogMenus builds a resource pack automatically and can optionally host that pack through its built-in HTTP server.

✔ Native Dialog menus: Create menus with text, buttons, tooltips, and configurable layouts.
✔ Custom PNG textures: Add banners and title graphics to your menus.
✔ Automatic resource-pack generation: Convert textures into bitmap-font glyphs and build the pack on startup or reload.
✔ Built-in pack hosting: Optionally serve the generated pack from the plugin's HTTP server.
✔ Flexible actions: Run player or console commands, send messages, broadcasts, titles, action bars and sounds, teleport players, switch proxy servers, open menus, refresh or close menus, and chain actions with delays.
✔ Placeholders: Player name, UUID, world, coordinates, online player count, maximum players, proxy server counts, and optional PlaceholderAPI support.
✔ Conditional content: Show elements based on permissions, placeholder comparisons, and combined && conditions.
✔ Clickable banners and overlays: Put live placeholder text over texture banners and configure alignment.
✔ Camera backgrounds: Present a fixed 3D scene behind a menu.
✔ Per-menu commands: Define commands in YAML to open individual menus.
✔ Join menus: Optionally open a menu when a player joins.
✔ Permission controls: Restrict menu access or individual buttons/elements.
✔ Extra resource-pack files: Merge custom assets from pack-extra/.

• A compatible Paper server with the Paper Dialog API required by this build.
• Minecraft version 26.1 or newer, as specified for this build.
• Java 21 or newer is recommended for building; verify the actual runtime requirement for the published release.

Compatibility note: sDialogMenus uses Paper's Dialog API and does not run on a standard Spigot server in its current implementation. This resource can be listed on SpigotMC, but the plugin requires a compatible Paper build. Verify the exact supported Paper version before publishing.

1. Download the release JAR from the project's official release page.
2. Place sDialogMenus.jar in your server's plugins/ directory.
3. Start the server using a compatible Paper build.
4. The plugin creates its configuration, example menus, and texture directory.
5. Run /dm help and /dm list.
6. Open a sample menu with /dm open example.
7. Edit files in plugins/sDialogMenus/menus/ and run /dm reload.

Menus using only native text and buttons do not require a resource pack. Texture-based menus do.

Command	Description	Permission
/dm help	Show command help	No admin permission required
/dm list	List loaded menus	sdialogmenus.admin
/dm open <menu> [player]	Open a menu; opening it for another player requires admin access	sdialogmenus.open / sdialogmenus.admin
/dm close [player]	Close a dialog or leave a camera scene	sdialogmenus.admin
/dm reload	Reload config and menus, then rebuild the resource pack	sdialogmenus.admin
/dm pack build	Rebuild the resource pack	sdialogmenus.admin
/dm pack info	Display pack details and SHA-1	sdialogmenus.admin
/dm pack send [player]	Send the pack to a player	sdialogmenus.admin
/dm setcamera <name>	Save the current location as a camera position	sdialogmenus.admin
/dm create <menu>	Create a menu from a template	sdialogmenus.admin

Command aliases: /dm, /dmenu, /sdm, /sdmenu, /sdialogmenus, /dialogmenus

Permission	Default	Purpose
sdialogmenus.open	true	Allows players to open menus for themselves
sdialogmenus.admin	op	Allows administrative menu, reload, pack, camera, and other-player operations

Menu files can also specify permissions for individual elements and buttons.

Texture menus require players to receive the generated resource pack. Configure one of the following methods in plugins/sDialogMenus/config.yml:

1. External URL: Host sDialogMenusPack.zip and set resource-pack.url.
2. Built-in HTTP server: Enable resource-pack.host.enabled, configure port and public-address, and ensure the port is reachable from outside your network.
3. No textures: Use native text-and-button menus and disable resource-pack generation if you do not need graphics.

Use /dm pack info to inspect pack information and its SHA-1. The resource-pack format must match the Minecraft client version you support.

Menus and related files are stored in:
See the project's GitHub README.md for the complete YAML reference, action syntax, placeholders, conditions, texture settings, camera setup, and examples.

• Author: DedEnd
• Discord: mr.dedend

If you find bugs, please provide:

• Minecraft / Paper version
• sDialogMenus version
• Console errors
• Steps to reproduce
• Screenshot or video if the issue is visual