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

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

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

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

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

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

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

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

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

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

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

Fish: Chinese 1[github.com], 2[github.com]
RazzSG: Russian[github.com]

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

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

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

It is time for the June 2025 Stable Update.

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

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

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

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

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

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

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

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

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

JavidPack: Various Documentation Updates: 1[github.com], 2[github.com], 3[github.com]

RazzSG: Russian[github.com]
Silencersn: Chinese[github.com]

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[github.com] or reach out to us at our Discord[discord.com].

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

JavidPack: Custom and Named ID Sets ("content tags"). Mods can now create their own "Sets" and collaborate easily using them.[github.com]
IbanPlay: https://github.com/tModLoader/tModLoader/pull/4566
JavidPack: Basic tile entity example and many more new helper methods to make working with tiles and tile entities easier[github.com]
JavidPack: ExampleChandelier and several new related ModTile hooks. Swaying tiles are now customizable.[github.com]

Jacob Adams: ModMapLayer positioning can now be customized[github.com]
JavidPack: Added NPCID.Sets.DoesntDespawnToInactivityAndCountsNPCSlots[github.com]

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

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

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

Fish: Chinese[github.com]
RazzSG: Russian[github.com]

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[github.com] or reach out to us at our Discord[discord.com].

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

JavidPack: TileCounterType.CustomSolid/NonSolid support for AddSpecialDraw, fix blurry example relic tile visuals[github.com]
JavidPack: Added TileID.Sets.NegatesFallDamage for tiles like cloud that prevent fall damage[github.com]
JavidPack: Localize custom player death messages (PlayerDeathReason.ByCustomReason)[github.com]

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

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

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

RazzSG: Russian[github.com]

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[github.com] or reach out to us at our Discord[discord.com].

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

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

Kogsey: Minor Decraft Fixes[github.com]
Narnia: Added ModCommand IsCaseSensitive property[github.com]

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.[github.com]
JavidPack: Fix critter spawn location while in reverse gravity[github.com]
James Puleo: Fix network lag caused by Shimmer buff[github.com]
James Puleo: Fix Skeletron Prime's Laser Arm not shooting lasers as often as expected in Multiplayer[github.com]
JavidPack: Add status text for "Backing up player file" to help diagnose player saving issues[github.com]
Alice H.: More robust Bash launch script code[github.com]

JavidPack: Fix various ProjectileLoader/NPCLoader.ReceiveExtraAI exception messages, optimize message size, and reorder modded and global bytes in message[github.com]
James Puleo: Fix `PlayerDisconnect` hook being called with bogus player[github.com]
JavidPack: Fix potential infinite loop with angler quests[github.com]
JavidPack: https://github.com/tModLoader/tModLoader/commit/6497b9d8c8b564695b9a5b584522184f5677ecf4
JavidPack: Silence "BadImageFormatException: Read out of bounds"-errors in exception logging.[github.com]
Chicken-Bones: Fix line numbers in first chance exceptions[github.com]
Silencersn: Fix an incorrect banner log warning[github.com]

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

RazzSG: Russian[github.com]

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[github.com] or reach out to us at our Discord[discord.com].

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

tomat: Speed up start-up times by postponing .tmod file hash verification[github.com]

Michael Scott: Fix UpdatePlayerLuckFactors network message[github.com]

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

Tomasz: Polish[github.com]
Pixelnando: Brazilian Portuguese[github.com]

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[github.com] or reach out to us at our Discord[discord.com].

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

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

JavidPack: More BitsByte helper methods for reading and writing data[github.com]
JavidPack: Made GrowMoreVines and nearbyChlorophyte methods public[github.com]

N/A

N/A

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

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[github.com] or reach out to us at our Discord[discord.com].

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

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

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

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

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

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

Fish: Chinese[github.com]
RazzSG: Russian[github.com]

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[github.com] or reach out to us at our Discord[discord.com].

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

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

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

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

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

RazzSG: Russian[github.com]

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.