Simple GUI API — Troubleshooting
Simple GUI API
可复用的配置 GUI API，支持主题、配置文件、按键绑定和响应式布局。
Quick diagnosis
Section titled “Quick diagnosis”- Close Minecraft and confirm there is only one Simple GUI API JAR in the test profile.
- Confirm Minecraft version, loader, this mod, and its dependency belong to the same supported set.
- Launch with only this mod and required dependencies when testing a conflict.
- Reproduce with default settings or a fresh profile without deleting the original config.
- Read the latest log from the first warning/error related to the mod, not only the final crash line.
対応Modの画面が開かない
Section titled “対応Modの画面が開かない”Confirm API version and loader match the dependent mod.
レイアウトが重なる
Section titled “レイアウトが重なる”Change GUI scale and align API/dependent-mod versions.
プロファイルが戻る
Section titled “プロファイルが戻る”Save before closing and check write permission for the config folder.
Settings screen does not open
Section titled “Settings screen does not open”There is no global everyday key. Open a client mod’s settings through that mod’s key binding or a compatible mod menu. Search Controls for both the mod name and “category.” Resolve red key conflicts, then restart once. If the key entry is absent, inspect the loader log for a dependency or initialization failure.
What to include in a bug report
Section titled “What to include in a bug report”Provide Minecraft version, loader and loader version, Simple GUI API version, Simple GUI API version when used, exact reproduction steps, expected/actual behavior, and the relevant latest log. Include a screenshot only when it shows the problem and contains no server address, token, or personal information.
Last-resort config reset
Section titled “Last-resort config reset”Back up the profile’s config folder, then move only this mod’s config out while Minecraft is closed. Launch once to generate defaults. If the issue remains, restore the saved config because the cause is likely a version mismatch or another mod.