Terraria: Best config.json for High Resolution Scaling

The primary goal for high-resolution scaling in Terraria is maintaining Pixel Perfect clarity while ensuring the HUD is readable. The engine handles high resolutions by increasing the “view distance” (showing more tiles), which can sometimes lead to performance drops during events like the Lunar Pillars. By editing the config.json, we can toggle the hidden Support4K flag and manually override the UIScale to match high-DPI displays.

Hardware Compatibility & Expectations

• GPU Memory: While Terraria is a 2D game, rendering at 4K with high zoom levels increases the “Tile Draw” count significantly. Ensure you have at least 4GB of VRAM for a smooth experience.
• DPI Awareness: Windows Scaling (150% or 200%) can sometimes conflict with Terraria’s internal scaling. We will address this by forcing the game to be DPI-aware via the config.
• Ultrawide Limit: Terraria has a native width limit of 4096 pixels. If you are on a 5120×1440 monitor, the game will have black bars or slight stretching unless you use third-party mods like Better Zoom.

Backup and Preparation

Terraria updates this file every time you change a setting in the menu. Always edit with the game closed.

1. Completely exit Terraria.
2. Navigate to your Documents folder (path below).
3. Copy config.json and save a backup named config_backup.json.
4. Open the original with Notepad++.

File Location

The configuration file is located in the My Games subfolder: C:\Users\%USERNAME%\Documents\My Games\Terraria\config.json

Best config.json Settings for 4K / High Res

Search for these specific keys and update their values. These settings ensure 4K is enabled and the UI is scaled for readability:

{
  "Support4K": true,
  "UIScale": 1.5,
  "Zoom": 1.0,
  "DisplayWidth": 3840,
  "DisplayHeight": 2160,
  "Fullscreen": true,
  "WindowMaximized": true,
  "WindowBorderless": false,
  "SettingDontScaleMainMenuUp": false
}

Pro Tip: If your UI is still too small on a 4K monitor, you can push "UIScale" to 2.0 or higher. While the in-game slider stops at 200%, the config file allows for granular decimal values (e.g., 2.25) for perfect alignment with your vision.

Key Parameters Explained

Parameter	Recommended Value	Impact
Support4K	true	Unlocks 3840×2160 and higher options in the video menu.
UIScale	1.2 – 2.5	Adjusts the size of the inventory, health bar, and text.
SettingDontScaleMainMenuUp	false	Ensures the Main Menu scales to fill the screen rather than staying in a small box.
DisplayWidth / Height	[Native]	Forces the game to launch at your monitor’s exact pixel count.
Zoom	1.0	Sets the default world view. 1.0 is the standard “Retina” level for 4K.

In-Game Settings vs. Config

To complement your high-res profile, match these in-game Video settings:

• Lighting: Set to Color or White. Avoid “Retro” or “Trippy” at 4K as they can cause strange tile-bleeding artifacts at high resolutions.
• Parallax: Set to 0 or 5 to reduce motion sickness that is often amplified on large, high-resolution screens.
• High DPI Fix: Right-click Terraria.exe > Properties > Compatibility > Change high DPI settings > Check “Override high DPI scaling behavior” and set it to Application. This prevents Windows from “blurry scaling” the game.

Troubleshooting & Common Fixes

• Missing 4K Option: If 4K doesn’t appear even with Support4K: true, ensure your GPU drivers see the monitor as a “Native 4K” display and that you aren’t using an older HDMI cable capped at 1080p.
• Black Screen on Launch: This usually means the DisplayWidth or DisplayHeight values are slightly off. Set Fullscreen to false in the config to force it into a window, then fix the resolution in-game.
• Cursor Lag: High resolutions increase the input latency of the hardware cursor. Enable “Smart Cursor” and ensure Frame Skip is set to On to keep the mouse synced with the refresh rate.

Frequently Asked Questions (FAQ)

Conclusion and Expected Results

By manually refining your config.json, you are bypassing the legacy resolution limits of the XNA framework. You can expect crisp 4K visuals, a perfectly sized interface that doesn’t strain your eyes, and a massive field of view that makes navigating the Jungle or Dungeon significantly easier.