TROUBLESHOOTING

Troubleshooting Guide

Solutions to common tModLoader issues and problems.

Installation Issues • Mod Problems • Multiplayer Issues

Game Won't Launch

Symptoms: tModLoader crashes on startup or won't open at all.

Solutions:

  • Update .NET Framework: Install version 4.7.2 or newer from Microsoft (see installation guide for details)
  • Verify Game Files: Right-click tModLoader in Steam → Properties → Local Files → Verify integrity
  • Run as Administrator: Right-click tModLoader.exe → Run as administrator
  • Check Event Viewer: Look for error messages in Windows Event Viewer

Mods Not Loading

Symptoms: Installed mods don't appear or won't enable.

Solutions:

  • • Verify mods are enabled in Mods menu
  • • Update to latest tModLoader version
  • • Check mod compatibility
  • • Look for mod dependencies
  • • Disable conflicting mods

Performance Issues

Symptoms: Game runs slowly, low FPS, stuttering.

Solutions:

  • • Reduce number of active mods
  • • Lower graphics settings
  • • Close background applications
  • • Disable visual effect mods
  • • Increase virtual memory (page file)

Additional Common Issues

"Out of Memory" Errors

Symptoms: Game crashes with memory error, especially with large mod packs

Solutions:

  • • Close other applications to free RAM
  • • Reduce number of active mods
  • • Increase virtual memory (page file) in Windows
  • • Use 64-bit tModLoader if available
  • • Upgrade RAM to 8GB+ for large mod packs

Mod Conflicts

Symptoms: Crashes when specific mods are enabled together

How to Identify:

  1. 1. Disable all mods
  2. 2. Enable mods one by one
  3. 3. Test each time to find problematic combination
  4. 4. Check mod descriptions for known conflicts
  5. 5. Visit mod's Steam Workshop page for updates

Save File Corruption

Symptoms: Can't load world or character after using mods

Prevention & Recovery:

  • ✓ Always backup saves before adding major mods
  • ✓ Use tModLoader's built-in backup feature
  • ✓ Keep backup copies in separate location
  • ✓ If corrupted: check .bak files in same folder
  • ✓ Some saves may recover after removing problematic mod

Steam Workshop Not Working

Symptoms: Can't subscribe to or download Workshop mods

Solutions:

  • • Verify internet connection is stable
  • • Restart Steam client
  • • Clear Steam download cache
  • • Check Steam's server status
  • • Use in-game Mod Browser as alternative

Performance Optimization Tips

Maximize FPS with Mods

In-Game Settings

  • • Lower frame skip to "On"
  • • Reduce lighting quality
  • • Disable background effects
  • • Lower resolution if needed

Mod Selection

  • • Disable visual effect mods
  • • Limit total active mods to 20-30
  • • Avoid multiple large content mods
  • • Prioritize essential mods only

System Optimization

  • • Close unnecessary programs
  • • Update graphics drivers
  • • Increase page file size
  • • Run as administrator

Memory Management

  • • Restart game every 2-3 hours
  • • Clear mod browser cache periodically
  • • Avoid keeping too many worlds
  • • Delete unused mod files

Understanding Log Files

Log files help diagnose issues. Learn how to read them.

Log File Locations

Documents/My Games/Terraria/tModLoader/Logs/

Key files:

  • • client.log - General game log
  • • Mods/ folder - Individual mod logs
  • • Latest log file shows most recent session

Reading Error Messages

Common error indicators in logs:

ERROR Critical problem that needs fixing
WARN Potential issue, may cause problems
INFO Normal operation, no action needed

Still Need Help?

Can't find solution here? Try these resources:

Discord Support
Get instant help from community
GitHub Issues
Report bugs to developers
Forums
Ask the community

When Reporting Issues:

  • ✓ Include tModLoader version number
  • ✓ List all enabled mods
  • ✓ Attach client.log file
  • ✓ Describe steps to reproduce
  • ✓ Mention your operating system