Installation, Updates and Recovery¶
This guide defines the standard installation and recovery content required for every documented MissionChief tool.
Before installation¶
- Confirm the tool's canonical source.
- Review its requested browser or userscript permissions.
- Record the currently installed version.
- Export settings where the tool supports it.
- Disable overlapping tools before the first test.
Standard installation flow¶
- Install a supported browser extension or userscript manager.
- Open the tool's canonical distribution page.
- Review the source and requested permissions.
- Install the script or extension.
- Reload MissionChief UK.
- Confirm that the tool is active only on the expected game domain.
- Test one feature at a time before enabling optional modules.
Update discipline¶
Automatic updates are convenient but can introduce breaking changes. Compatibility records should therefore state:
- where updates are downloaded from;
- whether updates are automatic;
- how to inspect the installed version;
- how to temporarily disable updates;
- how to return to a known working version when permitted by the project.
Fault isolation¶
When a page behaves incorrectly:
- reproduce the problem with all optional modules disabled;
- test the affected tool alone;
- re-enable other scripts individually;
- record browser, device, tool versions and affected page;
- inspect the browser console only when technically appropriate;
- report the smallest reproducible conflict.
Recovery¶
A complete tool record should explain how to:
- disable the tool;
- remove it;
- clear only its own stored settings where possible;
- restore an exported configuration;
- confirm that the base game works without the tool.
Never instruct users to erase all browser storage as the first recovery action.