tModLoader news & patch notes

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. {STEAM_CLAN_IMAGE}/37627134/23d67d073601b2366c5dc092912b07bfbe9eb879.png

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. {STEAM_CLAN_IMAGE}/37627134/f0875b7303ae790794b506cde47211a87f2ed5de.png

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. {STEAM_CLAN_IMAGE}/37627134/640c03b116ae1683be9e8eff69780f38a1735720.png

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. {STEAM_CLAN_IMAGE}/37627134/c101b1c13fe38e7083919fe070db0ef3e72b74c8.png

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. {STEAM_CLAN_IMAGE}/37627134/e916518a9ca55fe2f4429a340123ba6e9345243a.png

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. {STEAM_CLAN_IMAGE}/37627134/9f9142ca72356ad6efc8d2dd1ca6eb5fe8f30512.png 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. {STEAM_CLAN_IMAGE}/37627134/af23edc9114bca4c157fa2daa7628f7e281ba303.png 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. {STEAM_CLAN_IMAGE}/37627134/58cb8f32e64777e28127e95f7cf188c0bd349bba.png 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. {STEAM_CLAN_IMAGE}/37627134/0529b1dc13a12f2aaac1fa7853fc45380f7a5441.png 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. {STEAM_CLAN_IMAGE}/37627134/7ab4112a24871cacd6504c99b638ece2a6d2b4f3.png 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. {STEAM_CLAN_IMAGE}/37627134/7522632ce0360d239466dad70d9511a56faebe41.png 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. {STEAM_CLAN_IMAGE}/37627134/e12b69a7fb1b2489f4388b828989f68f6e35bbf3.png 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. {STEAM_CLAN_IMAGE}/37627134/d31c847435c256408f67ebfb30dcafff77df0d37.png 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.

Hello everyone! This last month tModLoader hit an exciting new player count record. We had 56,000 players playing at the same time! We look forward to even more users enjoying playing tModLoader as new mods continue to come out and existing mods continue to update. It is time for the April 2025 Stable Update. A notable change for this month's release is the AddSpecialDraw changes for tile rendering. We hope mod makers read the pull request description and apply the fixes to their own tiles if relevant. The full listing of changes is detailed below. There are several features of note currently in preview for next month. One such feature is support for various biome conversion methods and classes. Another feature is greatly streamlined ModTileEntity code as well as a fully documented BasicTileEntity example. We've added support for customizing swaying tiles as well, allowing mods to make fully functional Chandeliers and other tiles. And finally, this preview also includes support for "custom ID sets", or content tags. This feature has been highly requested for a long, long time and we are excited to see mods use it. 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: TileCounterType.CustomSolid/NonSolid support for AddSpecialDraw, fix blurry example relic tile visuals JavidPack: Added TileID.Sets.NegatesFallDamage for tiles like cloud that prevent fall damage JavidPack: Localize custom player death messages (PlayerDeathReason.ByCustomReason)

Bug Fixes

Quality of Life and Other Fixes

JavidPack: The warning for family share limitations can now be dismissed permanently. Solxan: Maintaining the monthly release automations

API Fixes and Changes

Ebon: description_workshop.txt now generates by default when creating mods Chicken-Bones: Fix an issue preventing accurate log messages JavidPack: Mod.GetPacket error message clarification, additional related docs

Other

ExampleMod and API Documentation

JavidPack: ExampleMod now uses the newer and simpler collection initializer syntax JavidPack: Various Documentation Updates: 1, 2, 3, 4, 5

Localization

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.

Hello everyone! It is time for the March 2025 Stable Update. Once again we are impressed with the amount of community participation driving many of the features and bug fixes present in this month's release. Notable changes for this month's release include highly requested changes to tree shaking hooks and changes to modded music volume options. There are also many other fixes to help mod makers identify and fix programming errors. The full listing of changes is detailed below. 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

Rijam: Vanilla Tree Shaking Hooks Ebon: Added MusicID.Sets.SkipsVolumeRemap[] to allow modded music to play at full volume tomat: Enable developer features for local mods built from outside of "Mod Sources" folder

API Changes

Kogsey: Minor Decraft Fixes Narnia: Added ModCommand IsCaseSensitive property

Bug Fixes

Quality of Life and Other Fixes

JavidPack: Added help message for confusing situation when a mod disables itself during host and play. Fix issue where server process wouldn't close properly. JavidPack: Fix critter spawn location while in reverse gravity James Puleo: Fix network lag caused by Shimmer buff James Puleo: Fix Skeletron Prime's Laser Arm not shooting lasers as often as expected in Multiplayer JavidPack: Add status text for "Backing up player file" to help diagnose player saving issues Alice H.: More robust Bash launch script code

