tModLoader

Hello everyone! It is time for the July 2026 Stable Update and other news.

This month's announcement contains 1.4.5 update progress, a quick showcase of new mods from the past month, and the changelog for the new stable release.

Future Terraria 1.4.5 Support

As mentioned previously, the process of updating tModLoader to all of the new content and features of the Terraria 1.4.5 update (Bigger and Boulder) will take some time. This process as well as any other big changes desired by the modding community for this update will take many months still.

Terraria 1.4.5 Support Progress

We are continuing to see a huge amount of community participation and contributions for the 1.4.5 update and are extremely grateful for those willing to help with this process through code contributions, bug reporting, testing, and participation in the discussions that take place on Discord. The tModLoader team will continue to work with experienced modders to progress towards the tModLoader 1.4.5 update.

There are still many tasks to be done, if you are interested in contributing code for the 1.4.5 update, the 1.4.5 Update Information page has information on how to contribute and what tasks remain to be done. That page also explains how to join the "1.4.5-dev" beta branch. Users can join that beta branch to help identify and report remaining bugs.

We'd like to encourage modders to take this opportunity to come discuss any tModLoader API shortcomings with the tModLoader team and contributors on Discord, even if they are not able to personally contribute the changes. Major releases present an opportunity to fix issues that couldn't be addressed properly in regular monthly releases.

As usual, community contributions are discussed mainly on Discord initially and then on GitHub to be implemented.

Terraria 1.4.5 Support FAQ

Q: "Will all of my mods still work on v1.4.5 immediately?"
A: Due to how much has changed in the Terraria v1.4.5 update, the short answer to this is "no". Modders will, however, have ample opportunity to update their mods to v1.4.5 before it is officially released, so as long as the mods you are using are still maintained by the modder, they should be available on v1.4.5 once it has a stable release for players.

Q: "What will happen to 1.4.4?"
A: 1.4.4 mods and the 1.4.4 version of tModLoader will continue to exist and be available for players both during porting and after. It will be supported as a Legacy version like 1.3 and 1.4.3.

Q: "When will 1.4.4 stop receiving updates?"
A: 1.4.4 will continue to receive maintenance updates to ensure it stays functional. We do not have a date for when content updates will stop; in the near-term 1.4.4 will continue to receive regular updates until we are ready to 'Preview' the 1.4.5 beta build to modders.

Q: "Will 1.4.5 be backwards compatible with my worlds and players from 1.4.4?"
A: From tModLoader's side, one of our guiding principles is to ensure the player experience is as seamless as possible. We aim to maintain backwards compatibility in tModLoader and encourage modders to keep this in mind when it comes time.

Terraria 1.4.5 Update Changelog

Here is a listing of changes made on the 1.4.5 update beta branch this past month. As a reminder, changes to the beta branch go live immediately as they are implemented to facilitate rapid progress.

Major Changes

New Features

JavidPack: New ModifyEquipTextureDraw and ModifyItemDraw hooks
JavidPack: Menu for switching between beta branches in-game
Rijam: Add support for biome and NPC specific happiness dialogue
Rijam: Update for new Whip changes

API Changes

noahDP1911: Update for new TileEntity changes
Rijam: Update for new Use and Hold Styles
Destructor_Ben: Refactor mod icon code and make icons easily retrievable
Rijam: Automatically Register NoHome localization for Town Pets
Ben Wendell: Add tModPorter migration for Player.GetItem changes
Rijam: Update to use new ItemID.Sets.IsQuestFish and other fishing fixes
Chicken-Bones: Update SDL to 3.4.11 and FAudio/FNA3D to 26.6.0

Bug Fixes

Quality of Life and Other Fixes

JavidPack: Fix skyblock and dual dungeons seed worlds not generating
Lion8cake: Fix Hardmode world generation logic
KingXerxes512: Fix various boss bag drops and biome crate drops that changed
JavidPack: Fix more boss bag drops and biome crate drops that changed
Evana Alawi: Prevent startup crash when Steam Workshop is offline
Nan_Ting: Fix issue with disabling dependencies not working correctly for client side mods
JavidPack: Fix crash in some situations when going from MP to SP
Evana Alawi: Fix docs regarding ARM64 Linux support status

API Fixes and Changes

Tyfyter: Fix CloneDefaults applying difficulty scaling multiple times
JavidPack: More tModPorter migrations and docs for Main.hasFocus, Main.DrawWindowsIMEPanel
direwolf420: Fix erroneous tooltips preventing the journey item dupe search from working entirely
Mirsario: Fix issue with building tModLoader solution for the first time
Mirsario: Update tModLoader project files for VSCode development

Other

ExampleMod and API Documentation

JavidPack: Fix exception with modded Item.makeNPC values and update ExampleCritter to support leashing
Ben Wendell: Update wiki with new achievement internal names
Rijam: Update IsTileDangerous docs for scrying orb changes

Localization

None

New Mods Showcase

Here is a collage of new mods released this past month. There were over 300 new mods this month! Have you tried any of these mods yet? Find any hidden gems? Be sure to regularly check the workshop for newly released mods, we're positive you'll always find something fun and interesting to try out. Click here to see the most popular new mods from this month.

Stable Release

We will continue to update the 1.4.4 version of tModLoader with bug fixes as we work on updating tModLoader to the Terraria v1.4.5 update (Bigger and Boulder). We are grateful for the massive amount of community participation in developing and testing new features each month.

If you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub or reach out to us at our Discord.

Stable Release Changelog

The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide to see how to adapt to the new changes.

Major Changes

New Features

hezuo1hao: Add support for modded crowd control effects

API Changes

None

Bug Fixes

Quality of Life and Other Fixes

None

API Fixes and Changes

JavidPack: Fix another issue with too many tooltip lines

Other

ExampleMod and API Documentation

JavidPack: Fix MinionBossBody visuals by fixing misaligned sprites and errant pixels in MinionBossBody.png
JavidPack: Fix ExampleMod using invalid RecipeGroup

Localization

ayuyoiM: Chinese
RazzSG: Russian

We would also like to mention that we have volunteers translating our monthly release announcements into several other languages. If you would like to help translate these announcements into a supported language, please reach out on Discord.

Hello everyone! It is time for the June 2026 Stable Update, as well as some other news.

This month's announcement contains news about 1.4.5 update progress, a quick showcase of new mods from the past month, and the changelog for the new stable release.

Future Terraria 1.4.5 Support

As mentioned previously, the process of updating tModLoader to all of the new content and features of the Terraria 1.4.5 update (Bigger and Boulder) will take some time. This process as well as any other big changes desired by the modding community for this update will take many months still.

Terraria 1.4.5 Support Progress

Progress on the update this month has been very productive. We've seen many community contributions this month from experienced modders. We are extremely grateful for those willing to help with this process. The tModLoader team will continue to work with experienced modders to progress towards the tModLoader 1.4.5 update.

There are still many tasks to be done, if you are interested in contributing code for the 1.4.5 update, the 1.4.5 Update Information page has information on how to contribute and what tasks remain to be done. That page also explains how to join the "1.4.5-dev" beta branch. Users can join that beta branch to help identify and report remaining bugs, but please don't expect that version of the game to be stable.

We'd like to encourage modders to take this opportunity to come discuss any tModLoader API shortcomings with the tModLoader team and contributors on Discord, even if they are not able to personally contribute the changes. Major releases present an opportunity to fix issues that couldn't be addressed properly in regular monthly releases.

As usual, community contributions are discussed mainly on Discord initially and then on GitHub to be implemented.

Terraria 1.4.5 Update Changelog

Here is a listing of progress made on the 1.4.5 update since we've started the beta branch, ordered alphabetically by contributor name:

