tModLoader

tModLoader

TML Team · Re-Logic

activeReleased May 16, 2020steam

Dig, Fight, and Build your way through the world of player-created mods on Terraria with tModLoader - this DLC makes modding Terraria a reality!

Year 6

May 16, 2025 - May 16, 2026

66 changes

tModLoader introduced over 350 new mods in January 2026, enhancing the modding experience significantly. Additionally, the new mod detection for unlisted or banned mods launched on May 1, 2026, allowing players to continue using their favorite mods even if they faced restrictions.

  • New Content: Various features and tools were added to improve modding.
    • Adjustable Potion Delay APIs launched in November 2025.
    • New NPC Interaction Hooks were introduced in September 2025, allowing for deeper interactions with NPCs.
    • tModCodeAssist Rework included improvements for mod developers in September 2025.
    • Equipment Loadouts Support for ModAccessorySlot was added in July 2025.
  • Performance Improvements: The dedicated server management script was updated on May 1, 2026, enhancing server management capabilities.
  • Quality of Life Enhancements: Several updates improved user experience and modding efficiency.
    • Launch scripts were improved to prevent unnecessary folder deletions in January 2026.
    • The Preserve Mods List menu sorting mode choice was implemented in November 2025, allowing players to maintain their preferred sorting settings.
  • UI/UX Updates: The achievement menu button was updated in January 2026, and the fullscreen limitation for the capture UI open folder button was removed, improving overall usability.

Year 5

May 16, 2024 - May 16, 2025

121 changes

tModLoader introduced Custom and Named ID Sets Support on May 1, 2025, allowing mods to create their own 'Sets' and collaborate more easily. This update also included Biome Conversion Support and various enhancements aimed at improving mod development and user experience.

  • New Content: Multiple new features were added to enhance modding capabilities.
    • Customizable Swaying Tiles: Introduced new hooks for tiles to sway, including an ExampleChandelier.
    • Improved Enemy Banner Support: Enhanced functionality for enemy banners with detailed examples.
    • Support for Modded Clouds: Enabled modders to implement custom clouds for visual effects.
  • Quality of Life Improvements: Several updates improved usability for modders and players.
    • Show Community Announcements In-Game: Players now see community announcements directly in-game.
    • Dismissable Warning for Family Share Limitations: Users can now permanently dismiss warnings related to family sharing.
    • Mod Packs Colored Bright Green: Mod packs are now visually identifiable when additional mods are enabled.
  • Performance Enhancements:
    • Improved Startup Time: The startup process was optimized by delaying the verification of .tmod file hashes.
  • Balance Change:
    • Increased Workshop Publication Requirements: New requirements were established for mods, mandating a custom icon and useful descriptions to enhance mod discoverability.
  • Visual Updates:
    • Map Backgrounds Use Sky Color: Map backgrounds can now utilize the sky color, enhancing the aesthetic experience.

Year 4

May 16, 2023 - May 16, 2024

75 changes

tModLoader 1.4.4 launched on August 1, 2023, marking a significant update that introduced major code changes incompatible with existing 1.4 mods. This release established a new generation of mods, alongside a seamless transition for users and modders. Additional updates included major localization changes and various gameplay enhancements.

  • New Content:
    • tModLoader 1.4.4 introduced significant code changes incompatible with previous mods, laying the foundation for future modding.
    • The new DashID class was created for Player.dashType values.
    • Major localization changes allowed translations to be fully managed in localization files (.hjson).
  • Gameplay Enhancements:
    • The transition to the default version 1.4.4 was scheduled for August 1, 2023, ensuring a smooth user experience.
    • The Declarative Shops Implementation allowed NPC shops to be managed more easily.
    • A new Max Health and Mana Manipulation API provided options for permanent adjustments to player stats.
  • Modding Improvements:
    • The Mod.GetLocalization method was updated for better localization management.
    • A Config List Rework began to enhance configuration options for modders.
    • BuffDefinition Options were added to expand modding capabilities.
  • Quality of Life Updates:
    • Mod Config Auto Localization was introduced to streamline localization for mod creators.
    • The establishment of 1.4.3-Legacy Support ensured ongoing access for existing mods.
    • New version tags for workshop filtering were added to help users find compatible mods.
  • UI/UX Changes:
    • The Mod Browser UI received a redesign for improved speed and performance.
    • UI fixes were implemented to enhance user interaction with faded mouse over elements.

Year 3

May 16, 2022 - May 16, 2023

95 changes

