Troubleshooting

NxGui turns itself off at startup

The license key is missing or wrong. Paste it into license-key in config.yml, activate it once at the dashboard, and restart. One key is for one server.

Players see nothing, or boxes

They don't have the resource pack — see Resource pack. Players who turn the pack down can't see menus or HUDs.

"Cannot interact with self!" kick when clicking

PacketEvents is older than your Minecraft version. Update it.

My changes don't show

Run the /nxgui applyedit command that Build & Deploy shows. If pictures or text changed, serve the new resource pack too.

Menus break with shaders (Iris, OptiFine)

Use Shader-Safe screens. Standard ones don't work with shader packs.

Menus look wrong next to my other pack

The other pack's core shaders are winning over NxGui's. Use Merge into a pack — see Resource pack.

Money always says Not enough

Vault, or an economy plugin for it, is missing.

Bedrock: "This menu was not built for Bedrock"

Turn on Bedrock in Build & Deploy, build, and put the new .mcpack in Geyser's packs folder.

Bedrock: HUDs don't show

Put the new .mcpack in plugins/Geyser-Spigot/packs/, replacing the old one, and restart.

Bedrock: values don't update

Bedrock menus read values when they open. Turn on Reopen on Bedrock when values change in the screen's Preferences.

Does NxGui run on Folia?

Yes.