AjuliDev: Updated documentation for StartRain and StopRain
Antonino Grasso: Resolve WorldGenerator._seed PortingNotes TODO
Caio Peluti: Expand BossLoot hook to include heart and potion drop amount
direwolf420: Move blockLoot.Clear to latest possible place
Jacob Adams: Fix item flasks
Jacob Adams: Fix mannequins
Jacob Adams: Added 1.4.5 MapLayers
Jerry An: Fix CanBeTeleportedTo hook for potion/conch teleports
Jerry An: Merge ItemLoader.CanStack into Item.CanStack, fix stack-related bugs
Jerry An: Restore OnStack hooks
Jerry An: Restore CanStack, CanStackInWorld, and OnStack hooks for WorldItem stacking
Jerry An: Restore ItemLoader.Update and PostUpdate hooks for WorldItem
lost-werewolf: Extra array resizes
lost-werewolf: Publicize SceneState.ManageSpecialBiomeVisuals
lost-werewolf: Fix null sound paths for new LegacySoundStyles
lost-werewolf: Fix ModBiome
Nicolas Bissig: Check for `= new Tile();` not gated by null checks
noahDP1911: Remove pylon danger teleport hooks
noahDP1911: Complete NPCSpawnInfo migration to NPC.Spawner
noahDP1911: Debuff Length Migration
noahDP1911: Fix slime body ore drop stack size
noahDP1911: Implemented tModPorter Journeymode-check changes
Rijam: Updated GlobalNPC.BuffTownNPC
Rijam: Boulder Logo ModMenu
Rijam: Town NPC Chat Buttons
Rijam: Move mod warning icon left on world select
Rijam: Updated Example Jousting Lance
Rijam: Fix exception with too many tooltip lines
Rijam: Restore petting settings
Rijam: Town NPC Portraits
Rijam: Fix Modded Town NPCs not showing up in the housing UI
Rijam: New Conditions and Update Town NPC Shops
Rijam: Fix Modded Town NPCs' NoHome Dialogue
Rijam: tModPorter Additions
Rijam: Fixed Menu Link Icons
Rijam: Some ID Updates
tomat: Update hair count
tomat: Update liquid edge rendering and make it work again
tomat: Correct typo in max screen size calculation
tomat: Implement FileWatcherPath/Refresh for ContentSources
tomat: Fix AssetRepository compilation errors and fix hot reloading
tomat: Use sdl3 to update window icon
tomat: Clear out unused TileBatch patches
tomat: Remove redundant window implementations, make windows use native console APIs
tomat: Update Terraria and TerrariaNetCore Patches to 1.4.5
tomat: Bump `Terraria`/`TerrariaNetCore` Patches to 1.4.5.5
tomat: Clean Up `Terraria`/`TerrariaNetCore` Patches
tomat: Bump Terraria/TerrariaNetCore to 1.4.5.6
Tyfyter: Modded tile conversion completely updated

In addition to these code contributions from modders, the tModLoader team has also been working on 1.4.5 code changes. These have been summarized this time for brevity.

Chicken-Bones: Work on patcher and setup tools, modernizing dependencies, and resolving porting TODOs
JavidPack: Work on porting code patches, implementing tModPorter migrations, managing porting efforts, and resolving porting TODOs
Mirsario: Work on support for NixOS
Solxan: Work on new workshop capabilities and related fixes

Terraria 1.4.5 Support FAQ

Q: "Will all of my mods still work on v1.4.5 immediately?"
A: Due to how much has changed in the Terraria v1.4.5 update, the short answer to this is "no". Modders will, however, have ample opportunity to update their mods to v1.4.5 before it is officially released, so as long as the mods you are using are still maintained by the modder, they should be available on v1.4.5 once it has a stable release for players.

Q: "What will happen to 1.4.4?"
A: 1.4.4 mods and the 1.4.4 version of tModLoader will continue to exist and be available for players both during porting and after. It will be supported as a Legacy version like 1.3 and 1.4.3.

Q: "When will 1.4.4 stop receiving updates?"
A: 1.4.4 will continue to receive maintenance updates to ensure it stays functional. We do not have a date for when content updates will stop; in the near-term 1.4.4 will continue to receive regular updates until we are ready to 'Preview' the 1.4.5 beta build to modders.

Q: "Will 1.4.5 be backwards compatible with my worlds and players from 1.4.4?"
A: From tModLoader's side, one of our guiding principles is to ensure the player experience is as seamless as possible. We aim to maintain backwards compatibility in tModLoader and encourage modders to keep this in mind when it comes time.

New Mods Showcase

Here is a collage of new mods released this past month. There were over 300 new mods this month! Have you tried any of these mods yet? Find any hidden gems? Be sure to regularly check the workshop for newly released mods, we're positive you'll always find something fun and interesting to try out. Click here to see the most popular new mods from this month.

Stable Release

We will continue to update the 1.4.4 version of tModLoader with bug fixes as we work on updating tModLoader to the Terraria v1.4.5 update (Bigger and Boulder). We are grateful for the massive amount of community participation in developing and testing new features each month.

If you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub or reach out to us at our Discord.

Stable Release Changelog

The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide to see how to adapt to the new changes.

Major Changes

New Features

None

API Changes

Mark: Add NPC.StrikeOtherNPC helper method

Bug Fixes

Quality of Life and Other Fixes

Solxan: Prevent startup crash for when Workshop is offline but Steam is online
Solxan: Fix recent issue with GOG users experiencing launch crashes
错数螺线: Fixed Host and Play console encoding to fix garbled Chinese characters
JavidPack: Fixed launch issue for users with very high resolution displays
Mark: Fix Linux multi-client logging by enforcing FileShare.None
JavidPack: Localize text for copying over worlds and players

API Fixes and Changes

Tyfyter: Fix issue with NoSync library syncing
Mark: Add Debian Steam Installation path to Linux auto-detection for developer tools
Mellohi: Fix Glowing Mushroom conversion interactions

Other

ExampleMod and API Documentation

JavidPack: ExampleGemsparkBlock, showcasing Framing.SelfFrame8Way and more
JavidPack: Fix ExampleJavelinProjectile drawing in the incorrect draw order
A5TR0spud: Update ExampleFoodItem and related documentation
hezuo1hao: Fixed commented out example in ExemplarAdvancedFailProjectile
hezuo1hao: Fix url typo
JavidPack: Documentation

Localization

ayuyoiM: Chinese
Alino4kaHvoshch: Russian
RazzSG: Russian
NicolasPL: Spanish

We would also like to mention that we have volunteers translating our monthly release announcements into several other languages. If you would like to help translate these announcements into a supported language, please reach out on Discord.

Hello everyone! It is time for the May 2026 Stable Update, as well as some other news.

This month's announcement contains news about 1.4.5 update progress, a quick showcase of new mods from the past month, and the changelog for the new stable release.

Future Terraria 1.4.5 Support

As mentioned previously, the process of updating tModLoader to all of the new content and features of the Terraria 1.4.5 update (Bigger and Boulder) will take some time. This process as well as any other big changes desired by the modding community for this update will take many months still.

Terraria 1.4.5 Support Progress

Last month we announced that the initial process of moving thousands of code changes over to the new Terraria source code was mostly complete and that we were ready for experienced contributors to help us go the rest of the way in restoring remaining functionality.

Since then we've had many community code contributions from experienced modders who have answered the call. Work has been done to support new vanilla town NPC systems as well as many other changes to the structure of the source code. Many regression fixes and bug fixes have also been made. We are extremely grateful for those willing to help with this process. The tModLoader team will continue to work with experienced modders to progress towards the tModLoader 1.4.5 update.

There are still many tasks to be done, if you are interested in contributing code for the 1.4.5 update, the 1.4.5 Update Information page has information on how to contribute and what tasks remain to be done. That page also explains how to join the "1.4.5-dev" beta branch. Users can join that beta branch to help identify and report remaining bugs, but please don't expect that version of the game to be stable.

We'd like to encourage modders to take this opportunity to come discuss any tModLoader API shortcomings with the tModLoader team and contributors on Discord, even if they are not able to personally contribute the changes. Major releases present an opportunity to fix issues that couldn't be addressed properly in regular monthly releases.

As usual, community contributions are discussed mainly on Discord initially and then on GitHub to be implemented.

Terraria 1.4.5 Support FAQ

