Anonymous edits have been disabled on the wiki. If you want to contribute please login or create an account.

Warning for game developers: PCGamingWiki staff members will only ever reach out to you using the official mail address.
Be aware of scammers claiming to be representatives or affiliates of PCGamingWiki who promise a PCGW page for a game key.


From PCGamingWiki, the wiki about fixing PC games
Terraria cover
Windows XNA
OS X, Linux FNA
Release dates
Windows May 16, 2011[1]
macOS (OS X) August 10, 2015[2]
Linux August 10, 2015[2]
Metacritic 83
OpenCritic 79
Monetization One-time game purchase
Microtransactions None
Modes Singleplayer, Multiplayer
Pacing Real-time
Perspectives Side view, Scrolling
Controls Direct control
Genres Action, Platform, Survival, Sandbox, Open world
Art styles Pixel art
Themes Fantasy
Series Terraria
Terraria on HowLongToBeat
Terraria on IGDB
Terraria guide on StrategyWiki
Terraria on MobyGames
Terraria on Wikipedia
Terraria 2011
Terraria 2 TBA

Terraria is a singleplayer and multiplayer side view and scrolling action, platform, survival, sandbox and open world game in the Terraria series.

General information

Official Terraria forums
Official Terraria Wiki Community Discussions Support Page
Steam Community Discussions


Source DRM Notes Keys OS
Icon overlay.png
Collector's Edition.
macOS (OS X)
macOS (OS X)
Humble Store
Icon overlay.png
macOS (OS X)
Icon overlay.png
macOS (OS X)
Linux (unavailable)
Icon overlay.png
Retail Collector's Edition.
macOS (OS X)


Type Notes
One-time game purchase The game requires an upfront purchase to access.


Type Notes
No microtransactions Game does not contain any microtransactions.

Game data

In-game general settings.
In-game general settings.

Configuration file(s) location

System Location
Windows %USERPROFILE%\Documents\My Games\Terraria\config.json
%USERPROFILE%\Documents\My Games\Terraria\input profiles.json
macOS (OS X) $HOME/Library/Application Support/Terraria/
Linux $XDG_DATA_HOME/Terraria/
This game follows the XDG Base Directory Specification on Linux.

Save game data location

System Location
Windows %USERPROFILE%\Documents\My Games\Terraria\
macOS (OS X) $HOME/Library/Application Support/Terraria/
Linux $XDG_DATA_HOME/Terraria/

Save game cloud syncing

System Native Notes
GOG Galaxy
Requires enabling backup of the Documents folder in OneDrive on all computers.
Steam Cloud


In-game video settings.
In-game video settings.

Graphics feature State WSGF Notes
Widescreen resolution
Use RTResolution.
Forces a higher zoom level. You can hack the executable as a workaround. Alternatively, install Better Zoom to gain the ability to zoom out past the cap.
4K Ultra HD
Field of view (FOV)
Change it in the settings or toggle it with Alt+ Enter.
Borderless fullscreen windowed
Anisotropic filtering (AF)
Anti-aliasing (AA)
Vertical sync (Vsync)
See the glossary page for potential workarounds.
60 FPS
120+ FPS
Game logic is capped at 60 FPS. Install High FPS Support to change FPS limit and remove limitation.
High dynamic range display (HDR)
See the glossary page for potential alternatives.


In-game control settings.
In-game control settings.

Keyboard and mouse State Notes
Mouse acceleration
No actively controlled camera.
Mouse sensitivity
No actively controlled camera.
Mouse input in menus
Mouse Y-axis inversion
No actively controlled camera.
Controller support
Full controller support
Controller remapping
Fully customizable, plus many presets.
Controller sensitivity
Can set deadzones; the game uses a cursor, so sensitivity is unneeded.
Controller Y-axis inversion
Can invert the X and Y axes on both thumbsticks.
Controller types
XInput-compatible controllers
Xbox button prompts
Impulse Trigger vibration
PlayStation controllers
Generic/other controllers
Additional information
Button prompts
DualShock Controllers use the DualShock Prompts Mod and Switch Controllers use the Nintendo Switch Prompts Mod.
Controller hotplugging
Haptic feedback
Digital movement supported
Simultaneous controller+KB/M
Changes button prompts by occasion
Steam Input
Steam Input API support
Official Steam Controller bindings only
Hook input (legacy mode)
Official controller preset(s)
Steam Controller button prompts


