How to Fix a Better Minecraft Server That Keeps Crashing
Better Minecraft (BTMC) is a large Fabric modpack. Most crashes come from one of a small set of causes — wrong Java, too little RAM, a Fabric loader mismatch or a conflicting config. Here's how to fix each.
Too little RAM
BTMC loads 150+ Fabric mods. 6 GB is the minimum; less causes OutOfMemoryError crashes after a few minutes of play. Fix: increase server RAM to at least 6 GB, preferably 8 GB for a group.
Wrong Java version
Better Minecraft runs on 1.20.1 which requires Java 21. Java 17 or lower causes UnsupportedClassVersionError on startup. Fix: install Java 21 and update your start script to point to it.
Fabric loader mismatch
BTMC specifies an exact Fabric loader version. Using a newer loader before the pack is updated for it breaks compatibility. Fix: install the exact Fabric Loader version listed on the BTMC CurseForge page for your pack version.
Missing or outdated Fabric API
The bundled Fabric API version must match the loader. If you manually updated Fabric API without updating the loader (or vice versa), crashes follow. Fix: use the exact mod versions from the pack's manifest rather than updating Fabric API independently.
Config file corruption
A server restart during a config write leaves a malformed JSON or TOML file. Fix: check logs for 'Failed to load config', delete the named config file from the /config/ folder and restart — the mod regenerates it with defaults.
Mod conflict from added mods
Adding extra mods to BTMC is common but risky. An extra mod may conflict with a bundled one. Fix: remove any manually added mods and test with the base pack first, then add back one at a time.
FAQ
What Java version does Better Minecraft need?+
What is the minimum RAM for a Better Minecraft server?+
Can I add extra mods to a Better Minecraft server?+
How do I read Better Minecraft crash logs?+
Host your Better Minecraft server from €10/month
CoalHost runs Better Minecraft with Fabric, Java 21 and auto-backups pre-configured.
View Better Minecraft Hosting →