Q: "Will all of my mods still work on v1.4.5 immediately?"
A: Due to how much has changed in the Terraria v1.4.5 update, the short answer to this is "no". Modders will, however, have ample opportunity to update their mods to v1.4.5 before it is officially released, so as long as the mods you are using are still maintained by the modder, they should be available on v1.4.5 once it has a stable release for players.

Q: "What will happen to 1.4.4?"
A: 1.4.4 mods and the 1.4.4 version of tModLoader will continue to exist and be available for players both during porting and after. It will be supported as a Legacy version like 1.3 and 1.4.3.

Q: "When will 1.4.4 stop receiving updates?"
A: 1.4.4 will continue to receive maintenance updates to ensure it stays functional. We do not have a date for when content updates will stop; in the near-term 1.4.4 will continue to receive regular updates until we are ready to 'Preview' the 1.4.5 beta build to modders.

Q: "Will 1.4.5 be backwards compatible with my worlds and players from 1.4.4?"
A: From tModLoader's side, one of our guiding principles is to ensure the player experience is as seamless as possible. We aim to maintain backwards compatibility in tModLoader and encourage modders to keep this in mind when it comes time.

New Mods Showcase

Here is a collage of new mods released this past month. There were over 350 new mods this month! Have you tried any of these mods yet? Find any hidden gems? Be sure to regularly check the workshop for newly released mods, we're positive you'll always find something fun and interesting to try out. Click here to see the most popular new mods from this month.

Stable Release

We will continue to update the 1.4.4 version of tModLoader with bug fixes as we work on updating tModLoader to the Terraria v1.4.5 update (Bigger and Boulder). We are grateful for the massive amount of community participation in developing and testing new features each month.

If you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub or reach out to us at our Discord.

Changelog

The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide to see how to adapt to the new changes.

Major Changes

New Features

Solxan: Detect and handle situations where subscribed mods are unlisted or banned so users can continue playing with the same mods: 1, 2, 3
turtletowerz: Update and improve the dedicated server management script and docker container

API Changes

None

Bug Fixes

Quality of Life and Other Fixes

Mirsario: Remove misleading version mismatch message from error messages so users can more clearly understand error messages
JavidPack: Fix issue causing player to detach from ropes when using some broadsword weapons

API Fixes and Changes

JavidPack: Fix XML documentation not being extracted from mods when expected
JavidPack: Direct new modders to the localization wiki to teach how localization works
JavidPack: Log selected language to help diagnose some issues
Cloudea: Fix tModCodeAssist code inconsistency

Other

ExampleMod and API Documentation

JavidPack: Various Documentation Updates: 1
AlienBlox: Remove duplicate code from ExampleDoorOpen

Localization

ayuyoiM: Chinese

We would also like to mention that we have volunteers translating our monthly release announcements into several other languages. If you would like to help translate these announcements into a supported language, please reach out on Discord.

Hello everyone! It is time for the April 2026 Stable Update, as well as some other news.

This month's announcement contains news about 1.4.5 update progress, information about the new tModLoader-specific Workshop rules, a quick showcase of new mods from the past month, and the changelog for the new stable release.

Future Terraria 1.4.5 Support

We know everyone is looking forward to tModLoader and mods having access to all of the new content and features of the Terraria 1.4.5 update (Bigger and Boulder). We'd like to remind users that updating tModLoader to major Terraria releases is a huge undertaking. We are committed to working diligently on migrating to v1.4.5, but it does take some time, so we ask players to please be patient.

For context, the process of updating tModLoader to v1.4.4 took 9 months. During that process, many large features were added to tModLoader to better support the capabilities of mods, which did extend the porting process quite a bit. We don't expect quite as many large changes this time, so the actual porting process should be shorter than how it was for v1.4.4.

This process as well as any other big changes desired by the modding community for this update will take many months still. We ask that players and modders remain patient as we work on the update. tModLoader will continue to work as expected during this process, but please note that Terraria players and worlds played on the 1.4.5 update can not be migrated to and used on current tModLoader.

Terraria 1.4.5 Support Progress

The tModLoader team spent this last month moving thousands of code changes over to the new Terraria source code. This initial porting process has mostly been completed and we can now compile and launch the development build of tModLoader once again. We are especially thankful to tomat for contributing a large amount of code to this process as well.

Now that this initial process is mostly complete, the code is in a state where we are ready for experienced contributors to help us go the rest of the way in restoring any remaining functionality. We'll need to verify that everything behaves as it did before, implement changes from the new Terraria update into our existing edits, and update the API in places where improvements need to be made.

We also encourage modders to take this opportunity to come discuss any tModLoader API shortcomings with the tModLoader team and contributors on Discord, even if they are not able to personally contribute the changes. Major releases present an opportunity to fix issues that couldn't be addressed properly in regular monthly releases.

As usual, community contributions are discussed mainly on Discord initially and then on GitHub to be implemented.

Terraria 1.4.5 Support FAQ

Q: "Will all of my mods still work on v1.4.5 immediately?"
A: Due to how much has changed in the Terraria v1.4.5 update, the short answer to this is "no". Modders will, however, have ample opportunity to update their mods to v1.4.5 before it is officially released, so as long as the mods you are using are still maintained by the modder, they should be available on v1.4.5 once it has a stable release for players.

Q: "What will happen to 1.4.4?"
A: 1.4.4 mods and the 1.4.4 version of tModLoader will continue to exist and be available for players both during porting and after. It will be supported as a Legacy version like 1.3 and 1.4.3.

Q: "When will 1.4.4 stop receiving updates?"
A: 1.4.4 will continue to receive maintenance updates to ensure it stays functional. We do not have a date for when content updates will stop; in the near-term 1.4.4 will continue to receive regular updates until we are ready to 'Preview' the 1.4.5 beta build to modders.

Q: "Will 1.4.5 be backwards compatible with my worlds and players from 1.4.4?"
A: From tModLoader's side, one of our guiding principles is to ensure the player experience is as seamless as possible. We aim to maintain backwards compatibility in tModLoader and encourage modders to keep this in mind when it comes time.

New tModLoader-specific Workshop Rules

In our continued efforts to provide a safe environment for all players, we recently introduced a workshop rules agreement. Modders publishing to the Steam Workshop will be required to accept these rules the next time they publish an update or new mod. We encourage modders to review the rules and keep them in mind as they create mods.

As a reminder, there is now a moderation queue for mods to allow our moderation team to review the code of each mod. If your mod has not been approved in over a day feel free to reach out on Discord and we will look it over again.

We hope these new rules as well as our continued moderation will help keep players safe.

New Mods Showcase

Here is a collage of new mods released this past month. There were over 450 new mods this month! Have you tried any of these mods yet? Find any hidden gems? Be sure to regularly check the workshop for newly released mods, we're positive you'll always find something fun and interesting to try out. Click here to see the most popular new mods from this month.

Stable Release

We will continue to update the 1.4.4 version of tModLoader with bug fixes as we work on updating tModLoader to the Terraria v1.4.5 update (Bigger and Boulder). We are grateful for the massive amount of community participation in developing and testing new features each month.

If you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub or reach out to us at our Discord.

Changelog

The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide to see how to adapt to the new changes.

Major Changes

New Features

None

API Changes

Chicken-Bones: New interfaces to allow more customizable and lower boilerplate autoloading options
Solxan: Prompt modders to accept the tModLoader rules during publishing if not yet accepted

Bug Fixes

Quality of Life and Other Fixes

sxysxy: Disable high dpi by default on OSX for performance. Use /enablehighdpi:1 to turn on.
Mirsario: Fix for unobtainable items breaking character loading
JavidPack: Update hashes to allow GOG users to launch with 1.4.5.6 installed

API Fixes and Changes

Tyfyter: Fix stack overflow issue with ReinitializeDuringResizeArrays usage
sxysxy: Auto-detect folders on MacOS to improve developer experience

Other

ExampleMod and API Documentation

AlienBlox: Fix duplicate code in ExamplePerson

Localization

None

