April 2024 Stable Update
It is time for the April Fools 2024 Stable Update.
The tModLoader team and our amazing community of contributors continues to improve tModLoader.
This month we've fixed several issues, the most impactful being the issue with corrupted config.json files preventing the game from loading for some users. We hope this fix allows users experiencing this issue to continue playing tModLoader.
Notably, the mod loading and syncing logic has been reworked in this month's release. Users will see a new menu when joining a multiplayer server if mods need to be reloaded, explaining which mods will be downloaded, enabled, or disabled.
The new menu can be seen in the image below.
As well, mod loading speed has been improved by roughly 10%. We expect to see faster mod loading times and more consistent syncing of mods in multiplayer.
We would like to encourage modders to read the new Assets wiki page and apply the contained guidelines to their mods. We have noticed that many mods are incorrectly using the Asset system, leading to slow mod loading as a result.
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]
Chicken-Bones, JavidPack: Massive rework to mod version selection and multiplayer mod syncing user experience Ishigh1, JavidPack: Edit ModConfig directly on server console before loading world Brian Hansen, JavidPack: Modded Sand and Sandgun support, ExampleSandBlock Cyrilly: Add more features to BuilderToggle API JavidPack: Mod.DisplayNameClean added for situations where DisplayName chat tags are not desired BasicallyIAmFox: Added Main.ActiveNPCs/Projectiles/Players/Items iterators to write more convenient code for correctly iterating over active entities
[h2]Gameplay Fixes[/h2]
JavidPack: Fix shop sell back price issue JavidPack: Restore full shop sell behavior direwolf420: Fix celebrationmk10 treasure bag item issue
[h2]Quality of Life and Other Fixes[/h2]
JavidPack: Prevent config.json corruption and workaround existing corruption JavidPack: Fix malformed language packs preventing game launch Johannes Grimm, JavidPack: Improved handling of world save and load errors Mirsario: Fix incorrect date handling and other logging issues JavidPack: Item/NPC/Projectile/NPCDefinition config elements are now more responsive Chicken-Bones: Improve speed of AssetRequestMode.ImmediateLoad during mod loading Johannes Grimm: Allow Journeys End menu to persist on restart Johannes Grimm: Fix sorting of searched mods in download mods menu JavidPack: Prevent EnableAll/Doubleclick from enabling mod requiring update
[h2]API Fixes and Changes[/h2]
Mirsario: Allow .hjson files to be used for non-localization purposes R.Phoenix: Fix fishing line drawing issue when using bobbers, ModifyFishingLine moved from ModProjectile to ModItem Chicken-Bones: Add Asset constructors to ShaderData for easier async asset usage Chicken-Bones: Warn when mods spend a long time blocking on asset loading Chicken-Bones: Report total mod load time in logs Chicken-Bones, JavidPack: Zip library updated from Ionic.Zip.Reduced v1.9.1.8 to DotNetZip v1.16.0 Solxan: Continuous Integration work Chicken-Bones: Add new MethodOverrideQuery for faster HasOverride checks Chicken-Bones: Remove IIndexed constraint from IEntityWithInstances so that HookList can be used more generally (#4088) Chicken-Bones: Remove unnecessary computation in Cloning when not needed Chicken-Bones: Improve usability of method reference override queries by allowing the delegate type to be unspecified Johannes Grimm: Fix tModLoader test code JavidPack: Fix #4132 - Server Map Bug
[h2]ExampleMod and API Documentation[/h2]
JavidPack: ExampleMod updated according to Asset wiki page guidelines JavidPack: Closed door randomization feature documentation JavidPack: Chain item drop method documentation Chicken-Bones: Improve documentation on ModContent.Request JavidPack: Fix ExampleCampfire nearby logic JavidPack: Added an example of adding a shop item after a modded boss is defeated
[h2]Localization[/h2]
Johannes Grimm: German RazzSG: Russian, more Tomasz: Polish lace-wing: Chinese Pixelnando: Brazilian Portuguese
The tModLoader team and our amazing community of contributors continues to improve tModLoader.
This month we've fixed several issues, the most impactful being the issue with corrupted config.json files preventing the game from loading for some users. We hope this fix allows users experiencing this issue to continue playing tModLoader.
Notably, the mod loading and syncing logic has been reworked in this month's release. Users will see a new menu when joining a multiplayer server if mods need to be reloaded, explaining which mods will be downloaded, enabled, or disabled.
The new menu can be seen in the image below.
As well, mod loading speed has been improved by roughly 10%. We expect to see faster mod loading times and more consistent syncing of mods in multiplayer.
We would like to encourage modders to read the new Assets wiki page and apply the contained guidelines to their mods. We have noticed that many mods are incorrectly using the Asset system, leading to slow mod loading as a result.
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.
New Changes' Highlights
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.
New Features
[h2]API Changes[/h2]
Chicken-Bones, JavidPack: Massive rework to mod version selection and multiplayer mod syncing user experience Ishigh1, JavidPack: Edit ModConfig directly on server console before loading world Brian Hansen, JavidPack: Modded Sand and Sandgun support, ExampleSandBlock Cyrilly: Add more features to BuilderToggle API JavidPack: Mod.DisplayNameClean added for situations where DisplayName chat tags are not desired BasicallyIAmFox: Added Main.ActiveNPCs/Projectiles/Players/Items iterators to write more convenient code for correctly iterating over active entities
Bug Fixes
[h2]Gameplay Fixes[/h2]
JavidPack: Fix shop sell back price issue JavidPack: Restore full shop sell behavior direwolf420: Fix celebrationmk10 treasure bag item issue
[h2]Quality of Life and Other Fixes[/h2]
JavidPack: Prevent config.json corruption and workaround existing corruption JavidPack: Fix malformed language packs preventing game launch Johannes Grimm, JavidPack: Improved handling of world save and load errors Mirsario: Fix incorrect date handling and other logging issues JavidPack: Item/NPC/Projectile/NPCDefinition config elements are now more responsive Chicken-Bones: Improve speed of AssetRequestMode.ImmediateLoad during mod loading Johannes Grimm: Allow Journeys End menu to persist on restart Johannes Grimm: Fix sorting of searched mods in download mods menu JavidPack: Prevent EnableAll/Doubleclick from enabling mod requiring update
[h2]API Fixes and Changes[/h2]
Mirsario: Allow .hjson files to be used for non-localization purposes R.Phoenix: Fix fishing line drawing issue when using bobbers, ModifyFishingLine moved from ModProjectile to ModItem Chicken-Bones: Add Asset constructors to ShaderData for easier async asset usage Chicken-Bones: Warn when mods spend a long time blocking on asset loading Chicken-Bones: Report total mod load time in logs Chicken-Bones, JavidPack: Zip library updated from Ionic.Zip.Reduced v1.9.1.8 to DotNetZip v1.16.0 Solxan: Continuous Integration work Chicken-Bones: Add new MethodOverrideQuery for faster HasOverride checks Chicken-Bones: Remove IIndexed constraint from IEntityWithInstances so that HookList can be used more generally (#4088) Chicken-Bones: Remove unnecessary computation in Cloning when not needed Chicken-Bones: Improve usability of method reference override queries by allowing the delegate type to be unspecified Johannes Grimm: Fix tModLoader test code JavidPack: Fix #4132 - Server Map Bug
Other
[h2]ExampleMod and API Documentation[/h2]
JavidPack: ExampleMod updated according to Asset wiki page guidelines JavidPack: Closed door randomization feature documentation JavidPack: Chain item drop method documentation Chicken-Bones: Improve documentation on ModContent.Request JavidPack: Fix ExampleCampfire nearby logic JavidPack: Added an example of adding a shop item after a modded boss is defeated
[h2]Localization[/h2]
Johannes Grimm: German RazzSG: Russian, more Tomasz: Polish lace-wing: Chinese Pixelnando: Brazilian Portuguese