It is time for the May 2024 Stable Update.

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

This month we've fixed a few crash conditions when using a large amount of mods, made some improvements to mod loading time, and made a major upgrade from using Dotnet 6 to Dotnet 8 for increased performance and capability.

Mod makers can look forward to the new features of C# 12[learn.microsoft.com] and Dotnet 8[learn.microsoft.com].

As always, if you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub [github.com] or reach out to us at our Discord[discord.com].

The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide[github.com] to see how to adapt to the new changes after running tModPorter.

Mirsario: Port tModLoader from .NET 6 to .NET 8[github.com]
Mirsario: Refactored mod creation to use a file tree of templates[github.com]
BasicallyIAmFox: Publicizes PlayerEyeHelper members[github.com]


Rijam: Fix Splash Sound for Shimmer[github.com]
JavidPack: Fix Gun Aim Alignment issue[github.com]
Leon Gies: Fixed AltGr not working in chat. Special characters can now be typed in chat for many non-English users[github.com]

JavidPack: Fix server kick when reloading mods takes more than 2 minutes[github.com]
Chicken-Bones: JIT mods in parallel on the thread pool to speed up mod loading[github.com]
lhzlhz419: Fix typo causing tModLoader crash with Vulkan on Mac[github.com]
JavidPack: Track and report lost player/world save data, will help identify mods causing lost data[github.com]
NexusXe: Fix docker permission denied issue[github.com]
JavidPack: Fix ShowWhatsNew feature, also fixes issue causing other notifications to not be shown[github.com]
Golfing7: https://github.com/tModLoader/tModLoader/pull/4101
JavidPack: Improve world select menu performance[github.com]
JavidPack: Fix open csproj button, fix forward slashes in save path on windows causing some issues[github.com]
JavidPack: Provide better error messages for users currently on Terraria Undeluxe Edition beta[github.com]
Mirsario: Fixed an OverflowException thrown in case of >4GB texture memory usage.[github.com]
JavidPack: Add link to more suggestions for workshop issues[github.com]

BasicallyIAmFox: Moved `BestiaryFilledPercent` in `Conditions` type[github.com]
JavidPack: Fix GetHealLife/Mana not being applied to tooltips as well as CanUseItem not being checked for mana potions.[github.com]
JavidPack: Use HelpLink from InnerExceptions of MultipleException[github.com]

JavidPack: Docs for Request and expert/master mode confusion[github.com]
JavidPack: Document autoloading logic[github.com]
JavidPack: Document AutoloadEquipAttribute, message for autoloaded equip texture missing[github.com]
JavidPack: Document ChatHelper methods[github.com]
JavidPack: Additional CanChooseAmmo example[github.com]
JavidPack: Apply research sorting to examplemod[github.com]
JavidPack: Clarify GetFileBytes docs[github.com]
JavidPack: Player.GetItem docs[github.com]
JavidPack: ExtractinatorUse docs update[github.com]
JavidPack: NetMessage.SendTileSquare docs[github.com]

JavidPack: Fix InfoDisplay and DamageClass not populating localization files[github.com]

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[github.com] 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 [github.com] or reach out to us at our Discord[discord.com].

The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide[github.com] to see how to adapt to the new changes after running tModPorter.

Chicken-Bones, JavidPack: Massive rework to mod version selection and multiplayer mod syncing user experience[github.com]
Ishigh1, JavidPack: Edit ModConfig directly on server console before loading world[github.com]
Brian Hansen, JavidPack: Modded Sand and Sandgun support, ExampleSandBlock[github.com]
Cyrilly: Add more features to BuilderToggle API[github.com]
JavidPack: Mod.DisplayNameClean added for situations where DisplayName chat tags are not desired[github.com]
BasicallyIAmFox: Added Main.ActiveNPCs/Projectiles/Players/Items iterators to write more convenient code for correctly iterating over active entities[github.com]

JavidPack: Fix shop sell back price issue[github.com]
JavidPack: Restore full shop sell behavior[github.com]
direwolf420: Fix celebrationmk10 treasure bag item issue[github.com]

JavidPack: Prevent config.json corruption and workaround existing corruption[github.com]
JavidPack: Fix malformed language packs preventing game launch[github.com]
Johannes Grimm, JavidPack: Improved handling of world save and load errors[github.com]
Mirsario: Fix incorrect date handling and other logging issues[github.com]
JavidPack: Item/NPC/Projectile/NPCDefinition config elements are now more responsive[github.com]
Chicken-Bones: Improve speed of AssetRequestMode.ImmediateLoad during mod loading[github.com]
Johannes Grimm: Allow Journeys End menu to persist on restart[github.com]
Johannes Grimm: Fix sorting of searched mods in download mods menu[github.com]
JavidPack: Prevent EnableAll/Doubleclick from enabling mod requiring update[github.com]