We would also like to mention that we have volunteers translating our monthly release announcements into several other languages. If you would like to help translate these announcements into a supported language, please reach out on Discord.

Hello everyone! It is time for the March 2026 Stable Update, as well as some other news.

In regards to updating tModLoader to the Terraria 1.4.5 update: The Future Terraria 1.4.5 Support and Improving Security sections below are a repeat of last month. The tModLoader team is hard at work moving thousands of code changes over to the new Terraria source code. Once this initial process is completed, we will be ready to accept community contributions to further adjust the tModLoader API to changes made in 1.4.5 and any other big changes desired by the modding community.

Future Terraria 1.4.5 Support

We hope everyone has been having fun playing the new Terraria v1.4.5 update (Bigger and Boulder). If you didn't know, Terraria recently launched a huge update, be sure to check it out.

We know everyone is looking forward to tModLoader and mods having access to all of the new content and features as well. We'd like to remind users that updating tModLoader to major Terraria releases is a huge undertaking. We are committed to working diligently on migrating to v1.4.5, but it does take some time, so we ask players to please be patient.

For context, the process of updating tModLoader to v1.4.4 took 9 months. During that process, many large features were added to tModLoader to better support the capabilities of mods, which did extend the porting process quite a bit. We don't expect quite as many large changes this time, so the actual porting process should be shorter than how it was for v1.4.4.

We will have more information to share in later months as we start working on the update and have a better idea of the work involved.

We encourage modders to take this opportunity to come discuss any tModLoader API shortcomings as well on Discord and Github. Major releases present an opportunity to fix issues that couldn't be addressed properly in regular monthly releases.

Terraria 1.4.5 Support FAQ

Q: "Will all of my mods still work on v1.4.5 immediately?"
A: Due to how much has changed in the Terraria v1.4.5 update, the short answer to this is "no". Modders will, however, have ample opportunity to update their mods to v1.4.5 before it is officially released, so as long as the mods you are using are still maintained by the modder, they should be available on v1.4.5 once it has a stable release for players.

Q: "What will happen to 1.4.4?"
A: 1.4.4 mods and the 1.4.4 version of tModLoader will continue to exist and be available for players both during porting and after. It will be supported as a Legacy version like 1.3 and 1.4.3.

Q: "When will 1.4.4 stop receiving updates?"
A: 1.4.4 will continue to receive maintenance updates to ensure it stays functional. We do not have a date for when content updates will stop; in the near-term 1.4.4 will continue to receive regular updates until we are ready to 'Preview' the 1.4.5 beta build to modders.

Q: "Will 1.4.5 be backwards compatible with my worlds and players from 1.4.4?"
A: From tModLoader's side, one of our guiding principles is to ensure the player experience is as seamless as possible. We aim to maintain backwards compatibility in tModLoader and encourage modders to keep this in mind when it comes time.

Improving Security

We also want discuss our recent efforts in combating malware distribution on the workshop. As some of you may be aware, in the past year there has been an increase in attempts to use tModLoader to distribute malicious code. As members and supporters of this incredible modding community, we want to assure both players and modders that we are taking steps to respond to this new wave of malicious mods. We have already improved the server mod-syncing feature to be significantly safer and introduced several backend systems for validation and moderation.

Recently, in partnership with Valve, we introduced a new approval queue to give us a chance to catch malicious mods and updates before they have a chance to make it to users. As this tooling is new for Steam Workshop, we greatly appreciate the patience of modders while we work through the kinks to reduce moderation times and user issues. We will continue to adapt and limit as many attack vectors as reasonably possible to protect our community, however there is always some inherent risk with using mods.

We encourage everyone to be vigilant and diligent as always and are thankful this community contains many members who actively seek out and help us identify new risks and mitigations. We'd like to thank Jamz for developing and testing code analysis software, and the many people who have analyzed suspicious mods and reported potential malware to us for investigation and action in the past.

New Mods Showcase

Here is a collage of new mods released this past month. There were over 550 new mods this month! Have you tried any of these mods yet? Find any hidden gems? Be sure to regularly check the workshop for newly released mods, we're positive you'll always find something fun and interesting to try out. Click here to see the most popular new mods from this month.

Stable Release

We are grateful for the massive amount of community participation in developing and testing new features each month.

If you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub or reach out to us at our Discord.

Changelog

The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide to see how to adapt to the new changes.

Major Changes

New Features

LTsivo: The Achievement Advisor (achievement icon next to the inventory) now supports modded achievements

API Changes

hezuo1hao: Added BossBarDrawParams.BossBarColor
Tyfyter: Added ModItem/GlobalItem.ApplyPrefix

Bug Fixes

Quality of Life and Other Fixes

Tyfyter: Fixed crash when in worlds with unloaded modded trees
sxysxy: Disable high DPI by default on OSX to fix performance. Use /enablehighdpi:1 to turn on.
JavidPack: Fix divine crate drop rates. It will now correctly have boosted ore/bar/coin drop rates
JavidPack: Sort the enviromment.log output to aid troubleshooting

API Fixes and Changes

JavidPack: Fix an issue where partial right or left tile anchors caused exceptions in some cases
JavidPack: Fix misleading workshop errors when publishing mods with Chinese description text

Other

ExampleMod and API Documentation

Konomi: Make ExampleStatue glow with spelunker potion, like other statues
JavidPack and Mirsario: Various Documentation Updates: 1, 2, 3

Localization

ayuyoiM: Chinese
Cloudea: Chinese for tModCodeAssist
RazzSG: Russian

We would also like to mention that we have volunteers translating our monthly release announcements into several other languages. If you would like to help translate these announcements into a supported language, please reach out on Discord.

Hello everyone! It is time for the February 2026 Stable Update, as well as some other news.

Plans for Terraria 1.4.5 Support

First, we hope everyone has been having fun playing the new Terraria v1.4.5 update (Bigger and Boulder). If you didn't know, Terraria just launched a huge update, be sure to check it out.

We know everyone is looking forward to tModLoader and mods having access to all of the new content and features as well. We'd like to remind users that updating tModLoader to major Terraria releases is a huge undertaking. We are committed to working diligently on migrating to v1.4.5, but it does take some time, so we ask players to please be patient.

For context, the process of updating tModLoader to v1.4.4 took 9 months. During that process, many large features were added to tModLoader to better support the capabilities of mods, which did extend the porting process quite a bit. We don't expect quite as many large changes this time, so the actual porting process should be shorter than how it was for v1.4.4.

We will have more information to share in later months as we start working on the update and have a better idea of the work involved.

We encourage modders to take this opportunity to come discuss any tModLoader API shortcomings on Discord and Github. Major releases present an opportunity to fix issues that couldn't be addressed properly in regular monthly releases.

Plans for Terraria 1.4.5 Support FAQ

Q: "Will all of my mods still work on v1.4.5 immediately?"
A: Due to how much has changed in the Terraria v1.4.5 update, the short answer to this is "no". Modders will, however, have ample opportunity to update their mods to v1.4.5 before it is officially released, so as long as the mods you are using are still maintained by the modder, they should be available on v1.4.5 once it has a stable release for players.

Q: "What will happen to 1.4.4?"
A: 1.4.4 mods and the 1.4.4 version of tModLoader will continue to exist and be available for players both during porting and after. It will be supported as a Legacy version like 1.3 and 1.4.3.

Q: "When will 1.4.4 stop receiving updates?"
A: 1.4.4 will continue to receive maintenance updates to ensure it stays functional. We do not have a date for when content updates will stop; in the near-term 1.4.4 will continue to receive regular updates until we are ready to 'Preview' the 1.4.5 beta build to modders.

Q: "Will 1.4.5 be backwards compatible with my worlds and players from 1.4.4?"
A: From tModLoader's side, one of our guiding principles is to ensure the player experience is as seamless as possible. We aim to maintain backwards compatibility in tModLoader and encourage modders to keep this in mind when it comes time.

Improving Security

