Frequently asked questions

Still stuck? Open a ticket on Discord.

I edited main.yml but the ESC button didn't change

The pause-screen menu is built when the server starts — restart to see changes there. /menu shows them right away.

Placeholders don't work in the ESC menu

Minecraft sends the pause-screen menu once for the whole server, so it can't be per player. Use placeholders in menus opened with /menu or buttons instead.

The ESC button doesn't show up at all

Check your license key in config.yml. Without a key the button isn't registered, so players never see a button that leads nowhere. Also make sure the server and client are 1.21.6+.

Does it work on Folia?

No — DexDialog supports Paper and Purpur.

What do Bedrock and older Java players see?

Bedrock players get native forms through Floodgate. Java clients below 1.21.6 get a chest GUI built from the same files (the gui: blocks). Run /dexdialog debug <player> to see which one someone gets.

Do I need DexFriends?

No. Without it the Friends button hides itself and "Friends only" settings act like "Nobody".

I already use EssentialsX for /tpa or another chat plugin

Set enabled: false in teleport.yml or chat.yml and DexDialog leaves them alone.

How do I add a new menu?

Easiest: /dexdialog editor → + New menu and pick a template. Or drop a new .yml into menus/ and point a button at it with action: open_menu.