Troubleshooting

Common Issues

Game Crashes on Startup

Symptoms: Minecraft crashes immediately after launching with mods installed.

Solutions:

1. Check Minecraft version - Ensure you're using the correct version
2. Verify mod loader - Make sure Forge/NeoForge matches your mods
3. Check Java version - Mods require Java 17 or higher
4. Review crash log - Look for specific error messages

Mods Not Loading

Symptoms: Mods don't appear in the Mods list.

Solutions:

1. Check file location - Mods must be in the mods folder
2. Verify file extension - Ensure files are .jar, not .zip
3. Delete version folders - Remove any mods/1.x.x folders
4. Reinstall the mod - Download a fresh copy

Performance Issues

Symptoms: Low FPS or stuttering with mods installed.

Solutions:

1. Install performance mods - Sodium, Lithium, Starlight
2. Reduce render distance - Lower from 16 to 12 chunks
3. Adjust mod settings - Many mods have performance options
4. Allocate more RAM - Set 4-6GB in launcher settings

Missing Textures

Symptoms: Purple and black missing texture patterns.

Solutions:

1. Update the mod - Textures may have changed in newer versions
2. Check resource packs - Disable conflicting resource packs
3. Verify installation - Reinstall the mod cleanly

Getting Support

If you can't resolve an issue:

1. Gather information:

   • Minecraft version
   • Mod loader and version
   • Mod version
   • Full crash log (if applicable)

2. Report the issue:

   • GitHub Issues (preferred)
   • Discord support channel
   • CurseForge comments

3. Be patient - I respond to issues within 48 hours

Useful Commands

# Check loaded mods (requires Forge)
/modlist

# Export crash report
/crashreport

# Reload resources
/reload