We also want discuss our recent efforts in combating malware distribution on the workshop. As some of you may be aware, in the past year there has been an increase in attempts to use tModLoader to distribute malicious code. As members and supporters of this incredible modding community, we want to assure both players and modders that we are taking steps to respond to this new wave of malicious mods. We have already improved the server mod-syncing feature to be significantly safer and introduced several backend systems for validation and moderation.

Recently, in partnership with Valve, we introduced a new approval queue to give us a chance to catch malicious mods and updates before they have a chance to make it to users. As this tooling is new for Steam Workshop, we greatly appreciate the patience of modders while we work through the kinks to reduce moderation times and user issues. We will continue to adapt and limit as many attack vectors as reasonably possible to protect our community, however there is always some inherent risk with using mods.

We encourage everyone to be vigilant and diligent as always and are thankful this community contains many members who actively seek out and help us identify new risks and mitigations. We'd like to thank Jamz for developing and testing code analysis software, and the many people who have analyzed suspicious mods and reported potential malware to us for investigation and action in the past.

New Mods Showcase

Here is a collage of new mods released this past month. There were over 400 new mods this month! Have you tried any of these mods yet? Find any hidden gems? Be sure to regularly check the workshop for newly released mods, we're positive you'll always find something fun and interesting to try out. Click here to see the most popular new mods from this month.

Stable Release

We are grateful for the massive amount of community participation in developing and testing new features each month.

If you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub or reach out to us at our Discord.

Changelog

The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide to see how to adapt to the new changes.

Major Changes

New Features

Tyfyter: Added OnTileConverted hook

API Changes

Stephen Thiebaud: Add Jetbrains annotations for modder convenience
JavidPack: Update ModTree.SetTreeFoliageSettings parameters

Bug Fixes

Quality of Life and Other Fixes

API Fixes and Changes

Stephen Thiebaud: Fixed a tModCodeAssist exception

Other

ExampleMod and API Documentation

JavidPack: Added an exposed gem tile example (or multi-directional tile example)

Localization

ayuyoiM: Chinese
错数螺线: Fix a spawn condition mistake and more Chinese
Patrxgt: Polish
RazzSG: Russian
MisteryDuck: Russian

We would also like to mention that we have volunteers translating our monthly release announcements into several other languages. If you would like to help translate these announcements into a supported language, please reach out on Discord.

Hello everyone! It is time for the January 2026 Stable Update. We wish everyone a happy new year and look forward to all the exciting and amazing mods that will undoubtedly be created this year.

But first, here is a collage of new mods released this past month. There were over 350 new mods this month! Have you tried any of these mods yet? Find any hidden gems? Be sure to regularly check the workshop for newly released mods, we're positive you'll always find something fun and interesting to try out. Click here to see the most popular new mods from this month.

We are grateful for the massive amount of community participation in developing and testing new features each month.

This month's release contains various bug fixes and smaller features. We've fixed several remaining issues related to liquid rendering and tile spreading and also fixed some UI inconsistencies and errors.

Modders: As usual, we'd like to encourage modders to test out new tModLoader features on the preview branch if they are relevant to your mod. Major features in preview are announced in the preview-update-log channel on our Discord. We encourage mod makers to experiment with these and other new features on the preview branch and provide feedback this month so that they are ready for the stable release next month.

If you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub or reach out to us at our Discord.

Changelog

The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide to see how to adapt to the new changes.

Major Changes

API Changes

hezuo1hao: Added ProjectileID.Sets.MinionCannotBeFreed
direwolf420: Move ModAchievement.(Auto)SetStaticDefaults to FinishSetup so they load after content
JavidPack: CrawlToBottomOfReverseVineAndAddSpecialPoint now allows TopEdgeCanBeAttachedTo instead of just SolidTile, allowing attachment to platforms

Bug Fixes

Quality of Life and Other Fixes

Stephen Thiebaud: Fix rendering issues with blocks in liquids
Mellohi: Fix vanilla infection blocks spreading into each other
落秋枫叶: Made the launch scripts more robust, no longer unnecessarily deletes folders on first launch
JavidPack: Fix item frame drawing not respecting default Item.color
Ivan Ortiz: Achievement menu button updated
JavidPack: Fix modded only achievements toggle not being reset and showing wrong state on revisit
JavidPack: Fix world portrait preview image wrong in some situations
JavidPack: Remove fullscreen limitation from capture UI open folder button

API Fixes and Changes

JavidPack: Fix MusicID.Search not being populated
Stephen Thiebaud: tModCodeAssist will now check for incorrect `AddRecipeGroup` usage
Stephen Thiebaud: tModCodeAssist issue causing incorrect errors fixed

Other

ExampleMod and API Documentation

JavidPack: Update ExampleMod to use Type shorthand consistently
JavidPack: Example Workbench needed a unique name so EM recipes weren't misleading.
JavidPack: Various Documentation Updates: 1, 2, 3, 4

We would also like to mention that we have volunteers translating our monthly release announcements into several other languages. If you would like to help translate these announcements into a supported language, please reach out on Discord.

Hello everyone! It is time for the December 2025 Stable Update.

But first, here is a collage of new mods released this past month. There were over 300 new mods this month! Have you tried any of these mods yet? Find any hidden gems? Be sure to regularly check the workshop for newly released mods, we're positive you'll always find something fun and interesting to try out. Click here to see the most popular new mods from this month.

We are grateful for the massive amount of community participation in developing and testing new features each month.

This month's release contains various bug fixes and smaller features. We've fixed several regressions related to the liquid rendering fixes from last month and fixed some UI inconsistencies and errors. For modders, this month's release includes support for custom pressure plates along with new hooks for tile interactions, as well as new hooks for custom armor set shadow effects and transforming the full player rendering.

Modders: As usual, we'd like to encourage modders to test out new tModLoader features on the preview branch if they are relevant to your mod. Major features in preview are announced in the preview-update-log channel on our Discord. We encourage mod makers to experiment with these and other new features on the preview branch and provide feedback this month so that they are ready for the stable release next month.

If you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub or reach out to us at our Discord.

Changelog

The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide to see how to adapt to the new changes.

Major Changes

New Features

JavidPack: ModPlayer.DrawPlayer hook to facilitate custom player "shadow" visuals
Tyfyter: (Mod|Global)Tile.HitSwitch and (Mod|Global)Tile.SwitchTiles hooks, as well as PressurePlate tile set

API Changes

JavidPack: Preserve backwards compatibility for MonoMod hooks when a method receives a new overload, inherit Obsolete from origin method
Stephen Thiebaud: tModLoader-provided references will no longer be copied to mod output directories (/bin folder), reducing disk usage for mod developers
JavidPack: (ModTile|ModWall).PlaceInWorld now called based on what is actually placed, not Item.createTile/Wall

Bug Fixes

Quality of Life and Other Fixes

JavidPack: Fix housing UI issue with over 99 town NPCs
Kevin Pugliese: Fix other players' chat bubbles while in reverse gravity
JavidPack: Clarify redownload missing mod message and buttons
Stephen Thiebaud: Fix lots of liquid rendering edge case bugs
Ivan Ortiz: Fix another liquid rendering bug with slopes
Stephen Thiebaud: Fix another liquid rendering bug near edges of map
Mirsario: Restore lost TileID.Sets.Snow tile framing logic
Mirsario: Follow-up to "Fixed deallocation crashes in libnfd"

API Fixes and Changes

JavidPack: Update MonoMod to 25.3.2 (Fix race condition when updating executing ILHook, the "Referenced cell no longer exists" issue)
Mirsario: Main.CurrentPlayerOverride is now thread-local, fixing potential multi-threaded issues
Qther: tModCodeAssist: Support even more ID fixes
JavidPack: tModCodeAssist: Preserve whitespace and comments for ID fixes

Other

ExampleMod and API Documentation

JavidPack: Clarify ModPlayer syncing and more documentation
Mirsario: Improved ExampleCustomCurrency example

Localization

ayuyoiM and Cyrilly: Chinese 1, 2
RazzSG: Russian

