Troubleshooting

Before you start

Keep logs/latest.log open: minuit writes one line there for each theme file it skips. Press F3+T after every change to a data file.

My chroma or family does not show

The file did not parse, so minuit skipped it. The log line names the file and the field; fix that field and reload.

Players do not get minuit updates

Your jar bundles minuit. Declare it as a required dependency and let players install it.

The theme tab covers my screen

Override showsThemeTab() to return false. The screen reads it every frame, so it can change while open.

Items move into a slot I hid

showsSlot hides a slot only on the client; quick move and double-click gather still run on the server. Make the menu refuse those moves.

In a dev environment, minuit logs menu slots no component places, and titles drawn under a widget.

The server sees no minuit on a client

That client has no minuit, so MinuitServer.client(player) is empty. Check before you send:

MinuitServer.client(player).filter(c -> c.has(ClientInfo.FORMS)).ifPresent(c -> ...);