tModLoader for Terraria 1.4+ launched on June 3, 2022, transitioning the default version on Steam and introducing significant enhancements for mod developers with the tModPorter Module on June 1. This update marked a pivotal shift for the community, offering new tools and features that broadened modding capabilities.

  • New Content:
    • Introduced the tModPorter Module for easier transitions from Terraria 1.3 to 1.4.
    • Added ModPylon Teleportation Position Adjustment to optimize teleportation mechanics.
    • Enabled the Save & load for NPCs feature, allowing custom data to be saved on NPCs.
    • Implemented Continuous Projectile Damage Updates for enhanced combat dynamics.
  • Gameplay Improvements:
    • Launched Modded Pylons, expanding teleportation options for custom mods.
    • Enhanced Grab Bag Loot Modernization, giving right-click items a loot table similar to NPC drops.
    • Added ModPlayer.ModifyFishingAttempt Hook for custom fishing mechanics.
    • Introduced various hooks for NPC interactions, including Expanded NPC Capture Hooks.
  • Performance Enhancements:
    • Achieved 64-bit Support and Performance Improvements, enhancing stability and performance.
    • Upgraded to a dev build of MonoMod, improving code injection speeds significantly.
    • Addressed severe performance issues on 4k monitors, resolving edge case problems in resolution settings.
  • Quality of Life Features:
    • Implemented a notification system for updated mods upon launch.
    • Enabled Automatic Reload of Mods when exiting the Mods menu, streamlining gameplay.
    • Allowed players to download missing mod dependencies at startup, improving accessibility.
  • Balance Changes:
    • Adjusted RangedPrefix for Throwing Weapons, ensuring they receive ranged prefixes by default.
    • Restored vanilla melee speed balance, ensuring projectile fire rates remain unaffected.

Year 2

May 16, 2021 - May 16, 2022

14 changes

The introduction of the 1.4 tModLoader Preview System on April 2, 2022, marked a significant shift in the game, allowing players to experience a split between the 1.4-preview and 1.4-stable branches. This update was accompanied by multiple improvements, such as new hooks for better mod development and a major overhaul of the DamageClass system.

  • New Hooks:
    • OnSpawn hooks were added for items, NPCs, and projectiles on May 4, enhancing initialization capabilities.
    • Buff Draw Hooks, including ModBuff and GlobalBuff hooks (PreDraw, PostDraw, RightClick), were introduced on May 4.
    • The CanFallThroughPlatforms NPC Hook was added, allowing for new functionalities in NPC behavior.
    • The NPC Profile System was extended, replacing the TownNPCName hook with SetNPCNameList for improved customization.
  • DamageClass Overhaul: The DamageClass Overhaul Part 2 on May 4 introduced Flat and Base fields for Stat Modifiers, added attack speed and armor penetration stats, and incorporated hybrid items into the damage class structure.
  • Quality of Life Improvements:
    • Stable Branch Updates implemented a test period of up to one month before changes moved to the stable branch.
    • 1.3 mod developers received encouragement to port their mods to 1.4.
    • Players were notified of outdated mods built during the Alpha period.
    • Detailed instructions for switching between the 1.4-stable and 1.4-preview branches were provided.
  • Performance Enhancements: A major refactoring of naming conventions took place on May 4 to align with common C# standards.
  • Workshop Tag Initialization: On May 4, a preliminary initialization of Workshop Tag Code was introduced, allowing for future tags and feedback incorporation.

Year 1

May 16, 2020 - May 16, 2021

59 changes

tModLoader launched on May 16, 2020, alongside Terraria's Journey's End update, marking a significant milestone for modding in Terraria. The platform became available on Steam, allowing players to install and enjoy mods more easily. Key updates included the restoration of GOG installation support and improvements to mod loading performance.

  • Steam Release: tModLoader became available on Steam on May 16, 2020, enhancing accessibility for players.
  • GOG Support: Installation support for GOG was restored on May 29, 2020, allowing GOG users to enjoy tModLoader.
  • Modding Improvements: Players were able to play both vanilla Terraria and tModLoader simultaneously as of May 16, 2020.
  • Performance Boost: Improved mod loading performance was introduced on May 22, 2020, utilizing multiple cores for better efficiency.
  • User Interface Enhancements: Multiple UI updates were made, including a dynamic notification in the mod creation menu and updated error dialogs on May 22, 2020.
  • Quality of Life Fixes: The Mod Browser maintained its functionality without enforcing Steam Workshop use, and checks for the correct Content directory were implemented on May 22, 2020.