tModLoader News

It is time for the October 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.

One major contribution we'd like to highlight this month is work by alueck that enables Mac and Linux users to contribute directly to tModLoader. If you are a Mac or Linux user and have been wanting to contribute a new feature to tModLoader, it should now be possible and we are willing to help on Discord if you run into any roadblocks.

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]
Tyfyter: Multiple prefix category support alueck and Chicken-Bones: New CLI for tModLoader project, allowing contributing features to tModLoader by Mac and Linux modders

[h2]API Changes[/h2]
IbanPlay: Added PostTileFrame and ModifyFrameMerge hooks for ModTile


[h2]Quality of Life and Other Fixes[/h2]
JavidPack: Fix GOG Workshop regression (Hotfix) Tyfyter: Preserve prefixes on unloaded items and for unloaded prefixes Adrian Lück: Fix item variants not being shown in NPC shops Johannes Grimm: Increase maximum supported length of chest names JavidPack: Fix Terraformer using more ammo than intended Johannes Grimm: Added confirmation dialog to toggle all mods buttons JavidPack: Fix InfoDisplay not displaying in some situations JavidPack: Added checks, filtering, and logging for local mods with non-standard filenames. Fixes issue with multiple local copies of mods JavidPack: Fix issue with deleting active modpack JavidPack: Better detection of GOG+Linux Terraria.exe location JavidPack: Ability to search mods by steamid64 JavidPack: Fix secret seeds spamming logs with world gen messages JavidPack: Log which native dll is throwing a native exception for troubleshooting JavidPack: Add logging to help determine if a crash is caused by initializing game controllers

[h2]API Fixes and Changes[/h2]
Solxan: Fixed Non-Public Mod Publishing (Hotfix) JavidPack: Fix ObjectElement ignoring ShowDespiteJsonIgnoreAttribute


[h2]ExampleMod and API Documentation[/h2]
JavidPack: TownNPCRespawnSystem, example of free TownNPC respawn feature JavidPack: Updated ExamplePylon shop entry example JavidPack: Various Documentation Updates: 1, 2, 3, 4

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

It is time for the September 2024 Stable Update.

The tModLoader team and our amazing community of contributors continues to improve tModLoader.

This month's release contains many improvements to the user experience, various bug fixes, as well as new features with examples and documentation for mod makers.

One new feature we want to showcase in particular is in-game workshop tag filtering. We hope this new filter will help users find the mods they want more easily in-game. We expect this feature to especially help users find mods that support their native language.



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]
JavidPack: Added workshop tag filtering in Mod Browser JavidPack: Add page up and page down support to Mods and Mod Browser menus Wojciech Nawa: Add podman support for dedicated servers

[h2]API Changes[/h2]
direwolf420: Add ProjectileID.Sets.FiresFewerFromDaedalusStormbow


[h2]Quality of Life and Other Fixes[/h2]
JavidPack: Fix version upgrade hints to more reliably detect and inform when a mod is preview only JavidPack: Fix language=languageCode server config file option JavidPack: Fix WorldGen passes staying disabled instead of resetting JavidPack: Added checks, filtering, and logging for local mods with non-standard filenames

[h2]API Fixes and Changes[/h2]
JavidPack: Fix several TileObjectData issues and document TileObjectData class JavidPack: Fix Item.ArmorPenetration not properly resetting JavidPack: Fix BuffLoader.Update not being called for some vanilla buffs Chicken-Bones: Fix serialization of arrays in TagCompound JavidPack: Document Main.dayTime and related. Fix incorrect entries in SortingPriorityBossSpawns JavidPack: Update MonoMod to 25.1.1 to fix missing MonoMod documentation JavidPack: Fix documentation references for nuget packages JavidPack: Fix ModConfig members declared as Object crashing


[h2]ExampleMod and API Documentation[/h2]
direwolf420: Fix ExampleChest consuming key when other conditions are not met JavidPack: Update ExampleHomingProjectile and document related fields and methods JavidPack: StatModifier Documentation Mirsario: Updated outdated (Mod|Global)X summaries JavidPack: Document ModMount texture autoloading uniqueness JavidPack: Document JIT related attributes/annotations

[h2]Localization[/h2]
RazzSG: Russian