In-game audio settings.
In-game audio settings.
In-game language settings.
In-game language settings.

Audio feature State Notes
Separate volume controls
Sound, Music, Ambient
Surround sound
No voiced dialogue
Closed captions
Mute on focus lost
Royalty free audio


Language UI Audio Sub Notes
Simplified Chinese
Non-Latin text is not displayed in the stylized font.
Fan translation. Download here.
Brazilian Portuguese
Non-Latin text is not displayed in the stylized font. Numerous other issues have been reported by users.[3]
Fan translation by «L&K (Livan и Kiro)». Addresses issues with translation and fonts.


Multiplayer types

Type Native Players Notes
Local play
8 Co-op
Use Nucleus Co-op.
LAN play
255 8 max through Terraria.exe, 255 if using a dedicated server
Online play

Connection types

Type Native Notes
For dedicated server use, run the standalone command-line binary TerrariaServer.bin_x86_64 (64 bit, Linux and MacOS; _x86 for 32 bit) or TerrariaServer.exe (Windows) located in the root directory of the installation folder.
Direct IP


Protocol Port(s) and/or port range(s)
TCP 7777
Universal Plug and Play (UPnP) support status is unknown.

Issues unresolved

German version

The German (Steam) version of Terraria currently has lots of bugs and crashes (for example, social slot items); the only fix is to set the language to English.[citation needed]

Issues fixed

Game running slowly/low frame rate

Change Frame Skip and Lighting Settings[citation needed]

This usually happens when the game is running on an older PC. In Settings, make sure Frame Skip is set to "On" and Lighting is set to "Retro". This should increase performance.

OS X and Linux versions, update FNA to newer version[citation needed]

The OS X and Linux versions of the game use older versions of FNA. Updating to a newer version makes the game faster.[4] Copy and run a script to update FNA.

Game will not start

You may be missing required components[citation needed]

Download and install the following:

This should fix the problem.

Steam Overlay doesn't work

Use the -gameoverlayinject command line argument

XNA/.NET Installation Issues

Make sure to install .NET 4 before installing XNA 4. If that does not solve the issue, try uninstalling both of these and installing a clean copy of both.
Download them from their official websites[citation needed]

If you're having issues downloading either XNA or .NET try to install the files manually via their websites:

Teleporting mob lag in multiplayer

Limit FPS to 30[5]

Graphics Cards Issues

Make sure you have the most recent updates to your system[citation needed]

Check to make sure you have the most recent updates to your graphics card. You can do this through Steam (in Windows) by pressing (in the top right corner) 'Steam' > 'Check for Video Driver Updates...'.


Also check to make sure you have the most recent version of DirectX.
You should also check the list of XNA's Officially Supported Graphics Cards (XNA is the engine Terraria runs on) for your graphics card.

Control Configuration Issues (non-Steam)

Some users are reporting that they have blanked all their controls and are unable to set them again.
Delete config.dat[citation needed]
  1. Go to the configuration file location.
  2. Delete config.dat.

Hosting Issues

Firewall/Network Access[citation needed]

Make sure your Firewall is off or that it allows Terraria Network Access. View this forum thread to get information on giving Terraria Network Access.

Port forwarding[citation needed]

Look up port forwarding if you are trying to host behind a router.

Use Hamachi[citation needed]

If all else fails, you can use the third party program Hamachi. This allows you to simply host a server without having to forward your ports.

Game Crashes Immediately / Does Not Start

Set Steam and Terraria.exe to launch as an administrator[citation needed]

Try launching again, and make sure you have set both Steam and Terraria.exe to launch as an administrator (Windows Vista and Windows 7).

Game has reverted to an older version (Steam)

Verify your Game Cache[citation needed]

