June 30, 2015

RomTerraria 4 Released

(6/11/2017 6:51pm: While the high resolution core of RomTerraria is now embedded into Terraria proper, they added in a forced minimum zoom level for higher resolutions.  New project created to take care of that.)

Note: This was tested on 1.3.3.  This does not work with 1.3.4 yet due to a change in visibility of a RenderTarget2D and some bugs in the new water code that I have to work around at higher resolutions.  A test build that supports v1.3.4.3 is available for download on this post, but has not yet been fully tested.

(9/11/2016 11:36am) Download RomTerraria 4 v1.2 here.  Updated for 1.3.3, and the instructions below have changed.

The v1.2 release fixes the "Retro" lighting issue introduced with v1.1. 

(6/28/2016 10:12am) Forgot to update this post with a link to the code on GitHub.

This release allows you to do the following:
  • Increase the maximum resolution of the Terraria client beyond 1920x1200.
  • Enable cooperative fullscreen mode.
  • Swap the left and right mouse buttons for our left-handed friends out there.  (new for v0.9)
  • If RomTerraria can't find your Steam folder, will now pop up a folder browser to let you tell it where your Steam or GOG version of Terraria is.  (new for v0.8)
  • Allow you to have the effects of the Gravity Globe without having the item equipped in an accessory slot.  Thanks to GamingWithRyan for the idea.  (new for v0.8)
  • Disable achievements (if you want).  (new for v0.2)

Terraria at 2560x1440

To use:
  1. Unzip to somewhere other than where Terraria is installed.
  2. Right-click on Terraria in Steam, go to Properties, go to Local Files, and then Verify Integrity of Game Cache.  Every crash I've looked at so far has been caused either by the game itself or a bad file somewhere.  This also resets your Terraria installation to the latest version of the game.
  3. Run Terraria once.  If you don't do this, you can run into situations where RomTerraria can't find or patch your version of Terraria.
  4. Run RomTerraria 4.0 (filename is RTRewriter.exe).
  5. Only select "Enable Cooperative Fullscreen" if you are running a multimonitor solution or know what this is.
  6. Click "Open Terraria Save Game Folder."
  7. Click "Update Terraria." A Terraria.exe file and an RTHooks.dll file will appear in your save game folder.
  8. Open your Terraria folder on Steam.
  9. Rename Terraria.exe to Terraria.Original.exe.
  10. Copy Terraria.exe, Terraria.exe.config, and RTHooks.dll from your Terraria save game folder to your Terraria folder.
  11. Launch the game from Steam.  The game may crash once.  If it does, run one more time.
  12. Starting with v1.3.3, Terraria won't let me default to the maximum resolution of your default monitor, so you will have to go into Settings > Video > Resolution to change your resolution.
If you select a higher resolution and it won't go above 1920x1200, go into windowed mode, change the resolution, then pick "Go Fullscreen" from the options menu.

Please note that if the game is updated, you'll have to repeat the above steps.

One note: the best thing that could ever happen to this mod would be for its main reason for existing (resolutions greater than 1920x1200) to cease to exist.  If Re-Logic would like the code to enable high resolutions, just let me know.  It's yours for free, and would take very little time to implement.

If you like it, and want to tip in Dogecoin, here's someplace you can send them:


I'm not able to go above 1920x1200.
I'm looking into each of these reports.  If you can't go higher than 1920x1200, enable cooperative fullscreen.  When cooperative fullscreen is enabled, I set the screen size to the size of the default display adapter (monitor 1), set full screen to false, and set the window style to "none," meaning it hides the border and widgets.

The game is crashing with RomTerraria installed.  (Note that this usually happens at resolutions higher than 4096 in any one direction.)
Try running v0.7.  You should now get a stack trace.  Post that stack trace in the comments.  If you can't post it to the comments, you can email it to romterraria -at- romsteady.net.  If you don't get a stack trace, it's okay.  I'm working on setting up a 3-monitor setup at home so I can troubleshoot it.

After installing RomTerraria, I can't open the map.
Go into Settings > General, and make sure "Map Enabled" is set.  It's been randomly disabling for some users.

