🎮 Game Error Codes What it means & how to fix it

Terraria Won't Launch? Here's the Fix

When Terraria won't launch — it crashes silently, or throws a Microsoft.Xna.Framework.dll error — the cause is almost always a missing XNA Framework 4.0 runtime or a corrupt config. Install XNA 4.0, and if it still fails, run TerrariaServer.exe to see the real error instead of guessing.

Exact details for Terraria

Required runtime
Microsoft XNA Framework Redistributable 4.0
Read the real error
Run TerrariaServer.exe from the game folder (opens a console with the error)
Config to delete
Documents\My Games\Terraria\config.json
Common cause of silent crash
Missing XNA 4.0 / .NET 4.x runtime

Error codes

Microsoft.Xna.Framework.dll error / XNA Framework error A required runtime is missing

Cause: XNA Framework 4.0 Redistributable not installed.

Fix:
  1. Install the Microsoft XNA Framework Redistributable 4.0 and finish the wizard.
  2. Also install/repair .NET Framework 4.x (Terraria depends on it).
  3. Reboot after installing the runtimes.
  4. Verify integrity of game files in Steam.
Game closes with no error report Terraria exits before the window appears

Cause: Corrupt config or a hidden startup error.

Fix:
  1. Delete config.json in Documents\My Games\Terraria so it regenerates.
  2. Run TerrariaServer.exe from the game folder to see the actual error in a console.
  3. Run sfc /scannow from an Administrator prompt to repair Windows files.
  4. Disable overlays (Discord/Steam) and run as Administrator.
tModLoader won't start after update The modded launcher fails where vanilla works

Cause: Broken mod or mismatched tModLoader build.

Fix:
  1. Launch vanilla Terraria first to confirm the base game runs.
  2. Disable all mods, then re-enable them one at a time.
  3. Verify tModLoader files and match the expected Terraria version.
  4. Clear the tModLoader mod cache in %UserProfile%\Documents\My Games.

Fixes that work for most Terraria errors

  1. Install Microsoft XNA Framework Redistributable 4.0 — the #1 fix.
  2. Install/repair .NET Framework 4.x and reboot.
  3. Delete config.json in Documents\My Games\Terraria.
  4. Run TerrariaServer.exe to read the real error message.
  5. Run sfc /scannow to repair Windows files.
  6. Verify game files; for tModLoader, disable mods and match versions.

FAQ

How do I fix the Terraria XNA Framework error?

Install the Microsoft XNA Framework Redistributable 4.0 and complete the wizard, then reboot. Terraria will not start without it. Also make sure .NET Framework 4.x is installed.

Terraria won't launch and shows no error — what now?

Open the game folder and run TerrariaServer.exe directly; it opens a console that prints the actual startup error. Also delete config.json in Documents\My Games\Terraria so a fresh config regenerates.

Why does vanilla Terraria work but tModLoader won't launch?

A broken mod or a tModLoader build that doesn't match your Terraria version. Disable every mod, verify tModLoader files, then re-enable mods one by one to find the culprit.

Other games