tModLoader 
Save
April 2024 Stable UpdateMar 31, 2024 - Community AnnouncementsIt 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. {STEAM_CLAN_IMAGE}/37627134/3afa6d272c6761a4641638277cb114de589f102f.png 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 API Changes 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 Gameplay Fixes JavidPack: Fix shop sell back price issue JavidPack: Restore full shop sell behavior direwolf420: Fix celebrationmk10 treasure bag item issue Quality of Life and Other Fixes 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 API Fixes and Changes Mirsario: Allow .hjson files to be use...March 2024 Stable UpdateFeb 29, 2024 - Community AnnouncementsIt 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 or reach out to us at our Discord. Important Feature in Preview This month we will be testing a major rework of how mods are loaded and synced on the preview-v2024.02 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. 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 to see the new UI in action. We hope to perfect this user experience in anticipation for next months release. 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 API Changes Destructor_Ben: Description Parameter Interpolation Destructor_Ben: Added TileDefinition class direwolf420: Added Player.hasGemRobe Bug Fixes Quality of Life and Other Fixes John Baglio: Implement Caching for Mod.GetContent() Results turtletowerz: Docker and Management Script Bugfixes JavidPack: -skipselect now works on server launches JavidPack: Additional ControlledFolderAccessDetected logging JavidPack: Fix issue causing the workshop menu to display improperly JavidPack: Fix WaspNest accessory not resetting properly Chicken-Bones: Remove redundant and erroneous PPID reassignment in launch script Solxan: Fix Author Search in Mod Browser JavidPack: Add log message to indicate which mod's config is triggering reload in MP join Chicken-Bones: Fix a missing load time performance optimization when building global hook lists. JavidPack: Clarify serverconfig.txt being automatic default JavidPack: Fix Display Issue for Sonar Buff and pickup counts when fishing with multiple lures JavidPack: Fix Mods Not Loading for some GOG users API Fixes and Changes Chicken-Bones: Update MonoMod JavidPack: Added HitModifiers.DisableKnockback to fix Flat modifier applying to knockBackResist==0 NPC JavidPack: Fix issue with ModProjectile.CooldownSlot not working correctly. JavidPack: Language workshop tags will persist with some leniency. Michael Scott: Fix modded toilets not granting fishing bonus Destructor_Ben: Config List UI fixes JavidPack: Fix sorting in Mod Config List menu JavidPack: Show class name in GetLoadableTypesException when inheriting J...February 2024 Stable UpdateFeb 1, 2024 - Community AnnouncementsIt 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 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 API Changes Chicken-Bones: Check outer types for PreJITFilter attributes and improve error messages (#4033) ThomasThePencil: GlobalNPC.SetDefaultsFromNetId (#3955) Bug Fixes Quality of Life and Other Fixes JavidPack: Fix exception causing UI issue when publishing new mod Chicken-Bones: Automatically switch to x86 architecture when Rosetta is present (#4017) JavidPack: Added fallbacks for assumed GOG default paths, Fix #3526 (#4018) -Cyril-: Fix language packs don't work issue (#2617) Mirsario: Prevent Recalculate spam with ModMenu.UserInterface. Mirsario: Fixed #4007 (Delete Mod modal is bugged) -Cyril-: Qualify the dotnet path of created mod to solve error on editors such as Rider (#3944) API Fixes and Changes Chicken-Bones: Make type 0 entities inactive in SetDefaults and TurnToAir (#4032) ExampleMod & API Documentation Mirsario: Fixed NuGet lib folder casing (#3965 patch ) Mirsario: Reimplemented custom Terraria.csproj logic using C# MSBuild Tasks, fixed ".Remove(-1)". (#3965) Mirsario: Added a test for ResetStaticMembers.January 2024 Stable UpdateJan 2, 2024 - Community AnnouncementsHappy 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 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 API Changes kurti256: Create DashID class for Player.dashType values (#3907) Mr.Zhang: #3887 Allow Player.Save/LoadPlayer from stream (#3899) Mirsario: Fix Unix Case-Sensitive Assets Launch Issue Bug Fixes Gameplay Fixes Michael Scott: Fix `DrawPlayer` Scale Parameter (#3961) JavidPack: Fix ModPlayer.ModifyZoom not applying to Rifle Scope and it's upgrades Quality of Life and Other Fixes Ibrahim: Remove Invalid NTFS folder names when creating a Modpack (#3996) Mirsario: Fixed #3517 (UIVirtualKeyboard doesn't disappear when it should). API Fixes and Changes tomat: Reimplement `DrawSunAndMoon` Patch for Custom ModMenu Sun and Moon Textures (#4000) JavidPack: Fix issue with bad TileObjectData code causing "leaks" into other TileObjectData instances. (#3922) JavidPack: Fix modded NPC not defaulting to aiStyle -1. ExampleMod & API Documentation SuperCeleryMan: Update ExamplePetItem.cs (#3990) JavidPack: Fix #3523 Dungeon Location tracking in Multiplayer Example JavidPack: Fix ModPlayer.OnHitNPC docs mistake JavidPack: Clarify the armor penetration, attack speed, knockback, crit chance appropriate values. JavidPack: Clarify ModNPC.SpawnModBiomes docs Localization RazzSG: Update ru-RU tModLoader.json (#3948)December 2023 Stable UpdateDec 1, 2023 - Community AnnouncementsIt 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 or reach out to us at our Discord. Important News for Mod Makers 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. New Changes' Highlights The following is a list of the most noteworthy changes made for this release. Bug Fixes Gameplay Fixes Chicken-Bones - Fix Swords that shoot having wrong rotation for 1 tick. (ChangeDir now updates itemRotation correctly) Michael Scott - Fix hardmode bars incorrectly dropping in Dungeon Crate JavidPack - Terraria logo swap easter egg now only affects original Terraria menu. JavidPack - Fix item swap incorrectly checking digit keys instead of assigned hotkey. JavidPack - Fix "0% critical strike chance" tooltip on thrown water items. Quality of Life and Other Fixes JavidPack - Show latest news on main menu Solxan - Improve Mod Browser reliability by fixing a capitalization issue Solxan - More Mod Browser reliability changes JavidPack - Fix Steam Deck physical keyboard input issues (Mid-Month hotfix update) JavidPack - Fix crash when visiting mod config menu (Mid-Month hotfix update) Ibrahim Hussein - Show most recent build time for a mod in develop mods menu. JavidPack - Add instructions to confusing diagnostic menus JavidPack - Error logs now have less duplicate entries JavidPack - Switching back from mistakenly enabling Proton, which is not recommended, will no longer require manually deleting the dotnet folder API Fixes and Changes Solxan - Allow Contributors to publish updates to Steam Workshop mods tomat - Add Support for Custom In-Game Notifications LoLXD8783 - Support loading Effects with .fxc files JavidPack - tModPorter can now be launched from in-game on Mac and Linux Lion8cake - Sunflowers, Pumpkins, and Fallen Logs now honor AnchorValidTiles to determine what tiles they can exist on BlinDeex - Add Getters for UIScrollbar visible view sizes values JavidPack - Added Tilemap/Main.tile indexer for Point16 JavidPack - Add Point TagSerializer Lacewing - Update outdated .Net 6.0 SDK install instructions JavidPack -...November 2023 Stable UpdateNov 1, 2023 - Community AnnouncementsIt 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 or reach out to us at our Discord. Important News for Mod Makers 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. 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. Bug Fixes Gameplay Fixes Rijam - Fix many boss bag and crate item drops JavidPack - Fix even more boss and crate item drops. Fix some droprate calculations. Mirsario - Fix several dyes that were previously broken. Fix cos method for hlsl/shader code. Chicken-Bones - Fix favorited status of items transferring to hand when stack is split. JavidPack - Fix issue with mana regeneration. Quality of Life and Other Fixes turtletowerz - Improve and fix the Dedicated Server scripts and instructions Destructor_Ben - Config menu has been reworked to be less confusing stormytuna - Fix mana cost item tooltip to show adjusted values JavidPack - In-game config change messages can now be localized properly. Chicken-Bones - Fix SDL driver fallbacks on Linux. Should help some Linux launch issues. Mirsario - Added Tantamount's patron set API Fixes and Changes Destructor_Ben - ModConfig.AcceptClientChanges now has a NetworkText parameter JavidPack - Fix a .hjson file issue for mods with underscores in their name. Edoan - BuffDefinition added for use in ModConfig. JavidPack - Mod.GetLocalization method added for modder convenience. Rijam - Added TileID.Sets.CanPlaceNextToNonSolidTile to allow Living Fire-style modded tiles, tiles that place next to non-solid tiles. Destructor_Ben - Fix an issue causing temp files to appear in Visual Studio and trigger unnecessary rebuild...Upcoming Regular Update Announcement (11/2023)Oct 17, 2023 - Community AnnouncementsAn 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 Mod.GetLocalization method, convert GetOrRegister(GetLocalizationKey) to GetLocalization (#3847) By: JavidPack Add BuffDefinition Option (#3827) By: Edoan Fix #3825 - Echo Paint Visibility By: JavidPack Add parameterless constructor to NPCBestiaryDrawModifiers (#3809) By: Destructor_Ben TileID.Sets To Let Tiles Be Placed Next to Non-Solid tiles (#3684) By: Rijam Config List Rework (Config Rework Part 1) (#3810) By: Destructor_Ben Porting ExampleCritter and related (+ a bugfix somehow) (#3752) By: Kogsey Localize AcceptClientChanges messages and add ModConfigShowcaseAcceptClientChanges By: JavidPack Fix "UseMana" tooltip (#3774) By: stormytuna October 2023 Hot FixesOct 3, 2023 - Community AnnouncementsThe October 2023 release of tModLoader, v2023.08, has been updated with the following bug fixes as of Hot Fix version v2023.08.3.3: Fixed issues with automatically unloading Monomod edits - Chicken-Bones Fixed Issues with servers loading new worlds - JavidPack Fixed issues with Auto Select functionality and hotbar item swap feature - Chicken-Bones 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.October 2023 Stable UpdateSep 30, 2023 - Community AnnouncementsIt is time for the October 2023 Stable Update! Over the last month the tModLoader team has been busy fixing bugs and incorporating new functionality into tModLoader. This month's update includes many bug fixes, as usual, but this month's release has a particularly large amount of new functionality for modders to play with. New features include support for modded Builders Toggles, modded Emote Bubbles, Rubblemaker support, a reworked NPC buff immunity system, a way to store world header data, and the long awaited Extra Jump API. These new features have made their way into tModLoader from the efforts of our amazing community of modders willing to contribute to tModLoader, we encourage modders to continue contributing features to tModLoader. These code changes will allow modders the ability to make things previously prohibitively complex to implement. We hope players look forward to mods incorporating these new features and encourage modders to take a moment to test their mods today to ensure that they still load, especially if your mod relates in any way to the newly implemented features. We look forward to seeing how mods make use of these new features. 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. Extra Jump API by absoluteAquarius • Adds an API for adding modded extra jumps. • Extra jumps were previously extremely hard to implement. • Please read the Extra Jump API pull request page and the Update Migration Guide for more information. Porting Notes: If you previously used your own approach, please use the tModLoader approach. The Update Migration Guide has more information on how to port your code. Add modded world header data by Chicken-Bones • Modded world data can be now be saved into a 'header' in the .twld file. The header can be read without deserializing the entire .twld file, and the modded data is accessible in the world select menu and during vanilla world loading. • The list of mods the world was last played with is now shown in the world select menu, just like for players • The list of mods (and version of those mods) the world was generated with is now stored in the header. Only applies to worlds generated in the future of course. Modded Emote Bubble by -Cyril- • Modders can now make custom emotes • Modders can adjust how NPC pick emotes • ExampleMod shows off several custom emotes and custom emote spawning Rework NPCID.Sets.DebuffImmunitySets by JavidPack • Buff immunities for NPC has been reworked to be easier to work with and more functional. • NPCID.Sets.DebuffImmunitySets has been replaced with NPCID.Sets.SpecificDebuffImmunity, NPCID.Sets.ImmuneToAllBuffs, and NPCID.Sets.ImmuneToRegularBuffs to simplify mo...September 2023 Stable UpdateAug 31, 2023 - Community AnnouncementsWe hope everyone has been having a fun time with 1.4.4 tModLoader! We are happy to see that a large majority of popular mods have already been updated to work with the latest tModLoader. In fact, over 85% of all mods by subscriber count have made it to 1.4.4 tModLoader already. Over the last month the tModLoader team and our amazing contributor community have been hard at work fixing bugs and other issues. This months update focuses on bug fixes. We also managed to greatly improve the in-game workshop performance, please check it out. Modders: Next month tModLoader will add many new exciting features, such as Builders Toggles, Emote Bubbles, World Headers, Rubblemaker support, and a reworked NPC buff immunity system, so modders should take the opportunity this month to experiment with these features on the preview beta branch, preview-v2023.08, prior to their release. You'll need to switch to this new beta branch even if you were previously in preview-v2023.07. In addition, there are other changes that might break your mods, so be sure to test your mods and publish an update on preview before October if needed. As always, if you encounter any issues, please reach out in our Discord. New Changes' Highlights Re-design Mod Browser & Back-end by Solxan, DarioDaF, and Chicken-Bones • Revamps the Mod Browser UI to be significantly faster & streamlined Bug Fixes Gameplay Fixes Destructor_Ben - Fix some walls dropping the incorrect item ThomasThePencil - Fix a few armor stat bonuses Destructor_Ben - Fix Search in the duplication menu JavidPack - Fix Terrarian not getting Legendary prefix JavidPack - Fix Grand Design not dropping wire directly into player inventory JavidPack - ModHair is not showing for other other players in multiplayer JavidPack - Fix some shop items not having material tooltip line QOL and Other Fixes Chicken-Bones - Fix game to launch on MUSL/Alpine Linux Destructor_Ben - Config Elements state if they required a reload Destructor_Ben - Fix Mod Icon inconsistencies Solxan - Auto Enable Dependency Mods on Reload Solxan - More fixes for mod organization Solxan - Fix more issues with workshop icons Solxan - Fix a GOG workshop issue JavidPack - Clarify UI messages for outdated mods JavidPack - Fix issue preventing tModLoader from running in Snap sandbox API Fixes JavidPack - Fix tModPorter meleeCrit typo JavidPack - Fix ExampleHerb to work with Acorn Axe BasicallyIAmFox - Fix MonoModHooks.DumpILHooks always throwing Destructor_Ben - Prevent modders from accidentally publishing dev-built mods on stable Destructor_Ben - Tile Documentation NeonCube - More Documentation Localization We recently started localizing the store page and workshop tags. We are also lacking a great deal of in-game translations for several languages still. If you are interested in translating these, please get in contact with us on Discord to ask how to contribute translations or visit the tModLoader wiki for instructions.1.4.4 Hot Fixes SummaryAug 10, 2023 - Community AnnouncementstModLoader 1.4.4 Version has been updated with the following bug fixes as of Hot Fix Version 2023.06.25.30: Fixed issues with Gore/Leaf spawning - Mirsario Fixed Issues with OneDrive Save Data Migration - Javidpack Fixed issues with UnloadedModItem being lost in accessory slots - Solxanich Increased reliability of saving & loading world, player files - Solxanich Thank you for your patience. We are continuing to look at save data challenges with 1.4.4 and 1.4.3-Legacy, and appreciate your understanding. As always, if you encounter any issues, please reach out in our Discord.The 1.4.4 Update is Now LiveJul 31, 2023 - Community AnnouncementsThe 1.4.4 Update Is Now Live on Steam. Thank you for your patience. As a reminder, if mods you were using on 1.4.3 haven't updated yet, you can switch back to 1.4.3 in the meantime by using the beta branches feature to switch to the 1.4.3-legacy branch. New Changes' Highlights The following is a list of the most noteworthy pull requests and commits that have been pushed since 2022th October, and are now available on the default/stable branch. Major Localization Changes by jopojelly • Translations are now fully in localization files (.hjson files). DisplayName and Tooltip, for example, can no longer be assigned in code. • Localization files are automatically updated with entries for new content and managed by tModLoader. More organization options available. • All ModTranslation usages are now replaced with LocalizedText • All translation keys now follow a more predictable pattern: Mods.ModName.Category.ContentName.DataName • Contributing translations, directly or through translation mods, streamlined. Porting Notes: #preview-update-log in DiscordChange HookGen Namespace Style by Chicken Bones • Hookgen namespaces (IL. and On.) have been removed in favor of On_ and IL_ prepended to the type name. • No longer will you get 3 different namespace suggestions when you use VS to import a Terraria type name. • Want On Item hooks? Just use On_Item it's in the same namespace as Item! Porting Notes: #preview-update-log in DiscordDeclarative Shops by BasicallyIAmFox • NPC shops are now declarative, meaning they get registered, and items can be added to them with conditions, similarly to NPC drops (loot) and recipes • Adding items to shops, or hiding items from shops is now as easy as adding or disabling recipes • Info mods can traverse the NPCShopDatabase to show how to obtain an item. All the conditions for items appearing in shops have been localized. • Registering multiple shops per NPC is perfectly fine, and selecting the shop to be opened when chatting can now be done via the ref string shop parameter in OnChatButtonClicked Porting Notes: #preview-update-log in DiscordMax Health and Mana Manipulation API by absoluteAquarian • Adds ModPlayer.ModifyMaxStats with StatModifier arguments for permanent adjustments to max health/mana. • Adds Player.ConsumedLifeCrystals, ConsumedLifeFruit and ConsumedManaCrystals properties. • Add helper methods Player.UseHealthMaxIncreasingItem and Player.UseManaMaxIncreasingItem for the visual effects. • Adds ModResourceDisplaySet allowing for custom life/mana draw styles (similar to boss bar styles) that can be selected in settings. • Adds ModResourceOverlay to allow for drawing custom hearts/mana/effects over the vanilla (or modded) life/mana UI elements. Porting Notes: #preview-update-log in DiscordModHair API by steviegt6 • Adds the ability to add new hairstyles, with unlock conditions.Update MonoMod to new Re-organized implementation by Chicken-Bones • Updates to MonoMod involve the removal of old APIs, and better perform...1.4.4 Release AnnouncementJul 28, 2023 - Community AnnouncementsHello everyone! We are excited to announce that 1.4.4 tModLoader will be available starting August 1st as tModLoader's default experience! After a lot of testing and changes, we are ready to release this next big version of tModLoader. We have seen significant uptake within the modding community on our 1.4.4-preview Beta, and are looking forward to a smooth transition to the next big stage. A lot of hard work went into this, so a big thank you to everyone involved. Likewise, although 1.4.4 is released from our end, there will still be some mods not yet released on 1.4.4. This may include some popular mods. We anticipate several of these noteworthy mods to release within the few days to follow, and ask for your patience as modders publish their work. For more information on the Jump to 1.4.4 and all that's happening around it, you can read more in our big announcement from earlier this month: tModLoader 1.4.4 Transition Plan Please note that 1.4.4 will NOT replace 1.4.3. 1.4.3 will continue to be available in full through Steam Beta options, just as 1.3 is today. Once again, we are excited to bring tModLoader to 1.4.4 age! We hope you enjoy this next era of modding, and several improvements we've made during the journey. Sincerely, The tModLoader Community1.4.3-Legacy Transition Period StartJul 7, 2023 - Community AnnouncementsHowdy Terrarians, In Case You Missed It, July 7th marks the start of our transition to 1.4.4. You can read more about the transition here: https://store.steampowered.com/news/app/1281930/view/3694688633575770202 This recent update includes several file storage changes and an in-game recommendation and for tutorial for hopping to one of our two beta options to match your preference. We recommend doing so ahead of us swapping out the default to 1.4.4 to avoid interruption: 1.4.3-Legacy 1.4.4-Preview Have fun, and stay classy!tModLoader 1.4.4 Transition PlanJul 5, 2023 - Community AnnouncementsHello Terrarians! As the tModLoader community reaches closer to offering tModLoader 1.4.4 as the default, we'd like to take this chance to outline how this is all going to work. tModLoader 1.4.4 is a big update with major code changes incompatible with existing 1.4 mods. It marks the start of a new generation of mods, just as the change from 1.3 to 1.4 did before. For those that remember the change from 1.3 to 1.4 - it was quite a big event. There were lots of moving parts and we've all learned a lot from the process. We've kept 1.3 alive and running in the Steam Betas, and will be doing the exact same with 1.4.3. More info on Steam Betas here on our GitHub With Modders making fast progress on porting to 1.4.4, it's even more important that we talk about this early. So how's this going to work? There will be three phases of the transition: Establishing 1.4.3-Legacy Support, Transition Period, and Transition Day 1.4.3 Legacy Support We've established a new home for 1.4.3 modding - the Steam Beta "1.4.3-legacy" branch! This branch will keep all 1.4.3 mods currently accessible, and will be a permanent mainstay. Likewise, we have also added new version tags to our Workshop. You can now filter by "tModLoader version" = 1.4.4 or 1.4.3 to see which mods are available. Mod Browser version filtering is on our roadmap as well. https://cdn.discordapp.com/attachments/803582463837995019/1126222168448040971/2023-07-05_12-40-13.png Modders can continue to publish updates for 1.4.3 users by using the 1.4.3-Legacy Steam beta. This is a great time to think about stabilizing that existing release and moving to 1.4.4 permanently with tModPorter's help. Please note we will also automatically move some save files around with an upcoming July 7 update - if you encounter any issues, please let us know immediately at our Discord Finally, we still have a few compatibility items to sort out. Items like our Server Management scripts will need some attention to support both 1.4.3 and 1.4.4 in parallel. Please keep an eye on our Discord for the latest progress! Rest assured that any mods published on 1.4.3-legacy will continue to be available to 1.4.3-legacy users and are unaffected by modders publishing updates on the 1.4.4 version of tModLoader. Transition Period Around the second week of July, we will start migrating users over to the 1.4.3-legacy beta branch through an in-game prompt. During this period, we recommend players who wish to remain playing on 1.4.3 to switch to the 1.4.3-legacy Beta Option. This will guarantee that you will be unaffected on Transition Day. All your save files from 1.4.3 will be automatically and safely migrated over to a new folder during this transition period: tModLoader-1.4.3. This will ensure you always can come back to play on 1.4.3 at your leisure. The Transition Period will last for at least the remainder of July. This period provides modders with a last chance to publish their mods on 1.4.4-preview ahead of 1.4.4 being the default offe...January tModLoader Stability UpdateJan 7, 2023 - Community AnnouncementsThe New Year is upon us, as well as fresh Stable TML Bug Fix Series bringing polishing and a wagon of stability improvements. Happy New Year Terrarians! tModLoader for Terraria v1.4.4, when? Before we begin, we hope everyone has been having fun playing the new Terraria v1.4.4 update (Labor of Love). We know everyone is looking forward to mods having access to all of the new features. We'd like to remind tModLoader users that updating tModLoader to the v1.4.4 codebase will take some time, so please be patient. We are committed to getting tModLoader updated to v1.4.4 sometime soon and we can see the end coming, but we can not guarantee when that will be yet. Much of the Terraria code has changed and we still need a bit more time test tModLoader and then give mod makers time to adapt their mods to those changes. If you are a mod maker and are interested in the migration to 1.4.4, please participate in our Discord development channels and on GitHub. Thank you for your patience! Bug Fixes For this update, we are keeping it focused to bug fixes. Although we have new features and changes in the works, they all are primarily happening with 1.4.4. Please stay tuned for news on 1.4.4! Freedbot: Made server manage script curl/wget agnostic (#3081) ilcheese2: Fix content folder path on Mac with GoG version (#3173) SecondFry: Fix workshop files location for Docker deploy (#3047) Cyrilla: Fix temporary items not saving modded data (#3054) Lama3L9R: Fix engine crash when failed to fetch local mod dependencies (#3023) Antirhinnum: Fix Corsair RGB (#3096) Dradonhunter11: Fixed: Patreon Items and Developer Items can now be researched (#3075) AbsoluteAquarian: Fix AssemblyManager.ForceJITOnMethod() Throwing on Interface Methods (#3175) Jadams505: More checks to stop chat (#3065) Jadams505: Fixed vines disappearing when teleporting (#3059) JavidPack: Simple approach to Fix #2959 (#3051) JavidPack: Fix typo rendering French mod browser unusable JavidPack: Fix #3010 by ensuring ContentSamples.ItemsByType have tooltips JavidPack: Fix #3018, Buff tooltips can now have chat tags. Solxanich: Trailing cleanup of start server.sh. Fixes #3137 Solxanich: Fixes #3032 - GoG mod deletion (#3171) Solxanich: Workshop Improvements Pack 3 (#3157) Solxanich: Fix Terraria OW Mod Audio (#3161) Solxanich: Vastly Speed Up Publishing Menu Known Issues My game doesn't launch, and I'm on Windows! If you're on Windows 7 or 8.X, or an older Windows OS, installing .NET pre-requisites listed in Microsoft's website might very much help. Especially the KB3063858 update. If the above doesn't apply or didn't help, try deleting the dotnet folder in the install directory, and try running TML again. There seems to be a bug with extracting needed libraries on some Windows devices, where it may take two attempts. We are actively investigating improvements to remedy this. Frequently Asked Questions How do I switch to the 1.4-preview or 1.3-legacy branches of TML? To switch to anoter branch in steam, just...October Mid-Month Bug Fixes Part 2Oct 11, 2022 - Community AnnouncementsThank you for your patience. This follow-up update includes fixes for the following two items: 1) A severe performance drop on some 4k monitors due to an edge case issue with resolution settings 2) An incompatibility with the unofficial 1.3 64 bit version - as a reminder, we recommend against modifying the original tmodloader install with external files as it can lead to unexpected behaviour. As always, please continue to reach out via our Discord with any issues you encounter: https://discord.gg/3snus3cW6cOctober Mid-Month Bug FixesOct 10, 2022 - Community AnnouncementsOctober Mid-Month Bug Fixes Happy October All! While we are working on 1.4.4 porting, we know there is still a fair few bugs to cleanup on the current stable version. We've pushed the following changes to cover off some of the problematic ones: Mirsario - Fixed date parsing crashes in world backup cleanups. Mirsario - Add additional logging regarding issues with .NET versions Solxanich - Fix remaining Biome detection issues along vertical axis Solxanich - Fix inability to publish a new version of a mod on to Stable, when one is already published Solxanich - Improve handling of 4k resolution on Mac JavidPack - Improve logging of Resource Packs in the event of conflicts JavidPack - Fix ModPack Menu crashing while it is being opened JavidPack - Fix Bestiary only showing half of the available mods in some instances JavidPack - Improve error information for Folder Access conflicts Thank you for your patience on these bugs and reporting them! As always, for all issues needing support, we recommend reaching out through our Discord: https://discord.gg/3snus3cW6c As a reminder, 1.4.4 code changes will take a fair bit of time. A lot has changed in the code, and updating this open-source, community-run mod loader will take some time to match. We will share more news on progress in the future.Hot Fix 2022.09.X.X : Biome Bleed RemovedOct 1, 2022 - Community AnnouncementsHot Fix 3: Biome Bleed Removed We've recently deployed new version 2022.09.47.4 fixing biomes showing up at larger distances than intended during the push of Hotfix 2022.09.47.2. Thank you for your patience while we isolated and resolved the bug. For additional issues, and the latest updates on any hotfixes coming after the big monthly updates, we recommend tuning in on our DiscordHot Fix 2022.09.X.X : 4k / QHD Display Resolution Support RestoredOct 1, 2022 - Community Announcements2022.09.X.X Hot Fix 1 We've recently deployed new version 2022.09.47.2 fixing the resolution issue for QHD / 4K displays. Thank you for your patience while we isolated and resolved the bug. Please Note: We are investigating the issue regarding MonoMod library on 1.4-Preview that is preventing some users from running that version of tModLoader. In the interim, please use the Stable version (the default in Steam).
Show Comments
