1. tModLoader
  2. News

tModLoader News

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.

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.

November 2024 Stable Update

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

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.

One feature we are currently previewing is additional support for modded tiles that react to wind and player movement, as some vanilla tiles do. Modders on the preview branch can test it out and make sure it works correctly for chandeliers, banners, vines, and other similar tiles.

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]API Changes[/h2]
Destructor_Ben: Add hooks for armor set bonus activation (ModPlayer.ArmorSetBonusHeld and ArmorSetBonusActivated)

Bug Fixes

[h2]Quality of Life and Other Fixes[/h2]
JavidPack: Fix money exploit when stacking items sold for shopCustomPrice JavidPack: Fix hard server crash when loading completely broken world file. JavidPack: Update serverconfig.txt instructions

[h2]API Fixes and Changes[/h2]
JavidPack: Custom error message for attempting to build in Visual Studio while tModLoader has the .tmod file open Solxan: Fix and maintain automatic release systems

Other

[h2]ExampleMod and API Documentation[/h2]
JavidPack: Added CustomItemDrawingShowcase, fixed ItemDefinition Pre/PostDrawInInventory usage, documentation JavidPack: Fix ExampleCoinsUI odd drag behavior, related UIElement documentation JavidPack: Add fruit texture to ExampleCactus JavidPack: Clarify ExampleGun code JavidPack: Various Documentation Updates: 1, 2, 3

[h2]Localization[/h2]
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.

October 2024 Stable Update

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.

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

Bug Fixes

[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

Other

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

September 2024 Stable Update

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.

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

Bug Fixes

[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

Other

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

August 2024 Stable Update

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.

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

Bug Fixes

[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

Other

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