tModLoader News

Hello Terrarians!

As the tModLoader community reaches closer to offering tModLoader 1.4.4 as the default, we'd like to take this chance to outline how this is all going to work.

tModLoader 1.4.4 is a big update with major code changes incompatible with existing 1.4 mods. It marks the start of a new generation of mods, just as the change from 1.3 to 1.4 did before.

For those that remember the change from 1.3 to 1.4 - it was quite a big event.
There were lots of moving parts and we've all learned a lot from the process.

We've kept 1.3 alive and running in the Steam Betas, and will be doing the exact same with 1.4.3.
More info on Steam Betas here on our GitHub

With Modders making fast progress on porting to 1.4.4, it's even more important that we talk about this early. So how's this going to work?

There will be three phases of the transition: Establishing 1.4.3-Legacy Support, Transition Period, and Transition Day


We've established a new home for 1.4.3 modding - the Steam Beta "1.4.3-legacy" branch!
This branch will keep all 1.4.3 mods currently accessible, and will be a permanent mainstay.

Likewise, we have also added new version tags to our Workshop. You can now filter by "tModLoader version" = 1.4.4 or 1.4.3 to see which mods are available.
Mod Browser version filtering is on our roadmap as well.


Modders can continue to publish updates for 1.4.3 users by using the 1.4.3-Legacy Steam beta. This is a great time to think about stabilizing that existing release and moving to 1.4.4 permanently with tModPorter's help.

Please note we will also automatically move some save files around with an upcoming July 7 update - if you encounter any issues, please let us know immediately at our Discord

Finally, we still have a few compatibility items to sort out. Items like our Server Management scripts will need some attention to support both 1.4.3 and 1.4.4 in parallel.

Please keep an eye on our Discord for the latest progress!

Rest assured that any mods published on 1.4.3-legacy will continue to be available to 1.4.3-legacy users and are unaffected by modders publishing updates on the 1.4.4 version of tModLoader.


Around the second week of July, we will start migrating users over to the 1.4.3-legacy beta branch through an in-game prompt.

During this period, we recommend players who wish to remain playing on 1.4.3 to switch to the 1.4.3-legacy Beta Option. This will guarantee that you will be unaffected on Transition Day.

All your save files from 1.4.3 will be automatically and safely migrated over to a new folder during this transition period: tModLoader-1.4.3. This will ensure you always can come back to play on 1.4.3 at your leisure.

The Transition Period will last for at least the remainder of July. This period provides modders with a last chance to publish their mods on 1.4.4-preview ahead of 1.4.4 being the default offering.
As a reminder, tModLoader automatically takes care of making your mod available on stable whenever preview rolls over in to a new stable. So modders will NOT need to post any updates on Transition Day


We are planning to make 1.4.4 the default on August 1st, 2023, at Midnight UTC.

On July 25th, we will confirm deployment will proceed.
On July 31st, 10 pm UTC, we will begin deployment

1. At Midnight, we will make the 1.4.4 build and upload it to Steam
   
2. At 1 am UTC on August 1st, we will validate that the Steam update was pushed
   
3. We will then delete the 1.4.4-preview Steam Beta Option and kick all players back to Default
   

Mods currently on 1.4.4-preview will automatically be available on default 1.4.4 without any action by modders or player. This should be a relatively seamless transition.

Modding communities should update their instructions to tell users that 1.4.4 is now default, and that 1.4.4-preview should be avoided for most players.

In the future, a new 'preview' beta will be used to give modders time to prepare for ongoing monthly updates to tModLoader and it will not be intended for regular players.
Please keep an eye out for a separate announcement on that return to normal Dev Cycle and how it will work in it's second iteration.


Wowsers that is a lot of words and a lot to take in.

At the end of the day, here's the key takeaways:

• Players - We recommend using 1.4.3-legacy branch to keep playing 1.4.3 and be unaffected by all this. Otherwise, 1.4.4 is coming soon ːcoolstar2022ː
  
• Modders - Keep porting to 1.4.4-preview. You are doing great work! ːsteamhappyː
  

The New Year is upon us, as well as fresh Stable TML Bug Fix Series bringing polishing and a wagon of stability improvements.
Happy New Year Terrarians!



Before we begin, we hope everyone has been having fun playing the new Terraria v1.4.4 update (Labor of Love). We know everyone is looking forward to mods having access to all of the new features.
We'd like to remind tModLoader users that updating tModLoader to the v1.4.4 codebase will take some time, so please be patient.

We are committed to getting tModLoader updated to v1.4.4 sometime soon and we can see the end coming, but we can not guarantee when that will be yet.
Much of the Terraria code has changed and we still need a bit more time test tModLoader and then give mod makers time to adapt their mods to those changes.
If you are a mod maker and are interested in the migration to 1.4.4, please participate in our Discord development channels and on GitHub.

Thank you for your patience!