API Fixes and Changes

JavidPack: Fix various ProjectileLoader/NPCLoader.ReceiveExtraAI exception messages, optimize message size, and reorder modded and global bytes in message James Puleo: Fix `PlayerDisconnect` hook being called with bogus player JavidPack: Fix potential infinite loop with angler quests JavidPack: Prevent modder mistake of dllReferences duplicating a modReferences entry in build.txt JavidPack: Silence "BadImageFormatException: Read out of bounds"-errors in exception logging. Chicken-Bones: Fix line numbers in first chance exceptions Silencersn: Fix an incorrect banner log warning

Other

ExampleMod and API Documentation

JavidPack: Clean up more of Old folder Mirsario: Increased ExampleBiome track's volume due to XACT remapping. JavidPack: Add documentation warning against misuse of Item.SetNameOverride ScalarVector: Update documentation of ModifyDamage hooks to clarify they should not include side effects JavidPack: Various Documentation Updates: 1, 2, 3

Localization

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.

Hello everyone! It is time for the February 2025 Stable Update. The tModLoader team and our amazing community of contributors are back in the swing of things working on new features and fixes for tModLoader this month. Notable changes for this month's release include improvements to startup time and various other fixes. We also intend to enable the Steam Runtime this month for Linux users in an effort to make running tModLoader more compatible across different Linux systems. Please don't hesitate to get in touch if this change breaks anything for you. For mod makers, features of note currently in preview for next month include expanded tree shaking hooks and expanded shimmer recipe decrafting control. 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

tomat: Speed up start-up times by postponing .tmod file hash verification

Bug Fixes

Quality of Life and Other Fixes

Michael Scott: Fix UpdatePlayerLuckFactors network message

API Fixes and Changes

covers1624: Fix dotnet detection under steam runtime on Linux tomat: Allow the fullBright parameter of ModPlayer.DrawEffects to work as expected tomat: Filter actual Mod-extending types to only include non-abstract types Tygyh: Update vulnerable dependencies

Other

Localization

Tomasz: Polish Pixelnando: Brazilian Portuguese 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! The tModLoader team has had a bit of a slower month, as we take time to take a breath and relax to close out the year. We will be back at it in 2025, ready to take tModLoader to the next level! This month's release is relatively light. We will be trialing some performance improvements in backend mod validation and an optimization in player DrawEffects in preview. We'd like to remind modders about the preview branch where we test new features before they arrive in stable the following month. Modders interested in these new features, listed both on our GitHub and in the #preview-update-log of our Discord, can join the preview branch to get early access to the new features and test them in their mods. We really appreciate the feedback from modders using the preview branch to try out the new features. 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: Greatly improved enemy banner support (ModBannerTile) and ExampleMod example (EnemyBanner.cs) MutantWafflez: Bestiary info element categorization control

API Changes

JavidPack: More BitsByte helper methods for reading and writing data JavidPack: Made GrowMoreVines and nearbyChlorophyte methods public

Bug Fixes

Quality of Life and Other Fixes

N/A

API Fixes and Changes

N/A

Other

ExampleMod and API Documentation

Silencersn: Added ExampleSandRod JavidPack: Add example of storing Item instance for accessory effect to WaspNest JavidPack: Multiple additions to API documentation: 1, 2

Localization

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

It is time for the December 2024 Stable Update. The tModLoader team and our amazing community of contributors continues to improve tModLoader. We've had quite a lot of community contributions this month. This month's release contains support for modded clouds, tiles swaying in the wind, opening up a ModConfig menu directly, and many more changes. We look forward to mod updates using these new features. We've also updated the mod publishing process to ensure that every mod has a custom icon and an adequate description, which should make browsing the workshop a more pleasant experience. We'd like to remind modders about the preview branch where we test new features before they arrive in stable the following month. Modders interested in new these features, listed both on our GitHub and in the #preview-update-log of our Discord, can join the preview branch to get early access to the new features and test them in their mods. We really appreciate the feedback from modders using the preview branch to try out the new features. Major features currently in preview include greatly improved enemy banner support and support for custom data sets. Please give them a test and let us know if you run into any issues. 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

TechnicalitiesDevelopment and Mirsario: Increase Workshop Publication Requirements to ensure all mods have icon and useful description MutantWafflez: Multi-Tile Wind Sway Capabilities ArctanDeveloper and JavidPack: ModCloud implementation and Example Mod examples TechnicalitiesDevelopment: New MountData parameters to allow Minecarts to have custom stats after Minecart Upgrade Kit usage Destructor_Ben and JavidPack: Add ModConfig.Open and ExampleFullscreenUI example JavidPack: Map backgrounds can now use sky color or custom draw color

