Common issues
Launcher won’t start
Try restarting your PC first. If the issue persists, reinstall the launcher and ensure your system meets the requirements. If you’re on Windows, SmartScreen may appear for new/uncommon apps — that’s normal for unsigned builds.
Mods not working
Most mod issues come from mismatched loaders or versions. Double-check:
- You installed mods for the correct loader (Fabric vs NeoForge)
- All mods match your Minecraft version
- Required dependencies are installed
Instance crashes on launch
Remove the last mod(s) you installed and try again. If it boots, add mods back in smaller batches. This makes conflicts obvious.
Account / login issues
Log out and log back in. If you still have problems, clear local site data and try again.
Cloud sync not updating
Make sure you’re online and logged in. Sync can take a few seconds — closing and reopening the launcher can trigger a refresh.
Contact
If you’re stuck, email support@fishbattery.app or ask in Discord.