Skip to main content

Troubleshooting

The overlay does not appear​

Check the menu match first:

  • Does the title rule match the inventory title?
  • Is the rows value correct?
  • Is the Bukkit inventory type correct?
  • Does the referenced theme exist?

Then run:

/guifx reload
/guifx validate

The generated Client UI pack does nothing​

Confirm all three items:

  1. client-ui.enabled is true.
  2. client-ui.active-profile points to an existing profile folder.
  3. client-ui.version-profile matches the Minecraft client the pack is targeting.

An unsupported target should appear as a validation issue for the selected profile. GUIFX avoids writing guessed native overrides.

Another resource pack changes the same texture​

Open generated/merge-ready/CLIENT-UI-OVERRIDES.txt. It lists each native Minecraft file GUIFX wrote. Merge the final intended version manually; no plugin can safely choose between two artistic replacements for the same Minecraft path.

Studio and live server preview differ​

Studio is a placement/configuration workspace, not a Minecraft client emulator. It shows the selected GUIFX layout, overlay position, widget slots, and frame timing. The server’s /guifx validate result and a real resource-pack test remain authoritative.