API Changes

Xetaxheb: Allow Player.Hurt to be canceled (HurtModifiers.Cancel()) JavidPack: More BitsByte helper methods for reading and writing JavidPack: Player.breathMax now resets automatically and related documentation Tyfyter: Made DynamicSpriteFont.SpriteCharacterData public JavidPack: Fix a bounds check with ArmorIDs.Front.Sets.DrawsInNeckLayer

Bug Fixes

Quality of Life and Other Fixes

JavidPack: Fix various crate drop rate discrepancies JavidPack: Fix full InfoDisplay listing not working correctly TechnicalitiesDevelopment: Mod Packs now colored bright green if additional mods are enabled Tigerzzz: Fix MouseText misalignment issue with text using chat tags JavidPack: Fix Enum with out of bounds values in ModConfig causing crash

API Fixes and Changes

JavidPack: Show context lines of localization file syntax errors in the error message JavidPack: Fix CanStack not being honored for ammo slots on pickup JavidPack: Fix array of objects in ModConfig causing crash JavidPack: Add instructions to mod sources menu to do the first mod guide if new JavidPack: Log client side mods when joining server to facilitate troubleshooting JavidPack: Fix an issue with setup.bat Chicken-Bones: More work on launching tModPorter correctly Solxan: Fix and maintain automatic release systems

Other

ExampleMod and API Documentation

JavidPack: Fix ExampleMod afterimage trail drawing and related docs JavidPack: ExampleRobe now shows how to load female-specific legs texture JavidPack: Use UICommon.TooltipMouseText instead of Main.hoverItemName for tooltip example JavidPack: Various Documentation Updates: 1, 2, 3, 4, 5

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, and Polish. If you would like to help translate these announcements into another supported language, please reach out on Discord.

It is time for the November 2024 Stable Update. The tModLoader team and our amazing community of contributors continues to improve tModLoader. Once again this month's release contains many improvements to the user experience, some gameplay bug fixes, as well as new features with examples and documentation for mod makers. We'd like to remind modders about the preview branch where we test new features before they arrive in stable the following month. Modders interested in new these features, listed both on our GitHub and in the #preview-update-log of our Discord, can join the preview branch to get early access to the new features and test them in their mods. We really appreciate the feedback from modders using the preview branch to try out the new features. One feature we are currently previewing is additional support for modded tiles that react to wind and player movement, as some vanilla tiles do. Modders on the preview branch can test it out and make sure it works correctly for chandeliers, banners, vines, and other similar tiles. 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

API Changes

Destructor_Ben: Add hooks for armor set bonus activation (ModPlayer.ArmorSetBonusHeld and ArmorSetBonusActivated)

Bug Fixes

Quality of Life and Other Fixes

JavidPack: Fix money exploit when stacking items sold for shopCustomPrice JavidPack: Fix hard server crash when loading completely broken world file. JavidPack: Update serverconfig.txt instructions

API Fixes and Changes

JavidPack: Custom error message for attempting to build in Visual Studio while tModLoader has the .tmod file open Solxan: Fix and maintain automatic release systems

Other

ExampleMod and API Documentation

JavidPack: Added CustomItemDrawingShowcase, fixed ItemDefinition Pre/PostDrawInInventory usage, documentation JavidPack: Fix ExampleCoinsUI odd drag behavior, related UIElement documentation JavidPack: Add fruit texture to ExampleCactus JavidPack: Clarify ExampleGun code JavidPack: Various Documentation Updates: 1, 2, 3

Localization

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

It is time for the October 2024 Stable Update. The tModLoader team and our amazing community of contributors continues to improve tModLoader. Once again this month's release contains many improvements to the user experience, some gameplay bug fixes, as well as new features with examples and documentation for mod makers. One major contribution we'd like to highlight this month is work by alueck that enables Mac and Linux users to contribute directly to tModLoader. If you are a Mac or Linux user and have been wanting to contribute a new feature to tModLoader, it should now be possible and we are willing to help on Discord if you run into any roadblocks. 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

Tyfyter: Multiple prefix category support alueck and Chicken-Bones: New CLI for tModLoader project, allowing contributing features to tModLoader by Mac and Linux modders

API Changes

IbanPlay: Added PostTileFrame and ModifyFrameMerge hooks for ModTile

Bug Fixes

Quality of Life and Other Fixes