To force the game to update itself, you must Verify the Integrity of your Game Cache:

  1. Right click Terraria in your Steam Games Library and select 'Properties'
  2. In the new pop-up window, go to the 'Local Files' Tab
  3. Select 'Verify Integrity of Game Cache'

This will make sure all of your game files are up to date and automatically replace any damaged ones.

Switching to Cloud save and then back makes you lose discovery/map data/explored regions

Fix[citation needed]

This is a temporary issue with the game that will get fixed, but until then, this is what you need to know:

Switching to Cloud save takes the files off your computer, from %USERPROFILE%\Documents\My Games\Terraria\ Aside from your .plr player file, which keeps character information, what we're interested in are the .map files. For various reasons, what can happen is that the file that gets downloaded back either has one extra period before the extension, say instead of, or doesn't get downloaded at all. If it has extra periods, remove them and keep the extension. If you don't see the extension, then just remove all the extra periods at the end of it.

If you don't have your map data files there, try looking in your Steam cloud temporary folder, which can be found at <Steam-folder>\userdata\<user-id>\105600\remote It should be there. If it ain't there or in your My Documents location, download any file recovery software (I have had luck with Recuva) and point it to the Steam cloud temporary location. With luck, it's recoverable. (This can happen when no valid files are present in the Documents location, so go to cloud, local, then cloud.) If you have more than one set of files, go for the most recent set (the one with more periods or the last modified date is the latest) and remember that each is saved per world your character has visited.

Invisible mouse pointer on Linux

Disable Xbox driver[6]

The issue is caused by the game detecting a running Xbox driver, used to enable the Xbox gamepad, and switching to controller mode. It is not necessary to have a controller currently attached for this to happen. To fix this, stop the Xbox driver:
sudo service xboxdrv stop
Upon the next game start, the hints for controller buttons will be hidden and the mouse will be visible.

Can't use the hotbar on non-QWERTY layouts on Linux

Configure FNA[7]

Edit <Steam-folder>/steamapps/common/Terraria/Terraria to set the FNA_KEYBOARD_USE_SCANCODES environment variable to 1.
The last two lines of the file should look like this:

./${BASENAME}.bin.${ext} $@

Other information


Technical specs Supported Notes
Direct3D 9.0c
OpenGL 3.0 OS X and Linux only.
FNA builds only. Use /gldevice:Vulkan command line argument.
Shader Model support 2.0
Executable 32-bit 64-bit Notes
macOS (OS X)

Convert normal version of Terraria into the Collector's Edition

Modify registry[8]

1. Windows

  1. Open Registry Editor (can be done by typing regedit into Start Menu's search bar and pressing Enter/Return).
  2. Go to HKEY_CURRENT_USER\Software\Terraria.
  3. Create a new String Value (right click on a blank field).
  4. Change it's name to Bunny and value to 1.
  5. Close the Registry Editor.

2. MacOS/Linux

  1. Open a text editor
  2. go to ~/.mono/registry/CurrentUser/software/terraria/
  3. Make a file named values.xml and paste <values><value name="Bunny" type="string">1</value></values>
  4. save and exit


Middleware Notes
Multiplayer Steamworks

System requirements

Minimum Recommended
Operating system (OS) XP SP3, Vista
Processor (CPU) 1.6 GHz
System memory (RAM) 512 MB
Hard disk drive (HDD) 200 MB
Video card (GPU) 128 MB of VRAM
DirectX 9.0c compatible
Shader model 1.1 support
macOS (OS X)
Minimum Recommended
Operating system (OS) 10.9.5
Processor (CPU) Intel 2.0 GHz
System memory (RAM) 2.5 GB
Hard disk drive (HDD) 200 MB
Video card (GPU) 128 MB of VRAM
OpenGL 3.0 compatible
A 64-bit operating system is required.
Minimum Recommended
Operating system (OS) Ubuntu 14.04 LTS
Processor (CPU) 2.0 GHz
System memory (RAM) 2.5 GB
Hard disk drive (HDD) 200 MB
Video card (GPU) 128 MB of VRAM
OpenGL 3.0 compatible