tModLoader

Using Steam? Simply update TML through Steam.
Not updating? Relaunch Steam. Please note it sometimes can take a while for the update to reach every Steam client.
GOG or Steam family share not working? Read the manual install instructions

If you haven't updated to Terraria 1.4.3.6 yet, please do that. As always, this is not an update with the Journeys End content, that is still being worked on. Feel free to join the 1.4 alpha via steam to help test it, you'll find more info on our Discord.

Fixes

• Fix recent Mod Browser offline issues

Using Steam? Simply update TML through Steam.
Not updating? Relaunch Steam. Please note it sometimes can take a while for the update to reach every Steam client.
GOG or Steam family share not working? Read the manual install instructions

If you haven't updated to Terraria 1.4.3.6 yet, please do that. As always, this is not an update with the Journeys End content, that is still being worked on. Feel free to join the 1.4 alpha via steam to help test it, you'll find more info on our Discord.

Fixes

• Update hash checks for GOG users to play alongside Terraria 1.4.3.6 installs. (This is the 2nd version of 1.4.3.6 with the new wiki link)

Using Steam? Simply update TML through Steam.
Not updating? Relaunch Steam. Please note it sometimes can take a while for the update to reach every Steam client.
GOG or Steam family share not working? Read the manual install instructions

If you haven't updated to Terraria 1.4.3.6 yet, please do that. As always, this is not an update with the Journeys End content, that is still being worked on. Feel free to join the 1.4 alpha via steam to help test it, you'll find more info on our Discord.

Fixes

• Update hash checks for GOG users to play alongside Terraria 1.4.3.6 installs.
• Fix an issue causing some downloads to fail with a message about content length

Other

• New Patreon sets. Thanks Tantamount for your support.

Using Steam? Simply update TML through Steam.
Not updating? Relaunch Steam. Please note it sometimes can take a while for the update to reach every Steam client.
GOG or Steam family share not working? Read the manual install instructions

If you haven't updated to Terraria 1.4.3.2 yet, please do that. As always, this is not an update with the Journeys End content, that is still being worked on. Feel free to join the 1.4 alpha via steam to help test it, you'll find more info on our Discord.

Fixes

• Update hash checks for GOG users to play alongside Terraria 1.4.3.2 installs.

Other

• New Patreon sets. Thanks dschosen and AlejandroAkbal for your support.

Using Steam? Simply update TML through Steam.
Not updating? Relaunch Steam. Please note it sometimes can take a while for the update to reach every Steam client.
GOG or Steam family share not working? Read the manual install instructions

If you haven't updated to Terraria 1.4.2.3 yet, please do that. As always, this is not an update with the Journeys End content, that is still being worked on. Feel free to join the alpha for 1.4, you'll find more info on our Discord.

Fixes

• Fixed steam invite joining
• Updated the mod load error message to be less sensitive to version number differences
• New download link for v45ReferenceAssemblies.zip

Other

• New Patreon set. Thanks Zeph for your support.

Using Steam? Simply update TML through Steam.
Not updating? Relaunch Steam. Please note it sometimes can take a while for the update to reach every Steam client.
GOG or Steam family share not working? Read the manual install instructions

If you haven't updated to Terraria 1.4.2.3 yet, please do that. As always, this is not an update with the Journeys End content, that is still being worked on.

Fixes

• Updated GOG install verification.
• Update Brazilian Portuguese Localization. Thanks @Pixelnando

Using Steam? Simply update TML through Steam.
Not updating? Relaunch Steam. Please note it sometimes can take a while for the update to reach every Steam client.
GOG or Steam family share not working? Read the manual install instructions

If you haven't updated to Terraria 1.4.2.1 yet, please do that. Music will not work until you do. As always, this is not an update with the Journeys End content, that is still being worked on. This is a hotfix, see v0.11.8.2 release for other recent changes.

Fixes

• Updated GOG install verification.

Using Steam? Simply update TML through Steam.
Not updating? Relaunch Steam. Please note it sometimes can take a while for the update to reach every Steam client.
GOG or Steam family share not working? Read the manual install instructions

If you haven't updated to Terraria 1.4.2 yet, please do that. Music will not work until you do. As always, this is not an update with the Journeys End content, that is still being worked on.

Fixes

• Updated GOG install verification.

API

• Fix Visual Studio 16.9 build issue
• DustID class fleshed out. Thanks @SmugBlanco

ExampleMod

• Example Hermes Boots. Thanks @naakaamura
• Example Minecart. Thanks @FullOfXP
• Example Flamethrower. Thanks @LawnmowerKing

Using Steam? Simply update TML through Steam.
Not updating? Relaunch Steam. Please note it sometimes can take a while for the update to reach every Steam client.
GOG or Steam family share not working? Read the manual install instructions