JavidPack: Fix GOG Workshop regression (Hotfix) Tyfyter: Preserve prefixes on unloaded items and for unloaded prefixes Adrian Lück: Fix item variants not being shown in NPC shops Johannes Grimm: Increase maximum supported length of chest names JavidPack: Fix Terraformer using more ammo than intended Johannes Grimm: Added confirmation dialog to toggle all mods buttons JavidPack: Fix InfoDisplay not displaying in some situations JavidPack: Added checks, filtering, and logging for local mods with non-standard filenames. Fixes issue with multiple local copies of mods JavidPack: Fix issue with deleting active modpack JavidPack: Better detection of GOG+Linux Terraria.exe location JavidPack: Ability to search mods by steamid64 JavidPack: Fix secret seeds spamming logs with world gen messages JavidPack: Log which native dll is throwing a native exception for troubleshooting JavidPack: Add logging to help determine if a crash is caused by initializing game controllers

API Fixes and Changes

Solxan: Fixed Non-Public Mod Publishing (Hotfix) JavidPack: Fix ObjectElement ignoring ShowDespiteJsonIgnoreAttribute

Other

ExampleMod and API Documentation

JavidPack: TownNPCRespawnSystem, example of free TownNPC respawn feature JavidPack: Updated ExamplePylon shop entry example JavidPack: Various Documentation Updates: 1, 2, 3, 4

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, and Polish. If you would like to help translate these announcements into another supported language, please reach out on Discord.

It is time for the September 2024 Stable Update. The tModLoader team and our amazing community of contributors continues to improve tModLoader. This month's release contains many improvements to the user experience, various bug fixes, as well as new features with examples and documentation for mod makers. One new feature we want to showcase in particular is in-game workshop tag filtering. We hope this new filter will help users find the mods they want more easily in-game. We expect this feature to especially help users find mods that support their native language. {STEAM_CLAN_IMAGE}/37627134/d52e6185a8ec969d39d61aa7742b0ae09b8db9b1.png 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: Added workshop tag filtering in Mod Browser JavidPack: Add page up and page down support to Mods and Mod Browser menus Wojciech Nawa: Add podman support for dedicated servers

API Changes

direwolf420: Add ProjectileID.Sets.FiresFewerFromDaedalusStormbow

Bug Fixes

Quality of Life and Other Fixes

JavidPack: Fix version upgrade hints to more reliably detect and inform when a mod is preview only JavidPack: Fix language=languageCode server config file option JavidPack: Fix WorldGen passes staying disabled instead of resetting JavidPack: Added checks, filtering, and logging for local mods with non-standard filenames

API Fixes and Changes

JavidPack: Fix several TileObjectData issues and document TileObjectData class JavidPack: Fix Item.ArmorPenetration not properly resetting JavidPack: Fix BuffLoader.Update not being called for some vanilla buffs Chicken-Bones: Fix serialization of arrays in TagCompound JavidPack: Document Main.dayTime and related. Fix incorrect entries in SortingPriorityBossSpawns JavidPack: Update MonoMod to 25.1.1 to fix missing MonoMod documentation JavidPack: Fix documentation references for nuget packages JavidPack: Fix ModConfig members declared as Object crashing

Other

ExampleMod and API Documentation

direwolf420: Fix ExampleChest consuming key when other conditions are not met JavidPack: Update ExampleHomingProjectile and document related fields and methods JavidPack: StatModifier Documentation Mirsario: Updated outdated (Mod|Global)X summaries JavidPack: Document ModMount texture autoloading uniqueness JavidPack: Document JIT related attributes/annotations

Localization

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

It is time for the August 2024 Stable Update. The tModLoader team and our amazing community of contributors continues to improve tModLoader. This month's release contains many improvements to the user experience, various bug fixes, as well as new features with examples and documentation for mod makers. 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: Add Recently Published sort, Time Period sort, and update Hot sort to the workshop menu. Better workshop user experience JavidPack: Memory tracking feature reworked and added back to mods menu

API Changes

Rijam: Example Rockets and explosive projectile fixes and features Rijam: Added support for modifying Petting, Chat Bubble, Party Hat, and Emote Bubble positions. Added ExampleTownPet and License example JavidPack: UseItem will now be called during QuickHeal and QuickMana JavidPack: Added ExampleFlask and EmitEnchantmentVisualsAt hook. Weapon imbue visuals can now support projectiles properly JavidPack: NPCID.Sets.NeverDropsResourcePickups added and MinionBossMinion now showcases guaranteed heart drops JavidPack: Player.MeleeEnchantActive helper property added