Mirsario: Allow .hjson files to be used for non-localization purposes[github.com]
R.Phoenix: Fix fishing line drawing issue when using bobbers, ModifyFishingLine moved from ModProjectile to ModItem[github.com]
Chicken-Bones: Add Asset<Effect> constructors to ShaderData for easier async asset usage[github.com]
Chicken-Bones: Warn when mods spend a long time blocking on asset loading[github.com]
Chicken-Bones: Report total mod load time in logs[github.com]
Chicken-Bones, JavidPack: Zip library updated from Ionic.Zip.Reduced v1.9.1.8 to DotNetZip v1.16.0[github.com]
Solxan: Continuous Integration work[github.com]
Chicken-Bones: Add new MethodOverrideQuery for faster HasOverride checks[github.com]
Chicken-Bones: Remove IIndexed constraint from IEntityWithInstances so that HookList can be used more generally (#4088)[github.com]
Chicken-Bones: Remove unnecessary computation in Cloning when not needed[github.com]
Chicken-Bones: Improve usability of method reference override queries by allowing the delegate type to be unspecified[github.com]
Johannes Grimm: Fix tModLoader test code[github.com]
JavidPack: Fix #4132 - Server Map Bug[github.com]

JavidPack: ExampleMod updated according to Asset wiki page guidelines[github.com]
JavidPack: Closed door randomization feature documentation[github.com]
JavidPack: Chain item drop method documentation[github.com]
Chicken-Bones: Improve documentation on ModContent.Request[github.com]
JavidPack: Fix ExampleCampfire nearby logic[github.com]
JavidPack: Added an example of adding a shop item after a modded boss is defeated[github.com]

Johannes Grimm: German[github.com]
RazzSG: Russian[github.com], more[github.com]
Tomasz: Polish[github.com]
lace-wing: Chinese[github.com]
Pixelnando: Brazilian Portuguese[github.com]

It is time for the March 2024 Stable Update!

The tModLoader team and our amazing community of contributors continues to improve tModLoader. This month's release mainly contains bug fixes.

This month we've continued our work to harden multiplayer by updating the server host scripts, made several improvements to Mod Config support, and fixed a dozen or so bugs.

As always, if you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub [github.com] or reach out to us at our Discord[discord.com].


This month we will be testing a major rework of how mods are loaded and synced on the [c]preview-v2024.02[/c] beta branch. When joining a server, a new menu will inform the user about pending mod downloads and config changes. Modders should read the How does this affect modders? section of the pull request[github.com]. Users will be happy to know that local mods will no longer override workshop mods, reducing potential errors from loading outdated mods significantly. The new UI will greatly help users avoid lengthy mod reloads in multiplayer. See this video[github.com] to see the new UI in action. We hope to perfect this user experience in anticipation for next months release.


The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide[github.com] to see how to adapt to the new changes after running tModPorter.

Destructor_Ben: Description Parameter Interpolation[github.com]
Destructor_Ben: Added TileDefinition class[github.com]
direwolf420: Added Player.hasGemRobe[github.com]

John Baglio: Implement Caching for Mod.GetContent() Results[github.com]
turtletowerz: Docker and Management Script Bugfixes[github.com]
JavidPack: -skipselect now works on server launches[github.com]
JavidPack: Additional ControlledFolderAccessDetected logging[github.com]
JavidPack: Fix issue causing the workshop menu to display improperly[github.com]
JavidPack: Fix WaspNest accessory not resetting properly[github.com]
Chicken-Bones: Remove redundant and erroneous PPID reassignment in launch script[github.com]
Solxan: Fix Author Search in Mod Browser[github.com]
JavidPack: Add log message to indicate which mod's config is triggering reload in MP join[github.com]
Chicken-Bones: Fix a missing load time performance optimization when building global hook lists.[github.com]
JavidPack: Clarify serverconfig.txt being automatic default[github.com]
JavidPack: Fix Display Issue for Sonar Buff and pickup counts when fishing with multiple lures[github.com]
JavidPack: Fix Mods Not Loading for some GOG users[github.com]

Chicken-Bones: Update MonoMod[github.com]
JavidPack: Added HitModifiers.DisableKnockback to fix Flat modifier applying to knockBackResist==0 NPC[github.com]
JavidPack: Fix issue with ModProjectile.CooldownSlot not working correctly.[github.com]
JavidPack: Language workshop tags will persist with some leniency.[github.com]
Michael Scott: Fix modded toilets not granting fishing bonus[github.com]
Destructor_Ben: Config List UI fixes[github.com]
JavidPack: Fix sorting in Mod Config List menu[github.com]
JavidPack: Show class name in GetLoadableTypesException when inheriting[github.com]
JavidPack: Fix some errors being attributed to System.RuntimeType[github.com]
JavidPack: Clarify AddMusicBox Errors[github.com]

JavidPack: WorldGen Documentation[github.com]
JavidPack: Tile and other Documentation[github.com]
JavidPack: Fix FewFromRulesRule ctor typo (chanceDenominator)[github.com]
Clay Sweetser: Minor punctuation changes[github.com]
JavidPack: Update Projectile.noDropItem documentation for 1.4 changes[github.com]
JavidPack: Update various life regen and related hook documentation[github.com]
Destructor_Ben: Add docs to ModTile.MineResist and ModTile.MinPick[github.com]

It is time for the February 2024 Stable Update!

The tModLoader team and our amazing community of contributors continues to improve tModLoader. This month's release mainly contains bug fixes.

This month we've improved support for our Apple Silicon friends, improved GoG compatibility & setup on Unix, and added compatibility for a wider array of language packs.

As always, if you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub [github.com] or reach out to us at our Discord[discord.com].


The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide[github.com] to see how to adapt to the new changes after running tModPorter.

Chicken-Bones: Check outer types for PreJITFilter attributes and improve error messages (#4033)[github.com]
ThomasThePencil: GlobalNPC.SetDefaultsFromNetId (#3955)[github.com]

JavidPack: Fix exception causing UI issue when publishing new mod[github.com]
Chicken-Bones: Automatically switch to x86 architecture when Rosetta is present (#4017)[github.com]
JavidPack: Added fallbacks for assumed GOG default paths, Fix #3526 (#4018)[github.com]
-Cyril-: Fix language packs don't work issue (#2617)[github.com]
Mirsario: Prevent Recalculate spam with ModMenu.UserInterface.[github.com]
Mirsario: Fixed #4007 (Delete Mod modal is bugged)[github.com]
-Cyril-: Qualify the dotnet path of created mod to solve error on editors such as Rider (#3944)[github.com]

Chicken-Bones: Make type 0 entities inactive in SetDefaults and TurnToAir (#4032)[github.com]

Mirsario: Fixed NuGet lib folder casing (#3965 patch [1/2])[github.com]
Mirsario: Reimplemented custom Terraria.csproj logic using C# MSBuild Tasks, fixed ".Remove(-1)". (#3965)[github.com]
Mirsario: Added a test for ResetStaticMembers.[github.com]

Happy New Year! 2024 is now upon us and a lot to look forward to.

On January 2nd our monthly update release of tModLoader will go live.
This month's release contains targeted improvements for modding such as a new Dash ID definitions in code and injection points for saving and loading data.
We are extremely grateful to the contributors and modders who continue to expand the capabilities of tModLoader.

As always, if you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub [github.com] or reach out to us at our Discord[discord.com].


The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide[github.com] to see how to adapt to the new changes after running tModPorter.

kurti256: Create DashID class for Player.dashType values (#3907)[github.com]
Mr.Zhang: https://github.com/tModLoader/tModLoader/commit/edd202fb650173834d1607282213db518a8e43a9
Mirsario: Fix Unix Case-Sensitive Assets Launch Issue[github.com]


Michael Scott: Fix `DrawPlayer` Scale Parameter (#3961)[github.com]
JavidPack: Fix ModPlayer.ModifyZoom not applying to Rifle Scope and it's upgrades[github.com]


Ibrahim: Remove Invalid NTFS folder names when creating a Modpack (#3996)[github.com]
Mirsario: Fixed #3517 (UIVirtualKeyboard doesn't disappear when it should).[github.com]


tomat: Reimplement `DrawSunAndMoon` Patch for Custom ModMenu Sun and Moon Textures (#4000)[github.com]
JavidPack: Fix issue with bad TileObjectData code causing "leaks" into other TileObjectData instances. (#3922)[github.com]
JavidPack: Fix modded NPC not defaulting to aiStyle -1.[github.com]


SuperCeleryMan: Update ExamplePetItem.cs (#3990)[github.com]
JavidPack: Fix #3523 Dungeon Location tracking in Multiplayer Example[github.com]
JavidPack: Fix ModPlayer.OnHitNPC docs mistake[github.com]
JavidPack: Clarify the armor penetration, attack speed, knockback, crit chance appropriate values.[github.com]
JavidPack: Clarify ModNPC.SpawnModBiomes docs[github.com]

RazzSG: Update ru-RU tModLoader.json (#3948)[github.com]

It is time for the December 2023 Stable Update!

The tModLoader team and our amazing community of contributors has been hard at work improving tModLoader. This month's release mainly contains bug fixes and new capabilities for modders. In particular the Mod Browser is more reliable, in-game pop-up notifications are now possible, and mod publishing has been extended to contributors.

A recently added news button on the main menu will link you to the latest tModLoader update news, such as this announcement. If you ever see the button flashing, be sure to click on it to read about the latest news from tModLoader.

As always, if you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub [github.com] or reach out to us at our Discord[discord.com].


As a reminder, as of today any modder added as a "Contributor" to a mod on the Steam workshop will be able to publish updates for the mod directly. We encourage mod owners to ensure that all contributors act responsibly with this new capability. We look forward to this feature enabling mods to more reliably update to fix bugs that arise.


The following is a list of the most noteworthy changes made for this release.

Chicken-Bones - Fix Swords that shoot having wrong rotation for 1 tick. (ChangeDir now updates itemRotation correctly)[github.com]
Michael Scott - Fix hardmode bars incorrectly dropping in Dungeon Crate[github.com]
JavidPack - Terraria logo swap easter egg now only affects original Terraria menu.[github.com]
JavidPack - Fix item swap incorrectly checking digit keys instead of assigned hotkey.[github.com]
JavidPack - Fix "0% critical strike chance" tooltip on thrown water items.[github.com]

JavidPack - Show latest news on main menu[github.com]
Solxan - Improve Mod Browser reliability by fixing a capitalization issue[github.com]
Solxan - More Mod Browser reliability changes[github.com]
JavidPack - Fix Steam Deck physical keyboard input issues (Mid-Month hotfix update)[github.com]
JavidPack - Fix crash when visiting mod config menu (Mid-Month hotfix update)[github.com]
Ibrahim Hussein - Show most recent build time for a mod in develop mods menu.[github.com]
JavidPack - Add instructions to confusing diagnostic menus[github.com]
JavidPack - Error logs now have less duplicate entries[github.com]
JavidPack - Switching back from mistakenly enabling Proton, which is not recommended, will no longer require manually deleting the dotnet folder[github.com]

Solxan - Allow Contributors to publish updates to Steam Workshop mods[github.com]
tomat - Add Support for Custom In-Game Notifications[github.com]
LoLXD8783 - Support loading Effects with .fxc files[github.com]
JavidPack - tModPorter can now be launched from in-game on Mac and Linux[github.com]
Lion8cake - Sunflowers, Pumpkins, and Fallen Logs now honor AnchorValidTiles to determine what tiles they can exist on[github.com]
BlinDeex - Add Getters for UIScrollbar visible view sizes values[github.com]
JavidPack - Added Tilemap/Main.tile indexer for Point16[github.com]
JavidPack - Add Point TagSerializer[github.com]
Lacewing - Update outdated .Net 6.0 SDK install instructions[github.com]
JavidPack - Various documentation updates: WorldGen.KillTile[github.com], Mod.HandlePacket[github.com], Pully and direction[github.com]

Mirsario - ExampleStatue ported[github.com]
David F - Fix ExampleTravelingMerchant Not Saving Shop Items[github.com]
David F - Fix ExampleTravelingMerchant Shop Not Functioning On Servers[github.com]
JavidPack - Restore ExamplePerson npcChatCornerItem example[github.com]

Doodlinka - Russian[github.com]
RazzSG - Russian[github.com]
Fish - Chinese[github.com]
Lacewing - Chinese Steam Store Page[github.com]
Wolf Igmc4 - Spanish[github.com]

It is time for the November 2023 Stable Update!

It has been another exciting month. This month's release contains fixes for various gameplay inconsistencies with Terraria. Dye visuals, boss item drops, bomb damage, tool speed, and echo coating have all received fixes to match Terraria behavior. We are extremely grateful to the users that reported these issues to us. The mod configuration menu has been reworked to be less confusing for mods with multiple configuration pages.

As always, if you are having issues of any sort, definitely don't hesitate to check out our FAQ on GitHub [github.com] or reach out to us at our Discord[discord.com].


We have exciting news for modders working in a team. Modders added as a "Contributor" to a mod on the Steam workshop will soon be able to publish updates for the mod to the workshop directly. Mod owners should take some time this month to ensure that everyone listed as a "Contributor" on the Steam workshop for your mod is trustworthy enough for this responsibility. Please remove any contributors that do not meet this standard.

The feature for contributor publishing will be active November 21st starting with our preview releases to provide time to act. Please spread the word to other mod teams you know that might not have seen this announcement.

We look forward to this feature enabling mods to more reliably update to fix bugs that arise.


The following is a list of the most noteworthy changes made for this release. As a reminder, modders should consult the Update Migration Guide[github.com] to see how to adapt to the new changes after running tModPorter.

Rijam - Fix many boss bag and crate item drops[github.com]
JavidPack - Fix even more boss and crate item drops. Fix some droprate calculations.[github.com]
Mirsario - Fix several dyes that were previously broken. Fix cos method for hlsl/shader code.[github.com]
Chicken-Bones - Fix favorited status of items transferring to hand when stack is split.[github.com]
JavidPack - Fix issue with mana regeneration.[github.com]

turtletowerz - Improve and fix the Dedicated Server scripts and instructions[github.com]
Destructor_Ben - Config menu has been reworked to be less confusing[github.com]
stormytuna - Fix mana cost item tooltip to show adjusted values[github.com]
JavidPack - In-game config change messages can now be localized properly.[github.com]
Chicken-Bones - Fix SDL driver fallbacks on Linux. Should help some Linux launch issues.[github.com]
Mirsario - Added Tantamount's patron set[github.com]

Destructor_Ben - ModConfig.AcceptClientChanges now has a NetworkText parameter[github.com]
JavidPack - Fix a .hjson file issue for mods with underscores in their name.[github.com]
Edoan - BuffDefinition added for use in ModConfig.[github.com]
JavidPack - Mod.GetLocalization method added for modder convenience.[github.com]
Rijam - Added TileID.Sets.CanPlaceNextToNonSolidTile to allow Living Fire-style modded tiles, tiles that place next to non-solid tiles.[github.com]
Destructor_Ben - Fix an issue causing temp files to appear in Visual Studio and trigger unnecessary rebuilds.[github.com]
JavidPack - Documentation[github.com]
Destructor_Ben, Chicken-Bones - Add parameterless constructor to NPCBestiaryDrawModifiers[github.com]
Chicken-Bones - Fix melee speed affecting tool use speed[github.com]
Lion8cake - Fix remix hardmode passes missing from ModifyHardmodeTasks[github.com]
Destructor_Ben - Added Item.ChangePlayerDirectionOnShoot for items to not change player direction on shoot.[github.com]

Kogsey - Ported ExampleCritter[github.com]
JavidPack - Fix Example torch and other flames not getting hidden with echo coating[github.com]

RazzSG - Russian[github.com]

An update has been scheduled for the first week of 11/2023

The update contains several changes to the API for modders.
At time of writing, the community spot check of a selection of mods suggests no mod breakage in this update.

For more information on any of these changes, please consult Our Discord[discord.com]

• Mod.GetLocalization method, convert GetOrRegister(GetLocalizationKey) to GetLocalization (#3847)[github.com] By: JavidPack
  
• Add BuffDefinition Option (#3827)[github.com] By: Edoan
  
• Fix #3825 - Echo Paint Visibility[github.com] By: JavidPack
  
• Add parameterless constructor to NPCBestiaryDrawModifiers (#3809)[github.com] By: Destructor_Ben
  
• TileID.Sets To Let Tiles Be Placed Next to Non-Solid tiles (#3684)[github.com] By: Rijam
  
• Config List Rework (Config Rework Part 1) (#3810)[github.com] By: Destructor_Ben
  
• Porting ExampleCritter and related (+ a bugfix somehow) (#3752)[github.com] By: Kogsey
  
• Localize AcceptClientChanges messages and add ModConfigShowcaseAcceptClientChanges[github.com] By: JavidPack
  
• Fix "UseMana" tooltip (#3774)[github.com] By: stormytuna

The October 2023 release of tModLoader, v2023.08, has been updated with the following bug fixes as of Hot Fix version v2023.08.3.3:

1. Fixed issues with automatically unloading Monomod edits - Chicken-Bones
   
2. Fixed Issues with servers loading new worlds - JavidPack
   
3. Fixed issues with Auto Select functionality and hotbar item swap feature - Chicken-Bones
   
4. Fixed issue preventing modders from using the open .csproj button - JavidPack

We are happy to see mods already experimenting with the new features.

As always, if you encounter any issues, please reach out in our Discord.