After installing RomTerraria, I seem to be capped at 60fps.
If you are in cooperative full-screen mode, you'll be capped to your desktop refresh rate.
If you are in regular full-screen mode, I'm investigating that.

I can't get the game to run after this, I'm running Windows Vista/7/8/8.1, and my copy of Terraria is installed under C:\Program Files.
Please install the game to a different Steam install location (like C:\Steam) or run Windows Explorer as an administrator.  Windows Vista and above created a great security mechanism called VirtualStore which can make it look like you are mucking around inside C:\Program Files, but are actually working against a folder in your User folder.  The way Steam works, it won't like having the replacement Terraria.exe or RTHooks.dll in the VirtualStore folder.

How does this find my copy of Terraria?
I use .NET's Process.GetProcesses() function to get a list of all processes on your machine that have "steam" in the name.
If I find one named "steam.exe," I look for Terraria in [that file's folder]/SteamApps/Common/Terraria.
If I don't find it there, I assume that it's in a different Steam install folder, so I open your config/config.vdf file and look for the path in InstallConfigStore/Software/Valve/Steam/apps/105600/installdir.
If I don't find it there, or if I don't find Steam.exe, I look for the GOG version by checking the registry key HKEY_LOCAL_MACHINE\SOFTWARE\re-logic\terraria\install_path.
If it still can't find it after that, it pops up a browse dialog.

Old versions of RomTerraria patched out the need for Steam.  Will you do that in RT4?
No.  It works fine under Steam now due to how they handled Steamworks this time.

There are one or two new files in my save game folder: RomTerrariaDebug.txt and/or CrashInInitTargets.txt.  What gives?
RomTerrariaDebug.txt is a general purpose place where I can log out debug text.  Right now, I'm putting texture load debug info there if you've hooked the texture loader.
CrashInInitTargets.txt gives me all the info I need to troubleshoot hardware acceleration issues.

How do I uninstall this mod?
Right-click on Terraria in Steam, go to Properties, go to Local Files, and then Verify Integrity of Game Cache.  This will "unpatch" Terraria.

When I use this on the GOG version, I'm told to run this through Steam.  What gives?
This isn't happening for everyone, but I'm investigating the cause.

When can I expect a response to my questions?
I'll respond as quickly as I can, but the most likely time periods are between 7-8am Pacific and 7-10pm Pacific daily.

I'm technically advanced and think I can help out.
Code's on GitHub.  Have fun.

Older Version Archive:

v0.8 Download (works for
v0.7 Download (works for,,,  
v0.6 Download (works for, 
v0.5 Download (works for
v0.4 Download (works for
v0.3 Download (works for
v0.2 Download (works for
v0.1 Download (works for


Dreamxtreme said...

Looks Glorious. Thanks http://i.imgur.com/FaFFXrg.jpg

Michael Russell said...

No problem, Dreamxtreme.

Can't believe you had the Reddit thread up in less than 3 minutes. o_O;;

Unknown said...

I had to update a few times and change the settings about three times but am now running the game at 5960x1080 no problem! (user error?)

Thanks a bunch!

Tom said...

Can't get it to go above 1920x1080, might have to change the settings a few more times like someone else said, will report back tomorrow.

Michael Russell said...


Go into Windowed Mode. Set the full screen resolution while in Windowed Mode. Select "Go Fullscreen." Let me know if that works.

JJ said...

Hello Michael,

First of all, I'd like to thank you for taking the time to create RomTerraria. I have a triple monitor setup, and RomTerraria has been fantastic for allowing me to play Terraria across all three monitors.

I'm currently having trouble with the new 1.3 update. I can't seem to get Terraria to go beyond 1920 horizontal pixels. It might be locking to an aspect ratio, but I'm not sure (I'm using three 1920x1080 monitors, if that helps.)

Whether or not this issue is fixable, I thank you for the many hours of fun I've already had on past versions of RomTerraria.

Michael Russell said...


Try enabling cooperative multiscreen. A lot of code changed in 1.3, so it may take some time to get all the kinks ironed out.

creativerse said...

Works like a charm. I expected you to update RomTerraria for 1.3, sooner or later, but I didn't expect you to update that fast. Many thanks to you - you are awesome!

JJ said...


Thanks. I don't know if "Enable Cooperative Fullscreen" worked or if we had a classic case of PEBKAC (I'm leaning toward the latter), but I'm now running Terraria at 5760x1080 entirely thanks to you.

Thank you so much!

J Roza said...

it says 'unable to find Terraria' 'if steam version, make sure steam is running'. steam IS running, but it still doesn't work. help?

Also, there is no file called RomTerraria 4.0, just RTRewriter - is that the right file to run?

thank you!

Michael Russell said...

J Roza,

RTRewriter is the right program to run.

Please hit Ctrl-C on the "If Steam Version..." dialog and paste it into a comment here.

J Roza said...

Unable to find Terraria.

If the steam version, Make sure Steam is running.

If the GOG version, make sure you've run it once.

Could not find a process named Steam.exe running.

I'm running 64 bit win 8.1, 4670k processor, asus 49 280x, w/ 2560x1440p monitor if any of that info helps. Steam is installed on C:/, game is installed on backup E:/, but the file doesn't work regardless of where I run it from.

thank you for the response, seriously!

Michael Russell said...

J Roza,

Hit Ctrl-Shift-Esc to bring up Task Manager.

Go to the Details tab.

Scroll down. You should find three processes: Steam.exe, SteamService.exe, and SteamWebHelper.exe.

If you don't see them, I can't see Steam at all.

If you do see them, run RTRewriter as admin and try again.

J Roza said...

It turns out I have a problem running steamservice.exe, and I have no idea why. So it has nothing to do with your work, thanks for the help though? Doesn't matter what I do, steam service just does not want to run on my computer.

bqm11 said...

I am getting this error when i click go fullscreen in game? http://i.imgur.com/vOPZJFY.png

Michael Russell said...


Did you go into windowed mode first, set your resolution, then go into full screen?

This is still an early preview and there may be some kinks that I haven't found yet.

Joele Bayburt said...

I've followed the instructions, however I am not able to go above 1920x1080 in the settings menu - I am not using multi-monitors

Lellson W. said...

Awesome! 2560x1080 Resolution. I love you and your work <3

Xendrus Idziak said...

at 5900x1080 causes the game to crash when left or right clicking. Happens 100% of the time, I can move my character around but the moment I click "terraria has stopped working" without removing the fix, but changing the resolution to 1920x1080 the crashing stops and the game becomes playable.

handyplayer13 said...

When I start Terraria I get the error "Please launch the game from your Steam client.", which I do.

Help? :/

handyplayer13 said...

I cannot even start it anymore with the original files.

The Bear said...


WolfOfPvm said...

It crashes for me as soon as I get to a multiplayer world at 3840x2160. =\

Michael Russell said...

I'm looking into the crash logs I've been sent, and they either seem to be issues with 1.3 that are being worked on by Re-Logic, or bad files. I've updated the instructions and FAQ with workarounds.

Tom said...
This comment has been removed by the author.
Michael Russell said...


That has to be one of the weirdest glitches I've ever seen. I'm going to be adding more logging into tonight's build, and I'll set up a second monitor today to see if I can reproduce that.

Tom said...


Just deleted that post because I wanted to update it, but it appears to work when I change the resolution to 5760x1080 in the config.json file, although it will revert to 1920x1080 once I enter fullscreen mode. In windowed mode it still keeps a gap at the top for the title bar and doesn't adjust for the taskbar, so it's not the ideal situation, but the mod itself appears to work fine (well, except for the problem that I cannot select a resolution above 1920x1080 from the in-game settings).

JasonCrowley said...

I use multiple steam libraries across multiple drives. Terraria is installed on one of these alt locations. Despite launching Terraria several times, RT4-0.1 could not find my installation location. Eventually I tried removing C:\Program Files (x86)\Steam\config\config.vdf and restarting steam. This resolved my issue.

Tom said...

@Michael, after some testing it looks like the bug in the screenshot I posted earlier happens when WindowMaximized is set to true in the config.json file.

Bonus bug: http://i.imgur.com/7XRBIPW.jpg

Medic Grym said...

I'm having a really weird issue. I read through this whole post and everyone's comments to make sure it hasn't been stated before. Various semi-transparent items such as water, living wood leaves, and some sloped blocks are all invisible the majority of the time.

Michael Russell said...

v0.2 released.

Still looking into Medic Grym's and Tom's issues.

deeshu said...

After two days of trial and error I finally got it working (to some extent). Thanks for all the hard work!
Lets start with my setup:
I have three monitors, a 1920x1080 in the center and two 1280x1024 at the sides.
The center monitor is set as primary in windows, and the other two are set as extended (NO eyefinity/surround). Running windows 8.

After trying every know combination, this is what worked:
1. Patch and run Terraria.
2. Open up the program "Borderless gaming" and rightclick Terrara, select [Set as favorite by process id].
3. Rightclick Terraria in the favorites menu in borderlesss gaming, and select [No size change].
4. Close Terraria and open up conf.json (in your savegame folder).
5. Set "FullScreen" and "Maximizedwindow" to false, and set your resolution to the desired one (for me 4480 and 1080)
6. Save the file.
7. Run Terraria again. It should now be working!

The downside of this config is that the HUD is on the outer screens. Can you possibly add some kind of option to re-position the HUD?

Also, is there any way to donate?

Many thanks.

Andrew said...
This comment has been removed by the author.
Andrew said...

Thanks for the updates! Working on just fine! :D

Forgot to add, works at 1440p on, fullscreen. Not sure about other resolutions, but it's working great for me. Thanks again!

Duh Slayerr said...

I got it to work on all three monitors, but the water is missing and part of teh underground are invisible, i can see the sky background

Michael Russell said...

Duh Slayerr,

Working on that now.

Duh Slayerr said...

Thanks, i really appreciate it

Duh Slayerr said...

Im not sure what this means, but i deleted everything and reinstalled the game and the program. Everything seemed fixed. The water was there, underground intact and no black sky. I crashed though, a few moments later, and now when i start up the game, the water is missing, parts of the underground are invisible, and the corner of the sky is black.

Michael Russell said...

Duh Slayerr,

Are you using RT v0.4, or was that the stock product?

Duh Slayerr said...

Im using the download at the top of this page, RT4-0.4

Michael Russell said...

Okay, blinking textures can occur due to a race condition in the base product inside Terraria.Graphics.TextureManager.Load(). Unfortunately, he's eating the exception, so I'm not sure what I can do here yet...give me a moment.

Duh Slayerr said...

Here is a SS of before and after the crash, the bugs are in the second image. The water is invisible, and a part of the underground is as well.


Michael Russell said...

Duh Slayerr,

I'm almost done with a version of RT that hooks into the texture loader to look for issues restoring textures.

Duh Slayerr said...

Thanks a lot :)

Michael Russell said...

Duh Slayerr, Tom, Medic Grym,

There's a new option in RT4 v0.5 (now posted) that might help you.

BFtrnapster said...

The game crashes for me after 3 seconds after loading a world with a 7680x1440 resolution.
2560x1440 runs fine.

Michael Russell said...


Did you get any crash logs?

Duh Slayerr said...

Cant say that the new one worked. I clean installed the game, then RT4 v0.5. Got the 5790x1080 res for my setup, and as soon as i loaded up a world, the game crashed without any logs. Restarted 3 times, crashing every time immediately.

Then, on the fourth try, the game ran well for about 10 minutes. Water was there and the underground was intact. Only issue was the small black sky in the corner, which is really unnoticable when ur playing. I tried to see if it would not crash if i restarted the game, so i did.

However, this time the game didnt crash, but the water was invisible again and so were portions of the underground. Restarting again multiple times didnt change anything.

Im telling you this whole story because im not sure what you would find as useful info.
So the patch kind of worked, but then didnt.

Michael Russell said...

Duh Slayerr,

Was there anything in the error log in your save game folder?

Medic Grym said...

I tried v0.5 and got the following error the first time i launched Terraria

Terraria: Also try Edge of Space!: Terraria.exe - System Error
Exception Processing Message 0xc0000005 Parameters 0x000007FEFD74715C 0x000007FEFD74715C 0x000007FEFD74715C 0x000007FEFD74715C

Afterwards, it ran perfectly at 5756x1054.
I changed the resolution then went in and out of fullscreen, which promptly brought back the issue of invisible water.
I'm trying a work around by resizing the window using WinExplorer by NirSoft and the issue is no currently not present. I'll play for awhile to see if it randomly pops up.

Duh Slayerr said...

no, just dots

Michael Russell said...

Duh Slayerr,

Okay. I'll keep digging in.

Megic Grym's is an access violation due to unsafe code in .NET. I'll keep looking for interactions between RT and Terraria itself.

Medic Grym said...

I experience no issues using cooperative fullscreen and using WinExplorer to resize the screen. If i use Terraria's options to change it between fullscreen and windowed I experience the issue and i have to reset my window size every time i launch the game since it resets to 5756x1054.

That being said, I experienced the access violation only one time.

Daniel R. Perez said...
This comment has been removed by the author.
Ryan Puck said...

When I hit Update Terraria using the RTRewriter, i get an error message-


Method 'System.Void Terraria.Program::InternalMain(System.String[])' not found.

Bobby Pinder said...

I am getting the same error.

Berserker said...

Crashes on rewriting.

Tryv said...

I believe that the new hotfix today ( has broken the tool, i'm getting the same error (Method 'System.Void Terraria.Program::InternalMain(System.String[])' not found.) when trying to update.

Unknown said...

tool works fine for me

Hyggelik said...

v0.7 is still not working for me. Right after loading a game, it crashes on me.
The log file still only contains "=====" lines.
Tried multiple times - started everytime by verifying through steam.
Setup: 3 monitors with eyefinity (GTX 380).
Let me know if I can provide any additional info.

Thanks for putting in the time for this!

Tom Venckunas said...

Fixed the error, game is installed to C:\ drive when steam is on D:\ drive, i moved terraria folder to my original steam location drive (D:\) and it worked fine by pulling the files from there i suppose.

Duh Slayerr said...

Game crashes almost intantly after loading a world.
7/13/2015 3:28:46 PM
Microsoft.Xna.Framework.Content.ContentLoadException: Error loading "Images\Item_3601". File not found. ---> System.IO.FileNotFoundException: Error loading "Content\Images\Item_3601.xnb". File not found.
at Microsoft.Xna.Framework.TitleContainer.OpenStream(String name)
at Microsoft.Xna.Framework.Content.ContentManager.OpenStream(String assetName)
--- End of inner exception stack trace ---
at Microsoft.Xna.Framework.Content.ContentManager.OpenStream(String assetName)
at Microsoft.Xna.Framework.Content.ContentManager.ReadAsset[T](String assetName, Action`1 recordDisposableObject)
at Microsoft.Xna.Framework.Content.ContentManager.Load[T](String assetName)
at Terraria.Main.LoadContent()
at Microsoft.Xna.Framework.Game.Initialize()
at Terraria.Main.Initialize()
at Microsoft.Xna.Framework.Game.RunGame(Boolean useBlockingRun)
at Terraria.Program.LaunchGame(String[] args)

Michael Russell said...

Duh Slayerr,

Repair your install per the instructions. You're missing an image from the stock game.

Shpok said...

I'm also not able to start, encountering the following error with and without the mod installed. "Please launch the game from your Steam client."

Does the mod alter any other files besides what is in the common/terraria folder?
I am going to re-attempt a clean install.

Shpok said...

Turns out a restart of the computer system and reinstall allowed me to startup the stock game again.
For some reason steam is continually telling me that I need to download a 554byte file every time i verify game cache. The game still runs despite this happening though.

Retried with 0.6 and it now works.

Running win 7 64 bit (idk if this matters)

Nick Andresen said...

is there a way to get the menus on the center screen running 5760x1080 and the item menu is on my left monitor and health is on my right makes it hard to play looking left to right but other than that perfect

Hyggelik said...

Great work! 0.8 finally did it for me. Awesomeness!!! 5760x1080 with eyefinity.
Almost feels like cheating ;-)

Thanks for the effort

Lellson W. said...

Any chance of making this compatible with TModloader?

Michael Russell said...

Lellson W.,

tModLoader decompiles Terraria, applies patches to the decompiled source, then builds a new Terraria executable. RomTerraria works at the IL level and injects bytecode to either create hooks to an external DLL (RTHooks.dll) or changes functionality at a much lower level. The practical upshot is that Re-Logic can change their game and most of the time the patcher works without edits.

Given that I have to replace a resource as well as do a run-time patch of XNA to unlock higher resolutions, it's trickier. That said, you can try patching a RomTerraria-patched version of Terraria with tModLoader and see what happens.

Tek P said...

Download link isn't working Please mirror!!!! Can't wait to play!

Michael Russell said...

Tek P,

Working with my web host to get things back up. Looks like it went down less than an hour ago.

Michael Russell said...

Tek P,

Download should be working now. Hosting provider was applying patches.

Tek P said...

Mike, Thanks for fixing the link so quickly. The game unfortunately is crashing upon loading the world. here is the crash prompt phttp://imgur.com/TENVRtl

I tried to run 7680x1440 and 7880x1440 (bezel corrected)


Michael Russell said...

Tek P,

It's an out-of-memory exception. Since Terraria and XNA are 32-bit, it's capped to using 2GB of RAM. All the render targets combined are too large for memory. Try a single monitor for now.

Liam Games said...

Where is the Teraria.exe file?

Michael Russell said...

Liam Games,

If you are running Steam, right-click on the game in Steam, go to Properties -> Local Files -> Browse Local Files to find it.

If you are using the GOG version, you'll have to find where you installed it.

GnericHero said...

So, I have both the GoG and Steam version of Terraria installed, and RT-0.8 and 0.9 can't find my executable path, as I would have expected.

I wanted to patch my GoG version (Steam's been patched for a while) and Terraria on GoG works perfectly fine before patching. After patching, I cannot run it. So after scratching my head a while, disabling uac, screwing with antivirus, etc..

I wondered what the event viewer log would have to say.. and I found something.

Application: Terraria.exe
Framework Version: v4.0.30319
Description: The process was terminated due to an unhandled exception.
Exception Info: System.ArgumentException
at RTHooks.StartupHelpers.GetTerrariaFolder()
at Terraria.Program.LaunchGame(System.String[])
at Terraria.WindowsLaunch.Main(System.String[])

Looks like it's crapping out when it can't find the terraria folder. For what it's worth, the GoG install is located at c:\games\Terraria.

I have not yet run the Steam version of terraria on this install of windows. I assume that this can be fixable if I enter the registry key or run Steam Terraria (but then it would just look at my Steam folder...). For what it's worth, my running config.vdf also does not have the terraria install path in it either.

It seems if either of these paths were to work, something might actually end up working, but how would I know what directory it's sourcing the files from?

Might be able to solve this problem forever by checking if the current working directory looks valid and execute it.

And no, I'm not actually sure why I don't have a registry key for Terraria for the GoG version. Doesn't really make sense.

GenericHero said...

Well, it seems simply having a valid path in the registry to terraria works (presumably, the same version only works, I don't actually know what the code needs the terraria path for.) Once I added


it worked fine.

H. Sapiens said...

Would it be possible for you to make a port for Mac OS X? I would love to be able to play the game in fullscreen without distortion, but tragically I can't run .exes.

Spencer Acain said...

I just updated to the lastest version of the mod to work with 1.3.3, and everything works great except I can't change the lighting mode. It's just stuck on retro. Clicking it has no effect. I've tried editing config.json, but it has no effect, it either gets changed back, or ignored if the file is set to read only. Launching the unmodded version of the game allows normal lighting changes. I have no other mods installed.

If there is a way to fix this, I'd appreciate it.

jethro alvarez said...

Hi there. Tried the instructions many times and still doesn't work. My maximum resolution is only up to 1366x768.

Michael Russell said...


The lighting mode fix is in the newest version.


I'm going to assume that your monitor is 1366x768. Is that correct?

jethro alvarez said...


Yes, that is the the resolution of my monitor. Can I still push to a higher resolution using rom mod or I have to stick to monitor's resolution?

Michael Russell said...


Sorry, but I'm limited to the number of pixels on your monitor. The primary users of this mod have monitors with sizes like 2560x1440 or 3840x2160 and they use the mod to use resolutions higher than the default maximum of 1920x1200.



Hey Rom, don't know if you're aware but the tooltip for "Double The Size of the UI" is the same as "Act Like You Always Have Gravity Globe".