Bug Fixes

Quality of Life and Other Fixes

JavidPack: Config list UI will now show all mods to reduce user confusion JavidPack: Improve performance of player select menu and visual consistency of other menus JavidPack: Fix issue preventing users downloading mods built for a newer build version of tModLoader JavidPack: Mod location icon in mod listing now shows helpful tooltip. Improve visual consistency of other menus JavidPack: Fix mod icon blurry on Mods menu, fix many other icons blurry JavidPack: Error message for Mac users on outdated macOS

API Fixes and Changes

Oliver Heamon: Run expensive tasks in Mod Sources asynchronously JavidPack: Modders accidentally using obsolete LocalizedText.SetDefault will now be shown a helpful custom error message JavidPack: Fix issue preventing pluralized LocalizedText being used in BroadcastChatMessage method JavidPack: Add error message for modders most likely renaming .png textures instead of saving in .png format. JavidPack: Fix errors caused by malformed build.txt files and incorrect 32 bit Linux detection JavidPack: Fix JITException error message sometimes repeating same mod multiple times JavidPack: Add error when it is detected that a recently built mod will not be loaded due to version or modpack priority Solxan: Added 'internal name' to workshop description and other refactors Lacewing: Resprite localization buttons JavidPack: GraniteBiome StructureMap fix and related docs JavidPack: Remove obsolete AllowVanillaClients from code

Other

ExampleMod and API Documentation

Narnia: Added ExampleSign, showcasing sign related methods and tile alternate placements JavidPack: Added ExampleResourcePickup, a resource pickup item example JavidPack: Fix vanilla UIElement class LockVanillaMouseScroll usage and document some UIElement methods JavidPack: Document tooltip drawing methods and others JavidPack: Document TagCompound, secret seeds, etc

Localization

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

It is time for the July 2024 Stable Update. The tModLoader team and our amazing community of contributors continues to improve tModLoader. This month's release contains many improvements to the user experience, some gameplay bug fixes, as well as new examples and documentation for mod makers. 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.

New Changes' Highlights

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.

New Features

API Changes

None this month.

Bug Fixes

Gameplay Fixes

JavidPack: Fix sellback exploits with shopCustomPrice Solxan: Fix crash caused by duplicated launch arguments JavidPack: Better error message for unsupported 32 bit Windows users Michael Scott: Fix issue with dresser menu by unloading Main.dresserInterfaceDummy correctly JavidPack: Remove ValidModBrowserSignature usage and remove unusable OnlyDownloadSignedModsFromServers config to fix a rare issue with some Linux users Solaestas: Fix issue causing IL edit crashes by clearing ReflectionHelper cache

Quality of Life and Other Fixes

JavidPack: Fix escape key behavior on menus and an input text issue JavidPack: Update Download Mods menu, added backgrounds to tooltips JavidPack: Added icons to indicate client and server configs. Solxan: Remove memory estimates feature temporarily

API Fixes and Changes

Solxan: Added support to publish a mod using the Unlisted visibility option Solxan: Publish mod menu now says "update" when updating an existing mod Solxan: Fix an issue preventing republishing a mod that had been removed from the workshop JavidPack: Fix ModifyActiveShop items parameter, items should not be null Reverted, the original behavior was correct. Chicken-Bones: Improve FastParallel.For deadlock logging. Add crash dump option for exceptions JavidPack: Improve error messages and behavior for mod sources with invalid versions JavidPack: Add processor count logging Solxan: Add RAM logging

Other

ExampleMod and API Documentation

TacoConKvass: Example Boots and document movement stats JavidPack: Document proper ProjectileID.Sets.DontAttachHideToAlpha usage Blu3: Example Arrow JavidPack: Some more notes about ExampleMod class being a partial class Solxan: Documentation on disabling TerrariaSteamClient if needed Solxan: Preformatted Dotnet Environment Dump Variables in case CTD with no natives.log context. Default Off. Vadim Placinta: Update serverconfig.txt to mention -nosteam option

Localization

Pixelnando: Brazilian Portuguese - Steam page RazzSG: Russian Tomasz: Polish JavidPack: Localize Create Mod menu and some missing ModConfig text We would also like to mention that we have volunteers translating our monthly release announcements into Chinese, Russian, and Brazilian Portuguese. If you would like to help translate these announcements into another supported language, please reach out on Discord.

It is time for the June 2024 Stable Update. The tModLoader team and our amazing community of contributors continues to improve tModLoader. This month we've fixed a few UI issues: some fixes for the ModPacks feature, some UI fixes for multiplayer connections, and a UI fix for Mod Browser / downloading mods. 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.