We would also like to mention that we have volunteers translating our monthly release announcements into several other languages. If you would like to help translate these announcements into a supported language, please reach out on Discord.

Hello everyone! It is time for the November 2025 Stable Update.

But first, some news. This last week we hosted our third official mod jam on our Discord server. The theme was "Anything Can Happen on Halloween!" and we had several spooky mod submissions. We thank everyone who participated and hope it was fun and a great practice! We encourage players to check out the mod jam submissions on the workshop here.

If you are interested in participating in the next mod jam, be sure to come to Discord and grab the "ModJam Ping" role to be notified.

Also, here is a collage of new mods released this past month. There were over 320 new mods this month! Have you tried any of these mods yet? Find any hidden gems? Be sure to regularly check the workshop for newly released mods, we're positive you'll always find something fun and interesting to try out. Click here to see the most popular new mods from this month.

We are grateful for the massive amount of community participation in developing and testing new features each month.

This month's release contains mostly bug fixes and smaller features. We've fixed several UI inconsistencies, fixed a major sound volume issue, and even fixed major issues with how liquids are drawn, especially around sloped tiles. We've also implemented changes to support launching the game on ARM processors, which should prove useful to those looking to host dedicated servers on ARM machines. For modders, this month's release contains a few new features, most notably new API for modifying potion delay values. Other new features include more fixes for biome conversion and support for uploading server-side mods in-game. The full listing of other features and changes is detailed below.

Modders: As usual, we'd like to encourage modders to test out new tModLoader features on the preview branch if they are relevant to your mod. Major features in preview are announced in the preview-update-log channel on our Discord. Some features in preview for next month include support custom pressure plates along with new hooks for tile interactions, as well as new hooks for custom armor set shadow effects and transforming the full player rendering. We encourage mod makers to experiment with these and other new features on the preview branch and provide feedback this month so that they are ready for the stable release next month.

If you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub or reach out to us at our Discord.

Changelog

The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide to see how to adapt to the new changes.

Major Changes

New Features

Stephen T: Adjustable Potion Delay APIs

API Changes

direwolf420: Seed drop integration (Blowpipe, custom grass)
JavidPack: New dropdown style (and more) Enum ModConfig elements
Narnia: Server-side Upload Fixes, server-side mods can now be uploaded in-game
Mellohi: Touch-ups and bugfixes regarding biome conversion registries and biome spread
Chicken-Bones: Adjust Item.material logic to allow modders more control over if an item counts as a material
JavidPack: Remove tryBreakTrees parameter from WorldGen.ConvertTile
Lion8cake: Expose some liquid rendering fields to be both public and no longer readonly

Bug Fixes

Quality of Life and Other Fixes

Stephen T: Better Liquid Slope Rendering
JavidPack: Fix screen resolution affecting audio volume and panning in unexpected ways. These are no longer based on physical screen width
JavidPack: Fix clipboard operations (copy and paste) to work on all Linux configurations
JavidPack: Fix mod load order inconsistency issue when mod names contain non-ASCII characters (such as Chinese characters) leading to critical ID desync issues
Solxan: Some fixes for mod download issues
Chicken-Bones: Switch to new Steamworks.NET.AnyCPU package, and sdk v1.62
Chicken-Bones: Linux ARM processor support
Chicken-Bones: Optional Mac ARM processor support
JavidPack: Preserve Mods List menu sorting mode choice between game sessions.
JavidPack: Fix some non-English server prompts not accepting the correct options
Destructor_Ben: Adjust icon positioning on the Config List menu
Stephen T: Remove unused borderless option on windows
JavidPack: Fix some misleading button prompt language

API Fixes and Changes

JavidPack: Fix exception when too many TooltipLines
Destructor_Ben: Fix UIScrollbar hovering when obscured by another element
JavidPack: ModAccessorySlot documentation, fix a remaining issue with CurrentPlayer during UICharacter ctor
Destructor_Ben: Fix Launch Config for developing tModLoader in Rider
JavidPack: tModCodeAssist: NPCAIStyleID/ProjAIStyleID/AIType/AnimationType/aiStyle support
JavidPack: tModCodeAssist: BuffID and AddBuff support
JavidPack: tModCodeAssist: Fix equals expression for Tile properties
Mirsario: Fixed deallocation crashes in libnfd
Chicken-Bones: Fix DeveloperMode check invoking steam workshop and slowing down launch and mod building
direwolf420: Fix localization file hot reload feature on non-Windows machines

Other

ExampleMod and API Documentation

JavidPack: ExampleHeldProjectileWeapon, showcasing Player.PickAmmo and other common held projectile effects
JavidPack: Added SimpleModPlayer (and wiki updated) and ExampleCutTile
JavidPack: Guide to Plant Fiber Cordage support example for ExampleVine
JavidPack: Fix ExampleLastPrismHoldout dealing damage and ExampleCustomSwingProjectile not triggering jellyfish damage

Localization

ayuyoiM: Chinese
Fabricio-CL: French
RazzSG: Russian

We would also like to mention that we have volunteers translating our monthly release announcements into several other languages. If you would like to help translate these announcements into a supported language, please reach out on Discord.

Hello everyone! It is time for the October 2025 Stable Update.

But first, some news. This last week we hosted our second official mod jam on our Discord server. The theme was "It's Dangerous to Go Alone, Take This!" and it involved creating a small environment to explore. We thank everyone who participated and hope it was fun and a great practice! We encourage players to check out the mod jam submissions on the workshop here.

If you are interested in participating in the next mod jam, be sure to come to Discord and grab the "ModJam Ping" role to be notified. We intend to host the 3rd mod jam near the end of October and will make sure to announce it earlier on Discord so modders can plan time for it.

Also, here is a collage of new mods released this past month. There were 260 new mods this month! Have you tried any of these mods yet? Find any hidden gems? Be sure to regularly check the workshop for newly released mods, we're positive you'll always find something fun and interesting to try out. Click here to see the most popular new mods from this month.

We are grateful for the massive amount of community participation in developing and testing new features each month.

This month's release contains the new ModAchievement feature. We are excited to see how mods use ModAchievement and how they'll give players long-term goals to work towards. We've seen many mod makers showcasing their new achievement art this last month and look forward to seeing them in-game. The full listing of other features and changes is detailed below.

Another change this month is new warnings and checks when downloading mods from multiplayer servers. We want to encourage players to exercise caution when downloading mods directly from servers, especially with strangers, as this is risky due to the mods having the potential to run malicious code. We've updated the mod publishing process to facilitate verifying the validity of mods downloaded directly from servers.

Modders: As usual, we'd like to encourage modders to test out new tModLoader features on the preview branch if they are relevant to your mod. Major features in preview are announced in the preview-update-log channel on our Discord. Some features in preview for next month include support for properly adjusting potion delay and new options for presenting Enums in configs. We encourage mod makers to experiment with these and other new features on the preview branch and provide feedback this month so that they are ready for the stable release next month.

If you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub or reach out to us at our Discord.

Changelog

The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide to see how to adapt to the new changes.

Major Changes

New Features

Hexic, Midnight295: ModAchievement added. Mods can now add their own achievements.
Tyfyter: Tile and Wall Conversion Fallback/Inheritance. Better solution and biome conversion compatibility.
JavidPack: Add new workshop tag for translation mods
direwolf420: Add ModSystem.PostWorldLoad and TileID.Sets.ClearedOnWorldLoad

API Changes

efcawesome: Add (Mod|Global)Tile.ReplaceTile hook for when a tile is being replaced via block swap
Stardust9681: Added ExampleCustomUseStyleWeapon, an example of a custom useStyle. Also added ItemLoader.RegisterUseStyle

Bug Fixes

Quality of Life and Other Fixes

Solxan: Store Mod Hash Data in Developer Metadata. This feature facilitates verifying the validity of mods downloaded directly from servers.
JavidPack: Warning messages for downloading mods directly from servers. When joining a server, appropriate warnings are now shown to inform users of the risk of downloading mods from strangers.
JavidPack: Fix menu sound inconsistencies, fix escape when dialog is open behavior, fix dialog background tint feature
mathica: Fix jungle grass corruption conversion
JavidPack: Fix blockswap not working with stone platforms
JavidPack: Fix misleading message when kicked