If you haven't updated to Terraria 1.4.1.2 yet, please do that. Music will not work until you do. As always, this is not an update with the Journeys End content, that is still being worked on.

Fixes

• Fixed client networking potentially taking up an entire processor core. This should fix some multiplayer issues. Thanks @Solxanich
• Fix Mac GOG install, it should now work according to the instructions. Thanks @sgb and @NickVolynkin

Other

• New Patreon sets. Thanks Coolmike5000, Sailing_Squid, and AetherBreaker for your support.

Using Steam? Simply update TML through Steam.
Not updating? Relaunch Steam. Please note it sometimes can take a while for the update to reach every Steam client.
GOG or Steam family share not working? Read the manual install instructions

If you haven't updated to Terraria 1.4.1.2 yet, please do that. Music will not work until you do. This release is mainly some fixes for mod developer issues. As always, this is not an update with the Journeys End content, that is still being worked on.

Fixes

• Better display of referenced mods in tooltip
• Update Spanish and Chinese localization. Thanks @Igmc and @sgkoishi

API

• Fix Visual Studio 16.8 build issue
• Updated MonoMod to avoid some issues. Thanks @Mirsario

Other

• New Patreon sets. Thanks Guildpack and Elfinlocks for your support.

Using Steam? Simply update TML through Steam.
Not updating? Relaunch Steam. Please note it sometimes can take a while for the update to reach every Steam client.
GOG or Steam family share not working? Read the manual install instructions

With the recent 1.4.1.2 release, tModLoader could no longer load the music, causing a wide variety of bugs. This release fixes that. As always, this is not an update with the Journeys End content, that is still being worked on.

Fixes

• Fix Music loading issues caused by Terraria 1.4.1.2 update. This should fix all issues that started happening within the last few days.
• Fix unhelpful "tModLoader.ClientLogHint" message issue
• Fix Patreon and Dev set distribution issue
• Fix prechatbuttonclicked issue when clicking on Grave tiles. Thanks @direwolf420
• Fix projectile.projUUID netcode issue. Thanks @Ozzatron
• Fix potential npc.aiStyle netcode issue. Thanks @direwolf420 , @Mirsario
• Fix ModNet.DrawModDiagnoseNet. Thanks @direwolf420
• Hopefully fix Mac GOG install

API

• Update KillTile documentation. Thanks @RyanMakesMods

Other

• Ram in-use log message.

Using Steam? Simply update TML through Steam.
Not updating? Relaunch Steam. Please note it sometimes can take a while for the update to reach every Steam client.
GOG or Steam family share not working? Read the manual install instructions

With the recent 1.4.1 release, some Mac or GOG users might not be able to launch tModLoader anymore, this release addresses that. As always, this is not an update with the Journeys End content, that is still being worked on.

Fixes

• Fix Mac and GOG issues caused by 1.4.1 file changes.
• Prevent orphan ReLogic.dll files from previous 64 bit tModLoader installs from crashing the game.

API

• Adding recipes in the incorrect methods is now protected against and will not silently crash the game. Thanks @direwolf420

ExampleMod

• Removed "using static" directives as they cause confusion for new modders. Thanks @Chik3r

Using Steam? Simply update TML through Steam.
Not updating? Relaunch Steam. Please note it sometimes can take a while for the update to reach every Steam client.
GOG or Steam family share not working? Read the manual install instructions

We are hard at work on updating tModLoader for 1.4, please be patient. In the meantime, we've had an amazing amount of contributions fixing issues in the current tModLoader based on Terraria 1.3.5.3.

Fixes

• Added Steam cloud quota checks to prevent lost data related to quota issues. Thanks @direwolf420
• Fix modded chests not being mineable in multiplayer. Thanks all who informed us of this issue and provided suggestions. Thanks @zzp198 for reporting this.
• Fix an issue with ModWorld syncing that caused issues with joining servers. Thanks @ModernMAK
• Fixed ModConfig sync issue when ReloadRequired is true
• Fix an issue with TileEntities preventing mods from unloading completely. Thanks @Trivaxy
• Fix ModNPC.BossHeadSlot hook. Thanks @direwolf420
• Fixed autopause/potion issue
• Fixed GlobalItem.DrawHair. Thanks @direwolf420
• Various reliability and logging work. Thanks @Mirsario

API

• ModProjectile/GlobalProjectile.GrappleTargetPoint hook for customizing where grapples pull towards. Thanks @gamrguy
• Command line -publish flag
• Tweaked ModPlayer.ShiftClickSlot. Thanks @Lanboost
• Mod Sources menu can now be filtered quickly, and Build All is now removed
• More helpful messages for duplicate Mod classes in a Mod