New Changes' Highlights

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.

New Features

API Changes

BasicallyIAmFox: Allow shaders to omit parameters they don't use JackerAcid: ItemID.Sets.DuplicationMenuToolsFilter added to allow categorizing items as tools JavidPack: GoreID.Sets.LiquidDroplet added and ExampleDroplet updated

Bug Fixes

Gameplay Fixes

JavidPack: Fix Daybreak and Solar Eruption Explosions erroneously delivering critical hits JavidPack: Fix sellback price issue with shop items using shopCustomPrice JavidPack: Fix credits not working sometimes

Quality of Life and Other Fixes

JavidPack: Fix error causing "tiles disappeared but still there" issue JavidPack and MacaylaMarvelous81: Greatly improve mod dependencies user experience. Fix dependent mods failing to be disabled when dependency mod fails to load. JavidPack: Fix host and play to correctly use custom save directories Anshroid Nemo: Fix Logitech RGB and G Hub detection Jack Ashmore: Update OneDrive opening logic to open in background JavidPack: Fix misleading install dependencies launch message. Also fix Install Dependencies action getting stuck on download mod progress screen JavidPack: Clarify in logs and mods menu if mod is loading from an active modpack JavidPack: Use mod display name in UIServerModsDifferMessage to reduce confusion JavidPack: Fix issue preventing selected local/frozen modpack saving properly in some situations JavidPack: New button icons for mod sources menu JavidPack: Fix rare issue causing cursor to disappear on some menus JavidPack: Improve error detection and error messages for users currently on v1.1.2 Terraria beta option

API Fixes and Changes

JavidPack: ModTile/GlobalTile.CanPlace functionality restored JavidPack: Add warning when attempting to publish a mod with the same name as an existing mod JavidPack: Fix LoaderUtils.MustOverrideTogether error messages to display method name again

Other

ExampleMod and API Documentation

James: Fix ExampleMusicBoxTile not emitting note particles JavidPack: Add example of spawning ore when boss is first defeated direwolf420: Fix minion boss loot order JavidPack: Fix some ExampleMod tiles with inconsistent preview/place horizontal flip MrQuba: Clarify CanEquipAccessory and CanAccessoryBeEquippedWith docs JavidPack: Document various coordinate conversion and geometry methods JavidPack: Document Lighting.GetColor methods JavidPack: Document StructureMap and GeneralPlacementTiles

Localization

Rijam: Localized MagicSummonHybrid damage class RazzSG: Russian

It is time for the May 2024 Stable Update. The tModLoader team and our amazing community of contributors continues to improve tModLoader. This month we've fixed a few crash conditions when using a large amount of mods, made some improvements to mod loading time, and made a major upgrade from using Dotnet 6 to Dotnet 8 for increased performance and capability. Mod makers can look forward to the new features of C# 12 and Dotnet 8. 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.

New Changes' Highlights

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.

New Features

API Changes

Mirsario: Port tModLoader from .NET 6 to .NET 8 Mirsario: Refactored mod creation to use a file tree of templates BasicallyIAmFox: Publicizes PlayerEyeHelper members

Bug Fixes

Gameplay Fixes

Rijam: Fix Splash Sound for Shimmer JavidPack: Fix Gun Aim Alignment issue Leon Gies: Fixed AltGr not working in chat. Special characters can now be typed in chat for many non-English users

Quality of Life and Other Fixes

JavidPack: Fix server kick when reloading mods takes more than 2 minutes Chicken-Bones: JIT mods in parallel on the thread pool to speed up mod loading lhzlhz419: Fix typo causing tModLoader crash with Vulkan on Mac JavidPack: Track and report lost player/world save data, will help identify mods causing lost data NexusXe: Fix docker permission denied issue JavidPack: Fix ShowWhatsNew feature, also fixes issue causing other notifications to not be shown Golfing7: Minor performance improvement LoaderManager.Get JavidPack: Improve world select menu performance JavidPack: Fix open csproj button, fix forward slashes in save path on windows causing some issues JavidPack: Provide better error messages for users currently on Terraria Undeluxe Edition beta Mirsario: Fixed an OverflowException thrown in case of >4GB texture memory usage. JavidPack: Add link to more suggestions for workshop issues

API Fixes and Changes

BasicallyIAmFox: Moved `BestiaryFilledPercent` in `Conditions` type JavidPack: Fix GetHealLife/Mana not being applied to tooltips as well as CanUseItem not being checked for mana potions. JavidPack: Use HelpLink from InnerExceptions of MultipleException

Other