API Fixes and Changes

JavidPack: UIGrid updated to match all UIList features. Now supports ManualSortMethod, iterator
JavidPack: Fix null issue with PlayerDrawLayer's Multiple Position
JavidPack: Fix MonoModHooks.DumpIL failing with long method names
Chicken-Bones: Update MonoMod.RuntimeDetour to 25.3.0 to work towards ARM support
Sergwest: Make SDK logs more clear
Destructor_Ben: Fix some mod template typos
BasicallyIAmFox: tModCodeAssist: Now detects using an incorrect XID class
BasicallyIAmFox: tModCodeAssist: Fixed negative IDs not being fixed
BasicallyIAmFox: tModCodeAssist: Common Collision Name analyzer, prevents mods accidentally using Terraria namespaces
tomat: tModCodeAssist: Simplify Main.player -> Main.LocalPlayer
JavidPack: tModCodeAssist: Now supports converting XID.Sets array index values
JavidPack: More tModCodeAssist support: 1, 2, 3, 4, 5

Other

ExampleMod and API Documentation

JavidPack: Example sentry
JavidPack: Various Documentation Updates: 1, 2, 3, 4

Localization

RazzSG: Russian
ayuyoiM: Chinese

We would also like to mention that we have volunteers translating our monthly release announcements into several other languages. If you would like to help translate these announcements into a supported language, please reach out on Discord.

Hello everyone! It is time for the September 2025 Stable Update.

But first, here is a collage of new mods released this past month. There were 390 new mods this month! Have you tried any of these mods yet? Find any hidden gems? Be sure to regularly check the workshop for newly released mods, we're positive you'll always find something fun and interesting to try out. Click here to see the most popular new mods from this month.

As always we are grateful for the massive amount of community participation in developing and testing new features each month.

This month's release contains new interaction options for NPC and projectiles, as well as a full rework of our code analyzer now called tModCodeAssist. The full listing of changes is detailed below.

Modders: We'd like to encourage modders to experiment with the new ModAchievement feature that is currently available on the preview branch. We know modded achievements have been a highly requested feature for some time, so we are excited to see mods use them. We encourage mod makers to experiment with this and other new features on the preview branch and provide feedback this month so that they are ready for the stable release next month.

As always, if you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub or reach out to us at our Discord.

Changelog

The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide to see how to adapt to the new changes after running tModPorter.

Major Changes

New Features

BasicallyIAmFox: tModCodeAssist (formerly tModLoader.CodeAssist) has been reworked and is now directly included in tModLoader releases. It will now be able to receive frequent updates. This is the code analyzer that fixes various code issues, most notably it fixes "magic numbers" to their correct ID values.
BasicallyIAmFox: (Mod|GlobalNPC).PreHoverInteract hooks. Lets modders override or piggyback off of right clicking on or hovering over an NPC.
JavidPack: Add ExampleInteractableProjectile and ProjectileID.Sets.IsInteractable. Projectiles can now be targeted by smart select and draw a smart select highlight.

API Changes

Ebonfly: An icon_small.png will now generate by default when creating mods. The icon_small will now show up in the config listing
Destructor_Ben: Add opt-out of mod building in tModLoader.targets

Bug Fixes

API Fixes and Changes

JavidPack: Fix wrong item issue with Player.QuickMana_GetItemToUse, Void Bag, and CanUseItem
JavidPack: Fix support for manually setting bestiary stars
Mirsario: Additional updates for uncapping sound effect pitch
JavidPack: Update HookGen

Other

ExampleMod and API Documentation

JavidPack: Add ExampleVine

Localization

Fish: Chinese
Fabricio-CL: French
RazzSG: Russian

We would also like to mention that we have volunteers translating our monthly release announcements into several other languages. If you would like to help translate these announcements into a supported language, please reach out on Discord.

Hello everyone! It is time for the August 2025 Stable Update.

But first, some news. This last month we hosted our first official mod jam on our Discord server and it was a mind-blowing success. The theme was "Game Tribute" and we were impressed with how many high quality submissions we had. We thank everyone who participated and hope it was fun and a great practice! We encourage players to check out the mod jam submissions on the workshop here. If you are interested in participating in the next mod jam, be sure to come to Discord and grab the "ModJam Ping" role to be notified.

Also, here is a collage of new mods released this past month. There were over 400 new mods this month! Have you tried any of these mods yet? Find any hidden gems? Be sure to regularly check the workshop for newly released mods, we're positive you'll always find something fun and interesting to try out. Click here to see the most popular new mods from this month.

As always we are grateful for the massive amount of community participation in developing and testing new features each month.

This month's release contains several notable features that mod makers can look forward to using, such as the highly requested ModConfig.SaveConfig feature. The full listing of changes is detailed below. Users will be happy to know that this release fixes many sound issues, most notably sounds cutting each other off or stopping early.

As always, if you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub or reach out to us at our Discord.

Changelog

The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide to see how to adapt to the new changes after running tModPorter.

Major Changes

New Features

Destructor_Ben: Add ModConfig.SaveChanges
Chicken-Bones: More sound fixes and new SoundStyle options

API Changes

JavidPack: Support and showcase Otherworld alternate music logic
KaidenJoy: Negative NPCIDs now compatible with NPCDefinition

Bug Fixes

Quality of Life and Other Fixes

Harper Stoeckle: Fix escape not working while inputting text on on non-Windows platforms
JavidPack: Fix bug causing 2x2 jungle plants to be invisible
JavidPack: Fix Sky Dragon's Fury's alternate attack not being affected by melee speed
JavidPack: Fix an issue with ShadowFlameHexDoll and use speed hooks.

API Fixes and Changes

Jacob Adams: Support paint spraying for any sized tile
JavidPack: NPCDefinition ordering now uses bestiary ordering. Colored slimes now draw in color.
JavidPack: Add ShadowFlame to Main.debuff
CactusDuper: Fix LongMoss missing from TileID.Sets.IgnoredByGrowingSaplings

Other

ExampleMod and API Documentation

JackerAcid: Improve MessageID Documentation and other netcode methods
JavidPack: Update docs to discourage using buggy FindChestByGuessing method
JavidPack: Documentation explaining item usage and item animation fields
JavidPack: Various Documentation Updates: 1, 2, 3, 4, 5, 6, 7, 8, 9

We would also like to mention that we have volunteers translating our monthly release announcements into several other languages. If you would like to help translate these announcements into a supported language, please reach out on Discord.

Hello everyone! It is time for the July 2025 Stable Update.

But first, here is a collage of new mods released this past month. Have you tried any of these mods yet? Be sure to regularly check the workshop for newly released mods, we're positive you'll always find something fun and interesting to try out. Click here to see the most popular new mods from this month.

As always we are grateful for the massive amount of community participation in developing and testing new features each month.

This month's release contains several notable features that mod makers can look forward to using, such as loadout support for modded accessory slots new hooks for tile preview rendering. The full listing of changes is detailed below. Users can use a new chat command (/purgeunloaded) to remove unloaded tiles in worlds that are from mods they are no longer using.

Modders: There are several features of note currently in preview for next month that modders can test and provide feedback for. The most impactful change in preview this month relates to a large batch of fixes we've made to various vanilla sounds. These fixes should finish bringing all sounds to parity with vanilla behavior. These changes might influence existing mod logic as well, so be sure to test out sounds in your mods after reading the porting notes. We encourage mod makers to experiment with these new features on the preview branch and provide feedback this month so that they are ready for the stable release next month.

As always, if you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub or reach out to us at our Discord.

Changelog

The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide to see how to adapt to the new changes after running tModPorter.

Major Changes

New Features

Adrian Lück: Add equipment loadouts support for ModAccessorySlot
queue: Tile Placement Preview Draw Hooks
Ebonfly: ModNPC.DeathMessage, ModNPC.ModifyDeathMessage(), and NPCID.Sets.IsTownChild

