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
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.