ExampleMod and API Documentation

JavidPack: Docs for Request and expert/master mode confusion JavidPack: Document autoloading logic JavidPack: Document AutoloadEquipAttribute, message for autoloaded equip texture missing JavidPack: Document ChatHelper methods JavidPack: Additional CanChooseAmmo example JavidPack: Apply research sorting to examplemod JavidPack: Clarify GetFileBytes docs JavidPack: Player.GetItem docs JavidPack: ExtractinatorUse docs update JavidPack: NetMessage.SendTileSquare docs

Localization

JavidPack: Fix InfoDisplay and DamageClass not populating localization files

It is time for the April Fools 2024 Stable Update. The tModLoader team and our amazing community of contributors continues to improve tModLoader. This month we've fixed several issues, the most impactful being the issue with corrupted config.json files preventing the game from loading for some users. We hope this fix allows users experiencing this issue to continue playing tModLoader. Notably, the mod loading and syncing logic has been reworked in this month's release. Users will see a new menu when joining a multiplayer server if mods need to be reloaded, explaining which mods will be downloaded, enabled, or disabled. The new menu can be seen in the image below. {STEAM_CLAN_IMAGE}/37627134/3afa6d272c6761a4641638277cb114de589f102f.png As well, mod loading speed has been improved by roughly 10%. We expect to see faster mod loading times and more consistent syncing of mods in multiplayer. We would like to encourage modders to read the new Assets wiki page and apply the contained guidelines to their mods. We have noticed that many mods are incorrectly using the Asset system, leading to slow mod loading as a result. 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.

New Changes' Highlights

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.

New Features

API Changes

Chicken-Bones, JavidPack: Massive rework to mod version selection and multiplayer mod syncing user experience Ishigh1, JavidPack: Edit ModConfig directly on server console before loading world Brian Hansen, JavidPack: Modded Sand and Sandgun support, ExampleSandBlock Cyrilly: Add more features to BuilderToggle API JavidPack: Mod.DisplayNameClean added for situations where DisplayName chat tags are not desired BasicallyIAmFox: Added Main.ActiveNPCs/Projectiles/Players/Items iterators to write more convenient code for correctly iterating over active entities

Bug Fixes

Gameplay Fixes

JavidPack: Fix shop sell back price issue JavidPack: Restore full shop sell behavior direwolf420: Fix celebrationmk10 treasure bag item issue

Quality of Life and Other Fixes

JavidPack: Prevent config.json corruption and workaround existing corruption JavidPack: Fix malformed language packs preventing game launch Johannes Grimm, JavidPack: Improved handling of world save and load errors Mirsario: Fix incorrect date handling and other logging issues JavidPack: Item/NPC/Projectile/NPCDefinition config elements are now more responsive Chicken-Bones: Improve speed of AssetRequestMode.ImmediateLoad during mod loading Johannes Grimm: Allow Journeys End menu to persist on restart Johannes Grimm: Fix sorting of searched mods in download mods menu JavidPack: Prevent EnableAll/Doubleclick from enabling mod requiring update

API Fixes and Changes