ExampleMod

• ExampleFishingRod. Thanks @termigator1359
• More comments. Thanks @MojoDallin , @Mirsario

Other

• Updated various translations. Thanks @sgkoishi , @Igmc , @nesheroj ,
• Reduce lag when opening chests near crafting stations. Thanks @direwolf420
• Various UI fixes. Thanks @patterson-joseph , @GoodPro712

Using Steam? Simply update TML through Steam.
Not updating? Relaunch Steam. Please note it sometimes can take a while for the update to reach every Steam client.

Other:

• Updated hashes for v1.4.0.5 Terraria
• Add warning messages for attempting to load 1.4 worlds and players
• Various typos and localization updates
• UICommon textures are now public

Fixes:

• Fix modded banner tooltips
• Fix MysteryTile tooltip in multiplayer

Fixes:

• Fix an npc spawn issue.

tModLoader v0.11.7.3 Changelogs

Using Steam? Simply update TML through Steam.
Not updating? Relaunch Steam. Please note it sometimes can take a while for the update to reach every Steam client.

PSA: We're aware that family sharing is not working. Please be patient while we work on a fix.
PSA 2: Cloud saves disappear if you have too many files on steam cloud, you should try moving files off your cloud if this is happening to you.

This update supports installing to GOG without manually downgrading.

Major:

• GOG Install should work again. Make sure terraria v1.4.0.4 installed.
  You can install TML into the GOG dir if you want, make sure a v1.4.0.4 Terraria.exe is present.
  If you patched your Terraria.exe, make a copy of the original exe and name it Terraria_1.4.0.4.exe

Fixes:

• Fix a RandomUpdate issue (Surface updates)
• Fix LogArchiver.DeleteOldArchives() not working with "Old" log archive subdir
• Fix 'File already exists' in LogArchiver.MoveOldLogs()
• Fix mods failing to compile for unresolved FNA during pdb generation
• Fix includePDB in build.txt only looking for PDB files, not MDB files
• Fix MdbManager.TryResolveLocation sometimes NullReferenceExceptions, causing Exception ToString()'ing to blow up (cf. HookGetStackTrace)
• Fix shoes not drawing
• Fixed upgrading .csproj going back to top of list (Game now remembers scrollbar position)

Other:

• Refactor InstallVerifier
• Extra tips for error messages
• ExampleLaserWeapon updates
• PaintID
• Example Last Prism
• Made ExampleExplosive count towards Demolitionist Spawn/ItemID.Sets.ItemsThatCountAsBombsForDemolitionistToSpawn
• Added a menu for world gen crashes
• UIModConfig update
• Added a log message for steam cloud quota.
• Memory estimates for mods now show by default

Using Steam? Simply update TML through Steam.
Not updating? Relaunch Steam.

We're aware manual install / GoG install won't work for now, we're hoping to fix it ASAP

Steam Cloud:

• Using cloud saves should no longer make them disappear... Sorry about that.

Mod Loading:

• Use multiple cores to pre-JIT methods in Terraria.exe, this should improve loading performance for some people

Installation:

• Added checks for correct Content directory and Terraria install

Other:

• Added some error logging to mod creation
• Dynamically show the notification in the mod creation menu
• Updated some error dialogs
• Pack Newtonsoft.Json in root of embedded resources so it extracts with the correct name in references folder
• Refactor/simplify "Terraria" name redirection in AssemblyManager.CecilAssemblyResolver
• Added fallback save directory support if antivirus false positives can't be avoided. Simply make a file called savehere.txt in the install directory.

Bugs:

• Fixed some errors happening during log archiving
• Fixed an issue where the modder could get stuck in the mod development welcome UI
• Fixed Failed to resolve assembly for Terraria v1.3.5.3 etc.
• Fixed an issue with TML debugging
• Fixed an issue with building mods before updating ModCompile
• Fixed an issue with the mod generator on Linux and Mac
• Fixed Duplicate attribute errors
• Fixed folder opening on Linux

v0.11.7.1
Using Steam? Simply update TML through Steam.
Not updating? Relaunch Steam.

Fixes:

• Fixed not being able to click ' Enable developer mode '
• Fixed debugging not working
• Fixed ModPlayer.OnHitAnything() hook not being called.
• Fixed 'Arithmetic operation resulted in an overflow'
• Fixed some dye issues
• Fixed some "Please ensure Steam is running" errors. If this issue persist, make a file named steam_appid.txt file in the tModLoader with the contents: 1281930

Please note: It is very likely the steam release has some bugs, we will be releasing fix patches to address these issues.

v0.11.7 marks the release of tModLoader on Steam. As such, installation instructions have changed.

