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.