Troubleshooting

Troubleshooting

Chunky Idle says Chunky was not found

Confirm Chunky is installed in the server's mods directory and enabled for the server. Chunky Idle stays inactive when Chunky is unavailable.

Settings could not be loaded

Check config/chunkyidle/config.yml for invalid YAML or an unsupported value. Fix the file, then run /chunkyidle reload. If startup configuration loading fails, automation stays inactive until the file is fixed and successfully loaded.

A task did not resume after a restart

Restart recovery requires a graceful shutdown. Confirm both server-restart.enabled and automation.enabled are true, and check that server-restart.tasks-to-resume includes the task. An abrupt crash may not save the latest task snapshot.

A manually paused task resumed

The any-saved restart policy may resume tasks an administrator paused manually. Choose active-before-shutdown to limit recovery to tasks Chunky Idle recorded.

A running task was not paused when a player joined

Chunky Idle only handles tasks that were running when the join event occurred. A new task started while players are already online will not be paused until another player joins. Also check that automation.enabled is true.

See Configuration and Commands for more help.