We would also like to mention that we have volunteers translating our monthly release announcements into Chinese, Russian, and Brazilian Portuguese. If you would like to help translate these announcements into another supported language, please reach out on Discord.

It is time for the August 2024 Stable Update.

The tModLoader team and our amazing community of contributors continues to improve tModLoader.

This month's release contains many improvements to the user experience, various bug fixes, as well as new features with examples and documentation for mod makers.

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]
JavidPack: Add Recently Published sort, Time Period sort, and update Hot sort to the workshop menu. Better workshop user experience JavidPack: Memory tracking feature reworked and added back to mods menu

[h2]API Changes[/h2]
Rijam: Example Rockets and explosive projectile fixes and features Rijam: Added support for modifying Petting, Chat Bubble, Party Hat, and Emote Bubble positions. Added ExampleTownPet and License example JavidPack: UseItem will now be called during QuickHeal and QuickMana JavidPack: Added ExampleFlask and EmitEnchantmentVisualsAt hook. Weapon imbue visuals can now support projectiles properly JavidPack: NPCID.Sets.NeverDropsResourcePickups added and MinionBossMinion now showcases guaranteed heart drops JavidPack: Player.MeleeEnchantActive helper property added


[h2]Quality of Life and Other Fixes[/h2]
JavidPack: Config list UI will now show all mods to reduce user confusion JavidPack: Improve performance of player select menu and visual consistency of other menus JavidPack: Fix issue preventing users downloading mods built for a newer build version of tModLoader JavidPack: Mod location icon in mod listing now shows helpful tooltip. Improve visual consistency of other menus JavidPack: Fix mod icon blurry on Mods menu, fix many other icons blurry JavidPack: Error message for Mac users on outdated macOS

[h2]API Fixes and Changes[/h2]
Oliver Heamon: Run expensive tasks in Mod Sources asynchronously JavidPack: Modders accidentally using obsolete LocalizedText.SetDefault will now be shown a helpful custom error message JavidPack: Fix issue preventing pluralized LocalizedText being used in BroadcastChatMessage method JavidPack: Add error message for modders most likely renaming .png textures instead of saving in .png format. JavidPack: Fix errors caused by malformed build.txt files and incorrect 32 bit Linux detection JavidPack: Fix JITException error message sometimes repeating same mod multiple times JavidPack: Add error when it is detected that a recently built mod will not be loaded due to version or modpack priority Solxan: Added 'internal name' to workshop description and other refactors Lacewing: Resprite localization buttons JavidPack: GraniteBiome StructureMap fix and related docs JavidPack: Remove obsolete AllowVanillaClients from code


[h2]ExampleMod and API Documentation[/h2]
Narnia: Added ExampleSign, showcasing sign related methods and tile alternate placements JavidPack: Added ExampleResourcePickup, a resource pickup item example JavidPack: Fix vanilla UIElement class LockVanillaMouseScroll usage and document some UIElement methods JavidPack: Document tooltip drawing methods and others JavidPack: Document TagCompound, secret seeds, etc

[h2]Localization[/h2]
RazzSG: Russian Fish cat cat: Chinese Fish cat cat: More Chinese

We would also like to mention that we have volunteers translating our monthly release announcements into Chinese, Russian, and Brazilian Portuguese. If you would like to help translate these announcements into another supported language, please reach out on Discord.

It is time for the July 2024 Stable Update.

The tModLoader team and our amazing community of contributors continues to improve tModLoader.

This month's release contains many improvements to the user experience, some gameplay bug fixes, as well as new examples and documentation for mod makers.

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]
None this month.


[h2]Gameplay Fixes[/h2]
JavidPack: Fix sellback exploits with shopCustomPrice Solxan: Fix crash caused by duplicated launch arguments JavidPack: Better error message for unsupported 32 bit Windows users Michael Scott: Fix issue with dresser menu by unloading Main.dresserInterfaceDummy correctly JavidPack: Remove ValidModBrowserSignature usage and remove unusable OnlyDownloadSignedModsFromServers config to fix a rare issue with some Linux users Solaestas: Fix issue causing IL edit crashes by clearing ReflectionHelper cache

[h2]Quality of Life and Other Fixes[/h2]
JavidPack: Fix escape key behavior on menus and an input text issue JavidPack: Update Download Mods menu, added backgrounds to tooltips JavidPack: Added icons to indicate client and server configs. Solxan: Remove memory estimates feature temporarily

