reference
Troubleshooting
The warnings you'll actually meet, and what they mean. Anything else — write us, replies within two business days.
Generation
| Symptom | Description |
|---|---|
| Generate() returns null | Missing required input — the request needs a rarity and a resolvable item type (directly or via template). The console warning names which one. The editor window shows the same reason in its preview pane. |
| Fewer affixes than the rarity’s minimum | The eligible pool ran dry: tier gates, type restrictions, exclusion groups, and stat uniqueness all shrink it. The warning names the rarity contract. Fix by adding affixes, widening their gates, or loosening exclusion groups. |
| Same seed produces a different item after updating | Generation logic changed between versions (the generator version stamp exists for exactly this). Snapshots warn on restore when versions differ. Item content also matters — editing a template or affix changes what a seed rolls. |
| Items generate but stats seem missing | Check the type’s Allowed Stats whitelist — affixes granting stats outside it are filtered out. The sub-type inspector’s Resolved Inheritance Preview shows the effective list. |
Setup & editor
| Symptom | Description |
|---|---|
| Can't find the menu | Current releases live under Window▸NullBolt▸Item Generator System; older builds used Window▸Item Generator System. If neither exists, check the Console for compile errors from missing packages, then run the dependency check once it compiles. |
| Restored items come back null | Snapshot names couldn't be resolved — usually a renamed definition asset or a GeneratorSettings that was never Auto-Discovered on this machine. Names are the lookup key: add new assets rather than renaming shipped ones. |
| Settings not found at runtime | There is no Resources auto-load by design — wire the GeneratorSettings reference through a serialized field or your own bootstrap. |
| Demo text is pink / boxes | SDF font atlases need rebuilding — run Window▸NullBolt▸Item Generator System▸Regenerate Demo Fonts (and make sure TMP Essentials are imported, wizard step 1). |
| Deleted example content by accident | Window▸NullBolt▸Item Generator System▸Generate Example Content rebuilds the whole set; your Icons folder is preserved. Then Auto-Discover on the Configuration tab. |
| Seasonal/callback effects applying twice | OnPostGenerate is a static event — stale subscriptions survive domain reloads. Always pair subscribe/unsubscribe (OnEnable/OnDisable or an explicit toggle). |
Still stuck?
Email null.bolt.studios@gmail.com with your Unity version, the console warning, and — if it's a generation issue — the seed and template/rarity involved (that's a full repro for us). Or use the support form.