Terraria: Best config.json for Modded Calamity FPS

Terraria is a CPU-intensive, single-threaded limited game. When running Calamity, the engine struggles to process thousands of projectiles and custom AI scripts. To stabilize FPS in 2026, we must force the game to bypass heavy visual shaders and increase the allocated stack size for the .NET runtime that tModLoader uses. This configuration focuses on Draw Limit reductions and Memory Management to prevent the dreaded “Slowdown” effect during boss fights.

File Paths

You will need to modify two distinct configuration files to fully optimize a modded environment:

• Main Config: %USERPROFILE%\Documents\My Games\Terraria\tModLoader\config.json
• Runtime Config: [tModLoader Installation Folder]\tModLoader.runtimeconfig.json

Technical Note: Always close tModLoader before editing these files. If you edit them while the game is running, the engine will overwrite your changes upon exit.

Optimized Main config.json Block

Open the main config.json and adjust the following visual and system keys to reduce the rendering overhead:

Key	Recommended Value	Technical Purpose
WaterfallDrawLimit	200	Drastically reduces the CPU cycles spent calculating liquid physics.
FilterLimit	4	Caps the number of simultaneous post-processing filters (e.g., Calamity’s biome tints).
DisableIntenseVisualEffects	true	Removes screen flashes and thunderstorms which cause frame-time spikes.
LightingMode	2	Forces Retro lighting (0=Color, 1=White, 2=Retro, 3=Trippy). Retro is the fastest.
Quality	0	Sets graphical quality to Lowest; reduces particle density significantly.
Support4K	false	Even if on a 4K monitor, rendering Terraria at 1080p/1440p stabilizes the UI thread.
BackgroundEnabled	false	Disables multi-layered parallax backgrounds.

The “Secret” FPS Fix: tModLoader Runtime Configuration

Many Calamity lag issues are actually caused by the .NET garbage collector or insufficient stack allocation. This edit is the most effective fix for high-end PCs experiencing low FPS:

{
  "runtimeOptions": {
    "configProperties": {
      "System.GC.Server": true,
      "DEFAULT_STACK_SIZE": "6400000"
    }
  }
}

By changing DEFAULT_STACK_SIZE from the default 400000 to 6400000, you provide the modded engine with enough “breathing room” to process Calamity’s complex projectile math without crashing or stuttering.

HowTo: Calamity Mod Specific In-Game Config

In addition to the JSON files, you must tune the Calamity Main Config via the in-game menu (Settings > Mod Configuration):

1. Afterimages: Set to Disabled. Calamity’s projectiles and bosses use afterimages that render the same sprite multiple times, doubling the GPU load.
2. Max Particle Limit: Set to 50 – 100. The default is often too high for boss rushes.
3. Bosses Stop Weather: Set to Enabled. This prevents rain/sandstorms from adding extra particle layers during boss fights.
4. Screenshake: Set to 0. Beyond being annoying, screenshake forces a re-draw of the entire canvas on every frame.
5. New Lighting Engine (Mod): Install the “High FPS Support” or “Lights Out” mod to further bypass the vanilla lighting bottlenecks.

Technical Explanation: Frame Skip and Game Speed

Terraria’s engine links game logic (ticks) directly to the frame rate. If your FPS drops below 60, the game appears to run in “slow-motion.” This is caused by the Frame Skip setting.

• Frame Skip ON: The game will skip rendering some frames to keep the game logic running at $1:1$ speed. This is essential for Calamity so the boss doesn’t take 20 minutes to complete its 5-minute cycle.
• Frame Skip OFF: The game waits to render every frame, causing the “slow-motion” effect.By optimizing the config.json with Retro Lighting and Disabled Backgrounds, you ensure that your hardware can stay above the 60 FPS threshold, allowing Frame Skip: ON to provide a fluid, high-speed competitive experience even in the late-game “Devourer of Gods” or “Exo Mechs” encounters.