[h2]API Fixes and Changes[/h2]
Solxan: Added support to publish a mod using the Unlisted visibility option Solxan: Publish mod menu now says "update" when updating an existing mod Solxan: Fix an issue preventing republishing a mod that had been removed from the workshop JavidPack: Fix ModifyActiveShop items parameter, items should not be null Reverted, the original behavior was correct.
Chicken-Bones: Improve FastParallel.For deadlock logging. Add crash dump option for exceptions JavidPack: Improve error messages and behavior for mod sources with invalid versions JavidPack: Add processor count logging Solxan: Add RAM logging


[h2]ExampleMod and API Documentation[/h2]
TacoConKvass: Example Boots and document movement stats JavidPack: Document proper ProjectileID.Sets.DontAttachHideToAlpha usage Blu3: Example Arrow JavidPack: Some more notes about ExampleMod class being a partial class Solxan: Documentation on disabling TerrariaSteamClient if needed Solxan: Preformatted Dotnet Environment Dump Variables in case CTD with no natives.log context. Default Off. Vadim Placinta: Update serverconfig.txt to mention -nosteam option

[h2]Localization[/h2]
Pixelnando: Brazilian Portuguese - Steam page RazzSG: Russian Tomasz: Polish JavidPack: Localize Create Mod menu and some missing ModConfig text

We would also like to mention that we have volunteers translating our monthly release announcements into Chinese, Russian, and Brazilian Portuguese. If you would like to help translate these announcements into another supported language, please reach out on Discord.

It is time for the June 2024 Stable Update.

The tModLoader team and our amazing community of contributors continues to improve tModLoader.

This month we've fixed a few UI issues: some fixes for the ModPacks feature, some UI fixes for multiplayer connections, and a UI fix for Mod Browser / downloading mods.

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]
BasicallyIAmFox: Allow shaders to omit parameters they don't use JackerAcid: ItemID.Sets.DuplicationMenuToolsFilter added to allow categorizing items as tools JavidPack: GoreID.Sets.LiquidDroplet added and ExampleDroplet updated


[h2]Gameplay Fixes[/h2]
JavidPack: Fix Daybreak and Solar Eruption Explosions erroneously delivering critical hits JavidPack: Fix sellback price issue with shop items using shopCustomPrice JavidPack: Fix credits not working sometimes

[h2]Quality of Life and Other Fixes[/h2]
JavidPack: Fix error causing "tiles disappeared but still there" issue JavidPack and MacaylaMarvelous81: Greatly improve mod dependencies user experience. Fix dependent mods failing to be disabled when dependency mod fails to load. JavidPack: Fix host and play to correctly use custom save directories Anshroid Nemo: Fix Logitech RGB and G Hub detection Jack Ashmore: Update OneDrive opening logic to open in background JavidPack: Fix misleading install dependencies launch message. Also fix Install Dependencies action getting stuck on download mod progress screen JavidPack: Clarify in logs and mods menu if mod is loading from an active modpack JavidPack: Use mod display name in UIServerModsDifferMessage to reduce confusion JavidPack: Fix issue preventing selected local/frozen modpack saving properly in some situations JavidPack: New button icons for mod sources menu JavidPack: Fix rare issue causing cursor to disappear on some menus JavidPack: Improve error detection and error messages for users currently on v1.1.2 Terraria beta option

[h2]API Fixes and Changes[/h2]
JavidPack: ModTile/GlobalTile.CanPlace functionality restored JavidPack: Add warning when attempting to publish a mod with the same name as an existing mod JavidPack: Fix LoaderUtils.MustOverrideTogether error messages to display method name again


[h2]ExampleMod and API Documentation[/h2]
James: Fix ExampleMusicBoxTile not emitting note particles JavidPack: Add example of spawning ore when boss is first defeated direwolf420: Fix minion boss loot order JavidPack: Fix some ExampleMod tiles with inconsistent preview/place horizontal flip MrQuba: Clarify CanEquipAccessory and CanAccessoryBeEquippedWith docs JavidPack: Document various coordinate conversion and geometry methods JavidPack: Document Lighting.GetColor methods JavidPack: Document StructureMap and GeneralPlacementTiles

[h2]Localization[/h2]
Rijam: Localized MagicSummonHybrid damage class RazzSG: Russian