Rubric Troubleshooting

Jump to bottom

Oliver Yasuna edited this page Jul 3, 2026 · 2 revisions

Rubric — Troubleshooting

Common problems and where to look. Grows as issues surface.

Nothing curated here yet — file an issue at github.com/oliveryasuna/minecraft-mods/issues so it can be added.

Meanwhile, general debugging pointers:

Load error No FormatAdapter registered for X — the @Config#format on your class is one the bootstrap ConfigIO doesn't know. See Formats — either switch the format or bootstrap with RubricSerialization.allFormatsIO().
AtomicMoveNotSupportedException — filesystem doesn't support atomic rename. Set io.atomicWrites = false in Rubric.toml. See Self-config.
My config screen button in ModMenu / Catalogue does nothing — likely a mismatch between @Config#id and your loader mod id (fabric.mod.json#id on Fabric, [[mods]].modId in META-INF/neoforge.mods.toml on NG). ModMenu / Catalogue only surfaces factories whose key matches a loaded mod. See Frontends.
Server-authoritative value keeps reverting when I edit it — expected. The server owns it. Local edits from the GUI go through a permission gate on the server; if the server denies, the change reverts on the next sync tick. See Sync.
File on disk keeps rewriting itself on every launch — means the load produced corrections. Check the log for lines like [modid] corrected …. See Validation.