tModLoader News

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.


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.


[h2]New Features[/h2]
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

[h2]API Changes[/h2]
Kogsey: Minor Decraft Fixes Narnia: Added ModCommand IsCaseSensitive property


[h2]Quality of Life and Other Fixes[/h2]
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

[h2]API Fixes and Changes[/h2]
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


[h2]ExampleMod and API Documentation[/h2]
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

[h2]Localization[/h2]
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.


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.


[h2]New Features[/h2]
tomat: Speed up start-up times by postponing .tmod file hash verification


[h2]Quality of Life and Other Fixes[/h2]
Michael Scott: Fix UpdatePlayerLuckFactors network message

[h2]API Fixes and Changes[/h2]
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


[h2]Localization[/h2]
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.


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.


[h2]New Features[/h2]
JavidPack: Greatly improved enemy banner support (ModBannerTile) and ExampleMod example (EnemyBanner.cs) MutantWafflez: Bestiary info element categorization control

[h2]API Changes[/h2]
JavidPack: More BitsByte helper methods for reading and writing data JavidPack: Made GrowMoreVines and nearbyChlorophyte methods public


[h2]Quality of Life and Other Fixes[/h2]
N/A

[h2]API Fixes and Changes[/h2]
N/A


[h2]ExampleMod and API Documentation[/h2]
Silencersn: Added ExampleSandRod JavidPack: Add example of storing Item instance for accessory effect to WaspNest JavidPack: Multiple additions to API documentation: 1, 2

[h2]Localization[/h2]
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.


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.


[h2]New Features[/h2]
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

[h2]API Changes[/h2]
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


[h2]Quality of Life and Other Fixes[/h2]
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

[h2]API Fixes and Changes[/h2]
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


[h2]ExampleMod and API Documentation[/h2]
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

[h2]Localization[/h2]
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.


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.


[h2]API Changes[/h2]
Destructor_Ben: Add hooks for armor set bonus activation (ModPlayer.ArmorSetBonusHeld and ArmorSetBonusActivated)


[h2]Quality of Life and Other Fixes[/h2]
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

[h2]API Fixes and Changes[/h2]
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


[h2]ExampleMod and API Documentation[/h2]
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

[h2]Localization[/h2]
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.