Bug Fixes

Quality of Life and Other Fixes

JavidPack: Fix another map file saving issue if loading corrupted map file
JavidPack: Finish implementing deleting unloaded tiles feature, add VanillaFallbackOnModDeletion examples

API Fixes and Changes

JavidPack: Fix ModProjectile.GlowTexture not drawing for projectiles with multiple frames
JavidPack: Fix wall blending (Main.wallBlend) issues for modded walls
JavidPack: Fix ModGore permanently transforming into vanilla gore in some situations
IbanPlay: Fix incorrect tile update check in Worldgen.TileFrame()

Other

ExampleMod and API Documentation

JavidPack: Fix ExampleStatue to flip like other statues.
JavidPack: TileID.Sets.BreakableWhenPlacing/ReplaceTileBreakUp documentation and correct ExampleMod usages
TerrorPenguin: Update ExampleBar to break properly when above another hammered bar tile
JavidPack: Add note about ItemID.Sets.Deprecated not being fully supported yet
JavidPack: Various Documentation Updates: 1, 2, 3

Localization

Fish: Chinese 1, 2
RazzSG: Russian

We would also like to mention that we have volunteers translating our monthly release announcements into several other languages. If you would like to help translate these announcements into a supported language, please reach out on Discord.

Hello everyone! We've hit another impressive milestone this last month. The workshop now has over 10,000 mods available! That's amazing! Be sure to regularly check the workshop for newly released mods, we're positive you'll always find something fun and interesting to try out.

Each month hundreds of new mods are released, each a result of countless hours of work put into them by their creators. Here is a collage of the icons of most of the new mods released this last month alone.

It is time for the June 2025 Stable Update.

We are once again grateful for the massive amount of community participation in developing and testing new features each month. Modders can look forward to new hooks and learning examples showcasing new capabilities. Some notable new features include a full custom ModType example in ExampleMod and new hooks for properly implementing custom equipment layers and draw flags. The full listing of changes is detailed below.

Preview: There are several features of note currently in preview for next month that modders can test and provide feedback for. One new feature is equipment loadout support for ModAccessorySlot. We'd like to encourage modders to test this new feature so we know it is ready for release. Other features in preview include support for custom death messages for town NPC and bosses as well as support for clearing a world of tiles from unloaded mods. Please experiment with these new features on the preview branch and provide feedback this month so that they are ready for the stable release next month.

As always, if you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub or reach out to us at our Discord.

Changelog

The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide to see how to adapt to the new changes after running tModPorter.

Major Changes

New Features

Ebon: UpdateVisibleAccessory and UpdateItemDye hooks for items, CustomVisualEquipType example showcase
JavidPack: Added a Custom ModType Example to ExampleMod
JavidPack: Added Player.breathEffectiveness to facilitate "extends underwater breathing" effects

API Changes

Ebon: Uncapped sound effect pitch property
Ebon: Long and ulong type support for ModConfig
Ebon: Added (Mod|Global)Wall/ModPlayer.CanBeTeleportedTo() to support preventing teleporting to specific locations
Jacob Adams: Expose MapOverlayDrawContext state for use in custom map layers

Bug Fixes

Quality of Life and Other Fixes

Solxan: Show a message if a subscribed workshop mod has been delisted
JavidPack: Deleting a mod will no longer scroll back to top of the mods menu
JavidPack: Fix clipboard feature not properly clearing existing clipboard data
JavidPack: Fix text wrapping not working for Main.NewText when zoomed in or out
JavidPack: Mods with only hidden NPC will no longer show up in the bestiary filters

API Fixes and Changes

Chicken-Bones: Throw exception when player draw layers attempt to position relative to other movable layers
Silencersn: Fix a game crash caused by attempting to save special list types
JavidPack: Make some requested wind and tile drawing related fields/methods public

Other

ExampleMod and API Documentation

stormytuna: Add documentation noting which hooks are called where in multiplayer
Ebon: ExampleCameraModifier added, showcasing a custom camera modifier

JavidPack: Various Documentation Updates: 1, 2, 3

Localization

RazzSG: Russian
Silencersn: Chinese

We would also like to mention that we have volunteers translating our monthly release announcements into Chinese, Russian, Brazilian Portuguese, Polish, and Spanish. If you would like to help translate these announcements into another supported language, please reach out on Discord.

Hello everyone! It is time for the May 2025 Stable Update.

We are once again grateful for the massive amount of community participation in developing and testing new features each month.

This month's release contains several notable features that mod makers can look forward to using. Features include brand new support for biome conversions and for custom ID sets as well as improved support for custom tile drawing and tile entities. The full listing of changes is detailed below.

Modders: There are several features of note currently in preview for next month that modders can test and provide feedback for. One new feature is the new UpdateVisibleAccessory and UpdateItemDye hooks. These new hooks along with the CustomVisualEquipType showcase show off how to properly implement custom player drawing for custom equip types. This will allow modders to draw these things in the correct and working manner. Another new feature is the custom ModType example in ExampleMod. This has been a frequently requested feature and we're happy to finally have an easy to follow example for this. We encourage mod makers to experiment with these new features on the preview branch and provide feedback this month so that they are ready for the stable release next month.

As always, if you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub or reach out to us at our Discord.

Changelog

The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide to see how to adapt to the new changes after running tModPorter.

Major Changes

New Features

JavidPack: Custom and Named ID Sets ("content tags"). Mods can now create their own "Sets" and collaborate easily using them.
IbanPlay: Biome conversion support. Added Convert() hook for ModBlockTypes, Tile/WallLoader.RegisterConversion(), and other related features
JavidPack: Basic tile entity example and many more new helper methods to make working with tiles and tile entities easier
JavidPack: ExampleChandelier and several new related ModTile hooks. Swaying tiles are now customizable.

API Changes

Jacob Adams: ModMapLayer positioning can now be customized
JavidPack: Added NPCID.Sets.DoesntDespawnToInactivityAndCountsNPCSlots

Bug Fixes

Quality of Life and Other Fixes

Solxan: Add warning message if subscribed workshop mod has been removed from workshop (Hotfix)
Harper Stoeckle: Fix incorrect text rendering in several places
Solxan: Only show community announcements in-game
Solxan: Use DisplayNameClean if available for Missing and New Mods messages
Ben-tal: Fix Missing Sound Mappings, fixing some sounds that were not playing correctly

API Fixes and Changes

JavidPack: Fix vanilla frost and pumpkin moon music priority
JavidPack: Fix issue with using MonoModHooks.DumpIL on methods with generic parameters
JavidPack: Fix issue with game update methods being called on server before any player connects
CornHusker89: Add check for broken tModLoader methods when verifying mod assemblies, fixing misleading error messages
JavidPack: Fix instanced item drops becoming stuck while using NPCLoader.blockLoot
JavidPack: Expose ContentSamples.AddItemResearchOverride, Fix ContentSamples.CreativeResearchItemPersistentIdOverride not clearing
JavidPack: Fix mods located outside ModSources folder showing up twice in menu
Chicken-Bones: TagSerializableSerializer is now able to find subtype serializers in dll references
Tyfyter: Let damage classes inherit generic prefixes
IbanPlay: Made critter cage lids account for multi-column spritesheets
Lion8cake: TileLoader.DrawEffects now called after drawData.colorTint/finalColor assignment
Mirsario: Fixed NPC BuffLoader.Update not accounting for buffIndex changes
JavidPack: Fix crash from bad build.txt values (Hotfix)

Other

ExampleMod and API Documentation

hezuo1hao: Localize hard-coded text within ExampleMod
Thanatos: Fix ExampleSoul item not rendering at the expected full brightness
JavidPack: Various Documentation Updates: 1, 2

Localization

Fish: Chinese
RazzSG: Russian

We would also like to mention that we have volunteers translating our monthly release announcements into Chinese, Russian, Brazilian Portuguese, Polish, and Spanish. If you would like to help translate these announcements into another supported language, please reach out on Discord.