For this update, we are keeping it focused to bug fixes.
Although we have new features and changes in the works, they all are primarily happening with 1.4.4. Please stay tuned for news on 1.4.4!

Freedbot: Made server manage script curl/wget agnostic (#3081) ilcheese2: Fix content folder path on Mac with GoG version (#3173) SecondFry: Fix workshop files location for Docker deploy (#3047) Cyrilla: Fix temporary items not saving modded data (#3054) Lama3L9R: Fix engine crash when failed to fetch local mod dependencies (#3023) Antirhinnum: Fix Corsair RGB (#3096) Dradonhunter11: Fixed: Patreon Items and Developer Items can now be researched (#3075) AbsoluteAquarian: Fix AssemblyManager.ForceJITOnMethod() Throwing on Interface Methods (#3175) Jadams505: More checks to stop chat (#3065) Jadams505: Fixed vines disappearing when teleporting (#3059) JavidPack: Simple approach to Fix #2959 (#3051) JavidPack: Fix typo rendering French mod browser unusable JavidPack: Fix #3010 by ensuring ContentSamples.ItemsByType have tooltips JavidPack: Fix #3018, Buff tooltips can now have chat tags. Solxanich: Trailing cleanup of start server.sh. Fixes #3137 Solxanich: Fixes #3032 - GoG mod deletion (#3171) Solxanich: Workshop Improvements Pack 3 (#3157) Solxanich: Fix Terraria OW Mod Audio (#3161) Solxanich: Vastly Speed Up Publishing Menu


[h3]My game doesn't launch, and I'm on Windows![/h3]

• If you're on Windows 7 or 8.X, or an older Windows OS, installing .NET pre-requisites listed in Microsoft's website might very much help. Especially the KB3063858 update.
  
• If the above doesn't apply or didn't help, try deleting the dotnet folder in the install directory, and try running TML again. There seems to be a bug with extracting needed libraries on some Windows devices, where it may take two attempts. We are actively investigating improvements to remedy this.

[h3]How do I switch to the 1.4-preview or 1.3-legacy branches of TML?[/h3]
To switch to anoter branch in steam, just do the following: 1. Right click on tModLoader in Steam and select 'Properties...', then 'BETAS';
2. Select the branch you want in the drop-down menu on top;
3. Close the window. You don't need to enter any passwords.
Please note: 1.4-preview versions of TML are intended to only be used by mod developers and testers who know what they're doing. Some popular mods' authors do not intend for their mods to always work with it.

[h3]When 1.4.4 tModLoader???[/h3]
See the first section of this announcement.

[h3]I have a 32-bit OS, will it be supported?[/h3]
Work is finishing up on improving our handling of native libraries, so we can add 32-bit Windows support. If everything goes well in testing, this will be pushed to the stable branch as soon as it is ready, with an announcement in our Discord.


Special thanks to everyone who has supported us on Patreon in the last three months since our last big monthly update!
We know there are a lot of you, and are ever grateful for supporting this community-run modloader!

See you in February Terrarians!

Thank you for your patience.

This follow-up update includes fixes for the following two items:
1) A severe performance drop on some 4k monitors due to an edge case issue with resolution settings
2) An incompatibility with the unofficial 1.3 64 bit version - as a reminder, we recommend against modifying the original tmodloader install with external files as it can lead to unexpected behaviour.

As always, please continue to reach out via our Discord with any issues you encounter: https://discord.gg/3snus3cW6c

Happy October All!

While we are working on 1.4.4 porting, we know there is still a fair few bugs to cleanup on the current stable version.

We've pushed the following changes to cover off some of the problematic ones:

• Mirsario - Fixed date parsing crashes in world backup cleanups.
  
• Mirsario - Add additional logging regarding issues with .NET versions
  
• Solxanich - Fix remaining Biome detection issues along vertical axis
  
• Solxanich - Fix inability to publish a new version of a mod on to Stable, when one is already published
  
• Solxanich - Improve handling of 4k resolution on Mac
  
• JavidPack - Improve logging of Resource Packs in the event of conflicts
  
• JavidPack - Fix ModPack Menu crashing while it is being opened
  
• JavidPack - Fix Bestiary only showing half of the available mods in some instances
  
• JavidPack - Improve error information for Folder Access conflicts
  

Thank you for your patience on these bugs and reporting them!

As always, for all issues needing support, we recommend reaching out through our Discord:
https://discord.gg/3snus3cW6c

As a reminder, 1.4.4 code changes will take a fair bit of time. A lot has changed in the code, and updating this open-source, community-run mod loader will take some time to match. We will share more news on progress in the future.

We've recently deployed new version 2022.09.47.4 fixing biomes showing up at larger distances than intended during the push of Hotfix 2022.09.47.2.
Thank you for your patience while we isolated and resolved the bug.

For additional issues, and the latest updates on any hotfixes coming after the big monthly updates, we recommend tuning in on our Discord