GRiMbot documentation

Failed Update Recovery

This is the hosted copy of the GRiMbot technical manual. Use the table of contents to open any page in the manual.

Use this page when a Core or plugin update leaves GRiMbot unable to start, GRiMbOS blank, or plugins refusing to load.

Isolate the failure

Symptom	Likely area	First check
Process will not start	Core files or `.env`	Logs next to the launcher. Confirm `.env` was not replaced.
GRiMbOS loads, windows missing	Frontend build or plugin registry	About version. Plugin list in Add/Remove Plugins.
One plugin fails	That zip vs Core version	Plugin page and Logs and Diagnostics.
Twitch disconnected after update	Token or EventSub	System Status, then Re-register events.

Stop GRiMbot.
Confirm data/ and .env still exist and were not overwritten.
Reinstall the previous Core package into the same folder.
Start GRiMbot.
Confirm GRiMbOS and Connection Status.
Keep the failed package for notes. Do not retry it until Release notes are understood.

If data/ was overwritten, Restore from the Back Up taken before the update.

Note the zip name and version.
Uninstall that plugin in Add/Remove Plugins if GRiMbOS still opens.
Restart when asked.
Install the last known working zip.
If GRiMbOS will not open, stop GRiMbot and restore data/plugins/installed/ from the Back Up.