December 2024 Stable Update
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.
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
[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
Bug Fixes
[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
Other
[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.