Mirsario: Allow .hjson files to be used for non-localization purposes R.Phoenix: Fix fishing line drawing issue when using bobbers, ModifyFishingLine moved from ModProjectile to ModItem Chicken-Bones: Add Asset constructors to ShaderData for easier async asset usage Chicken-Bones: Warn when mods spend a long time blocking on asset loading Chicken-Bones: Report total mod load time in logs Chicken-Bones, JavidPack: Zip library updated from Ionic.Zip.Reduced v1.9.1.8 to DotNetZip v1.16.0 Solxan: Continuous Integration work Chicken-Bones: Add new MethodOverrideQuery for faster HasOverride checks Chicken-Bones: Remove IIndexed constraint from IEntityWithInstances so that HookList can be used more generally (#4088) Chicken-Bones: Remove unnecessary computation in Cloning when not needed Chicken-Bones: Improve usability of method reference override queries by allowing the delegate type to be unspecified Johannes Grimm: Fix tModLoader test code JavidPack: Fix #4132 - Server Map Bug

Other

ExampleMod and API Documentation

JavidPack: ExampleMod updated according to Asset wiki page guidelines JavidPack: Closed door randomization feature documentation JavidPack: Chain item drop method documentation Chicken-Bones: Improve documentation on ModContent.Request JavidPack: Fix ExampleCampfire nearby logic JavidPack: Added an example of adding a shop item after a modded boss is defeated

Localization

Johannes Grimm: German RazzSG: Russian, more Tomasz: Polish lace-wing: Chinese Pixelnando: Brazilian Portuguese

It is time for the March 2024 Stable Update! The tModLoader team and our amazing community of contributors continues to improve tModLoader. This month's release mainly contains bug fixes. This month we've continued our work to harden multiplayer by updating the server host scripts, made several improvements to Mod Config support, and fixed a dozen or so bugs. 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.

Important Feature in Preview

This month we will be testing a major rework of how mods are loaded and synced on the preview-v2024.02 beta branch. When joining a server, a new menu will inform the user about pending mod downloads and config changes. Modders should read the How does this affect modders? section of the pull request. Users will be happy to know that local mods will no longer override workshop mods, reducing potential errors from loading outdated mods significantly. The new UI will greatly help users avoid lengthy mod reloads in multiplayer. See this video to see the new UI in action. We hope to perfect this user experience in anticipation for next months release.

New Changes' Highlights

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.

New Features

API Changes

Destructor_Ben: Description Parameter Interpolation Destructor_Ben: Added TileDefinition class direwolf420: Added Player.hasGemRobe

Bug Fixes

Quality of Life and Other Fixes

John Baglio: Implement Caching for Mod.GetContent() Results turtletowerz: Docker and Management Script Bugfixes JavidPack: -skipselect now works on server launches JavidPack: Additional ControlledFolderAccessDetected logging JavidPack: Fix issue causing the workshop menu to display improperly JavidPack: Fix WaspNest accessory not resetting properly Chicken-Bones: Remove redundant and erroneous PPID reassignment in launch script Solxan: Fix Author Search in Mod Browser JavidPack: Add log message to indicate which mod's config is triggering reload in MP join Chicken-Bones: Fix a missing load time performance optimization when building global hook lists. JavidPack: Clarify serverconfig.txt being automatic default JavidPack: Fix Display Issue for Sonar Buff and pickup counts when fishing with multiple lures JavidPack: Fix Mods Not Loading for some GOG users

API Fixes and Changes

Chicken-Bones: Update MonoMod JavidPack: Added HitModifiers.DisableKnockback to fix Flat modifier applying to knockBackResist==0 NPC JavidPack: Fix issue with ModProjectile.CooldownSlot not working correctly. JavidPack: Language workshop tags will persist with some leniency. Michael Scott: Fix modded toilets not granting fishing bonus Destructor_Ben: Config List UI fixes JavidPack: Fix sorting in Mod Config List menu JavidPack: Show class name in GetLoadableTypesException when inheriting JavidPack: Fix some errors being attributed to System.RuntimeType JavidPack: Clarify AddMusicBox Errors

ExampleMod & API Documentation

JavidPack: WorldGen Documentation JavidPack: Tile and other Documentation JavidPack: Fix FewFromRulesRule ctor typo (chanceDenominator) Clay Sweetser: Minor punctuation changes JavidPack: Update Projectile.noDropItem documentation for 1.4 changes JavidPack: Update various life regen and related hook documentation Destructor_Ben: Add docs to ModTile.MineResist and ModTile.MinPick

It is time for the February 2024 Stable Update! The tModLoader team and our amazing community of contributors continues to improve tModLoader. This month's release mainly contains bug fixes. This month we've improved support for our Apple Silicon friends, improved GoG compatibility & setup on Unix, and added compatibility for a wider array of language packs. 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.

New Changes' Highlights

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.

New Features

API Changes

Chicken-Bones: Check outer types for PreJITFilter attributes and improve error messages (#4033) ThomasThePencil: GlobalNPC.SetDefaultsFromNetId (#3955)

Bug Fixes

Quality of Life and Other Fixes

JavidPack: Fix exception causing UI issue when publishing new mod Chicken-Bones: Automatically switch to x86 architecture when Rosetta is present (#4017) JavidPack: Added fallbacks for assumed GOG default paths, Fix #3526 (#4018) -Cyril-: Fix language packs don't work issue (#2617) Mirsario: Prevent Recalculate spam with ModMenu.UserInterface. Mirsario: Fixed #4007 (Delete Mod modal is bugged) -Cyril-: Qualify the dotnet path of created mod to solve error on editors such as Rider (#3944)

API Fixes and Changes

Chicken-Bones: Make type 0 entities inactive in SetDefaults and TurnToAir (#4032)

ExampleMod & API Documentation

Mirsario: Fixed NuGet lib folder casing (#3965 patch ) Mirsario: Reimplemented custom Terraria.csproj logic using C# MSBuild Tasks, fixed ".Remove(-1)". (#3965) Mirsario: Added a test for ResetStaticMembers.