Troubleshooting

Common The Last Sun startup and behavior issues, with the checks that actually resolve them.

Updated 2026-11-14

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.