Most problems come down to one of four causes: a missing dependency, a client that does not match the server, a setting that was not saved, or the fact that some changes only affect newly generated content.
#Quick triage
| Symptom | Most likely cause | Fix |
|---|---|---|
| Mod does not load | Missing or outdated dependency | Check Installation and Compatibility |
| Game crashes on launch | Loader or Fabric API mismatch | Update Fabric Loader and Fabric API |
| Settings button is missing | Client-side mod is not active | Confirm the mod is installed on the client too |
| Ancient City still generates | Setting not saved, or chunk already existed | Save the setting, then generate new chunks |
| Warden still appears | Spawned by command during a session, or the setting is on | Turn the setting off and reload the world, or use operator commands |
| Crops will not grow underground | Light level below the minimum | Raise the light level or check Agriculture |
| State reset after restart | World saved-data issue | Check that you are not loading a different world |
#Load and dependency checks
The mod requires:
| Requirement | Minimum |
|---|---|
| Minecraft | 1.21.11 |
| Fabric Loader | 0.18.2 |
| Java | 21 |
| Fabric API | Required |
| GlitchCore | 21.11.0.1 |
| Tough As Nails | 21.11.0.4 |
Warning
Tough As Nails is a required dependency (see fabric.mod.json). If its temperature API cannot be integrated at runtime, cold effects are disabled but the rest of the mod keeps running. The mod also edits an existing config/toughasnails/thirst.toml to disable thirst; it does not create that file if it is missing.
#Settings not applying
| Check | Detail |
|---|---|
| Did you click Save? | Preview changes are reverted if you close the screen. |
| Are you the owner or an operator? | Only those can edit settings. |
| Is the chunk new? | Ancient City changes affect newly generated chunks only. |
| Did the setting sync? | The server value is authoritative and is pushed to clients. |
#Behavior checks
| Area | Where to look |
|---|---|
| Climate stages | Climate |
| Environmental effects | Environment |
| Crops and farmland | Agriculture |
| Commands | Commands |
| Config values | Configuration |
#If something is not documented
If a behavior is not covered here, it is likely not implemented in beta 1.0.0. See Planned and Unverified.