FAQ

Why does DialogForge refuse to load on my server?

It needs Paper 1.21.7 build 17 or newer. PlatformCheck looks for Paper first, then for the Dialog API classes specifically, since the API arrived one version after dialogs themselves did. Either failure logs one line and disables the plugin rather than throwing halfway through startup. Spigot, Bukkit and Purpur have no Dialog API and are not supported, and will not be, since Paper hardforked before it existed.

A player says the menu will not open, or opens to a blank screen

Check they are on a 1.21.6 or newer client. A dialog is a client feature as much as a server one, and there is no fallback screen for an older client, since Paper's Dialog API gives DialogForge no way to detect the client version and draw something else.

I turned on panel.aligned and every row is a box of missing characters

The panel layout needs the resource pack DialogForge writes to plugins/DialogForge/pack/DialogForge-Panel.zip. See Layout modes for uploading it yourself or merging it into ItemsAdder. Leave panel.aligned off until the pack is actually reaching players.

The panel sidebar looks slightly uneven, or a category name moves when I click it

Almost always an unmeasured character, most often an icon out of your own resource pack. Check the console on load: DialogForge names every character in that menu it had to guess the width of. Give the real number with panel.icon-width, icon-width on the page, or panel.glyph-widths, or better, declare the picture under icons: so DialogForge measures it exactly. See Layout modes and Icons.

I changed a menu file and nothing happened

auto-reload.enabled is on by default and checks every interval-ticks, but a change is only acted on once the file has been unchanged for one whole check, so give it a couple of seconds after saving. If it still has not picked it up, run /dialogforge reload and read the console: a broken menu file is reported by name rather than silently skipped.

A background is not showing up

Check the startup line from PackService#prepare. It names every background that loaded against how many were declared. The two silent causes are a name in a menu file that does not match anything under backgrounds: in config.yml, and two backgrounds declared under the same name, where YAML keeps only the last one. See Backgrounds.

Players are not seeing a background or icon I just added or resized

That changes the resource pack and its hash. Re-upload the zip, or run /iazip if you merge into ItemsAdder, and rejoin. A hash pinned in panel.resource-pack.sha1 that no longer matches the file just written is called out in the console specifically, because a client caches a pack by its hash and a stale pin keeps the old pack on a player's disk for good.

Can one menu show in more than one language?

Not on its own. Menu text lives in the menu file itself, not in lang/, so a server running menus in more than one language keeps a separate menu file per language. lang/ only covers the plugin's own console and command messages. See Messages & language.

Does DialogForge work on Folia?

No. folia-supported is false in plugin.yml.

Can I use a chest GUI plugin's menus alongside DialogForge?

Yes, they do not conflict. DialogForge only ever opens a dialog screen, never an inventory, so nothing about it touches another plugin's chest menus.