If you use steam, simply install tModLoader on Steam: https://store.steampowered.com/app/1281930/tModLoader/

If you use GOG, unzip the zip to a folder named tModLoader either nested within the Terraria install folder or placed in the same folder as the Terraria install folder. Do not merge the folders or install the files into the install folder, as that will no longer work since Terraria has updated to 1.4 and tModLoader is using 1.3.5 assets. (Note: GOG won't work unless you follow the workaround in https://github.com/tModLoader/tModLoader/issues/882)

Changelogs

Major changes:

• New patcher system. TML now uses a new patcher system that was worked on for 3 years using .net core 3.1
  -- There are many additions and changes to this patcher that are undocumented
• Roselyn based formatter and simplifier in patcher
• New internal ILSpy version
• TML changed to MIT license, as necessary for a Steam release
• TML release on Steam officially in partnership with Re-Logic!
• tModLoader.CodeAssist integrated into the mod generator

Other:

• Game checks if it has focus when holding shift to skip mods
• Improved various logging operations
• Updated localizations
• Added RecipeGroupID/int overload for RecipeFinder.AddRecipeGroup and ModRecipe.AddRecipeGroup
• Provided access to method that handles commands
• Added support for ModSigns and provide ExampleCommandSign
• Added sign validation in WorldIO
• When compiling and loading mods, check for {Dep}.XNA.dll and {Dep}.FNA.dll
• Platform specific lib packaging doesn't need to interact with -eac
• Added NPC DrawBehind hook
• Added hovering information for Mystery tiles
• Added a retry button if mod compilation failed
• Added a player team enum in Terraria.Enums
• Improved the Player.VanillaUpdateEquip/Accessory patches
• Disbled Steam Achievement module for Steam release
• Improved mod browser buttons
• Updated MonoMod
• Added code to find vanilla steam install dir on MacOS
• Custom TML Content Manager so TML can be installed alongside Vanila
• Added a skip mod loading button during loading screen

Mod browser:

• Improved downloading cancellation handling

Mods:

• Upgraded csproj format with new target files

Bugs:

• Fixed streaming music on FNA in main menu
• Fixed empty items de-serializing as unloaded items when using TagSerializable
• Prevented bad pitch and volume values from throwing errors.
• Fixed double wildcard logic for embedded resources in decompile task
• Fixed and issue causing freezing and lag when enabling or disabling many mods
• Fixed GOG checks not working correctly when tML is not Terraria.exe
• Fixed 'Missing dll reference: .dll.dll' errors on build
• Fixed .targets file failing with ampersand characters
• Fixed SynchronizationLockException during Preferences.Save
• Fixed UnauthorizedAccessExceptions in the setup tool by replacing directory deletion with wiping.
• Fixed DirectoryNotFoundException in setup's DeleteEmptyDirs
• Fixed whoami/active inconsistency with entities on unload
• Fixed Mod Generator setting LangVersion to latest, causing issues for c# 8 features
• Fixed ModPackets during mod syncing causing errors

ExampleMod:

• Added ExampleResourceBar and ExampleResource
• Removed bad example in Face.cs
• Fixed Example Traveling Merchant shop not clearing
• Added ExampleSand
• Added ExampleCactus
• Added ExamplePalmTree
• Improved some documentation in ExampleStatue.cs
• Fixed some issues with ExampleAdvancedRecipe.cs
• Added ExampleDashAccessory and ExampleDashPlayer
• Added ExampleFlail
• Updated ExampleSword documentation
• Fixed killing Walls not killing ExampleTorch, ScoreBoard and BossTrophy
• Fixed ScoreBoard NewRightClick logic
• Updated ExampleAnimatedPierce documentation
• Improved ExampleSapling
• Fixed some typos across the board
• Fixed ExampleCritter ILHook
• Updated ExampleHerb

See v0.11.6.1 release below for many other changes you might have missed

Fixes
Fix imgur/mod icon related issues
Fix issue with high speed yoyos. Thanks @Ozzatron
Fix issue with multiple texture packs
Fix issue with hidden files in the texture packs folder
Fix rare issue with auto migration of Players and Worlds

API
Internal loops in .ogg files now supported. Thanks @jjohnsnaill
PDB files are available as a separate download for troubleshooting scenarios. If you are seeing exceptions in tModLoader code, placing the pdb file in the install directory and renaming it to the .exe filename should make the exception stack traces have line numbers for tModLoader methods.

Patreon Thanks
Thanks so much to our Golem level Patrons.
Added POCKETS patreon set

How to Install or Update
Download only the zip that corresponds to your operating system. Unzip the downloaded zip file and then run the installer from the unzipped folder. Now launch Terraria as you normally do. Read the README.txt if the installer doesn't work.