Check Engine

Quick rating

Community listing page, reviews may not be monitored by the author.

Check Engine

By Uanme

No reviews yet

Your modpack's check engine light. Crash, missing mod, broken recipe or "Invalid player data" kick? It tells you what broke and how to fix it, in plain English. Undo bad updates, find the faulty mod, back up and rescue your worlds. Never touches gameplay.

Mod Loaders
Minecraft

About

Description

Check Engine: your modpack's warning light

GitHub NeoForge Forge

3 MC versions, 45 real packs tested, 0 false alarms, 1 jar

Your modpack broke? Check Engine tells you why, in plain English, and how to fix it.
One jar in your mods folder. No config. Never changes gameplay. Never goes online.

New in 0.18: "Invalid player data" explained · a Fixed! popup when a problem is gone · a backup offer when a mod goes back a version

How It Works

Press Play, Check Engine checks the pack, the light comes on with the fix, or nothing shows and you play

Broken Pack? Know in Seconds

The Check Engine window, shown before the loading screen

Right after you press Play, before the 5-minute load: what's wrong, what changed, and the fix.

Crash Doctor

Crash Doctor: a dragon egg keeps crashing the world, with a Rescue world button Crash Doctor: Minecraft ran out of memory, with the fix

Game crashed? The next launch says what happened and the fix, even for crashes with no crash report.
Crashes other players already solved come with their fix.
A broken mob or machine crashing your world? Rescue world backs it up and removes just that one.

Strip Mine (Beta)

Strip Mine: find the faulty mod

The crash doesn't say which mod? Strip Mine finds it, one launch per round. Mods you changed lately go first,
so it's often 2 or 3 launches. Nothing is deleted, and every mod goes back on at the end. Works for configs too.

Undo Buttons

Undo new mods: switch off the mods added since the pack last worked

It worked yesterday? Undo new mods and Undo config changes put the pack back to how it last started.
One click, nothing deleted, and you can put everything back. Fixed it? A Fixed! popup says so on the next launch.

After an Update

The pack was updated: what's new Worlds still use removed mods: 129,278 Create blocks, with a Back up worlds button

After a pack update, one screen says what's new, updated and removed.
A mod your world uses is gone, or went back to an older version? Check Engine warns you before you open the world, and backs it up in one click.
An update reset a mod's settings? It lists what changed and keeps your old settings file.

Recipe Check

The scan report in game: recipe clashes grouped by item, with the mods that add them

Type /checkengine scan to find recipes that clash, recipes nobody can craft and quest items nothing gives.
Click [Open report] in chat to read it in game, grouped by item, with the mods behind each one. Sees KubeJS and CraftTweaker changes too.

Why Can't I Join?

Can't join: mods don't match, with a Fix it button Mods fixed: the extra mod is switched off, Undo puts it back

Kicked because your mods don't match the server? Check Engine says which ones.
Press Fix it to switch off the extras and open the pages of the ones you need. Undo puts it all back.

New: kicked with "Invalid player data"? Check Engine names the mod that broke the join and the fix,
right on the kick screen. Server owners: /checkengine join explains the last kick.

What It Catches

Fault codes: CE-01 missing mod, CE-02 wrong build, CE-03 broken file, CE-04 mod switched off, CE-05 wrong version, CE-06 incompatible, CE-09 repeat crash

Plus duplicates, two mods doing one job, mods known not to get along, mods that went back a version,
mods made for a newer Java, client-only mods on servers, and too little RAM, caught before it crashes.

For Pack Makers

Works with Check Engine

Your pack's name and help link on every screen · a journal of every change · update notes ready to paste
mods flooding the log, config typos, missing textures · duplicate ores · an export check before you upload
quiet mode for warnings your players don't need · a Works with Check Engine badge for your page

Make your pack Check Engine ready in 2 minutes

Installation

Minecraft Loader Java
26.1.2 - 26.2 NeoForge 25
1.21.1 NeoForge 21
1.20.1 Forge 17

Client, server or both. Commands: /checkengine scan · join · startup · export (a help file to share).
Pack won't start at all? Check Pack.bat checks it without the game.
26.1.0 and 26.1.1 aren't supported: use 26.1.2 or newer.

FAQ

Can it break a working pack? No. It only says "won't start" when the loader is about to refuse anyway.

Does it change my pack? Only when you press a button (Undo, Strip Mine, Rescue world, Fix it, a backup).
Nothing is ever deleted: mods are renamed to .disabled and files are kept in a checkengine folder.

Does it go online? Never. Everything is checked on your PC.

Can I put it in my modpack? Yes, please! MIT licensed.

Feedback and Bugs

False alarm, missed crash or an idea? Leave a comment or open an issue with your help file.
Free and open source: github.com/Uanme37/CheckEngine