github tModLoader/tModLoader v0.11

latest releases: v2024.03.3.3, v2024.05.1.20, v2024.05.1.19...
4 years ago

Major Features
ModConfig
GoG Support
MonoMod Support
Automatic World and Player Backups

API
ModConfig - Helps mods make per-user and per-server configuration.
C# 7 support by default - build.txt no longer requires languageVersion.
Global/ModItem.GetHealLife and GetHealMana - Allows dynamic health restore for potions. Thanks @DarkLight66
ModLoader now ModContent - Many methods are now in ModContent
ErrorLogger deprecated, replaced with new Logging system
MonoMod support - Allows editing any method
ModProjectile Glowmask support
A bunch of Update hooks in Mod: PreUpdateEntities, MidUpdateTimeWorld, etc. Thanks @Leemyy
ModPlayer.ModifyNurseHeal/ModifyNursePrice/PostNurseHeal/PostSellItem/CanSellItem/PostBuyItem/CanBuyItem - Various hooks to act upon shop purchases, thanks @Agrair
All necessary .dll references automatically placed in ModLoader\references with tModLoader.targets file
In-game Mod Source generator utilizing tModLoader.targets file
Terraria documentation files auto downloaded
Terraria PDB files auto downloaded for better debugging
HiDef defaults to true regardless of resolution (better shader support)
2nd level weak-references no longer required for compile
Major version dependencies must match for mods referencing other mods to mitigate future versioning bugs
$CommonItemTooltip.PercentIncreasedDamage (Please request more common tooltips you'd like to see made available for localization)
Main.HidePlayerCraftingMenu for custom UI that hide the craft menu
OGG audio support
ModTile.IsLockedChest and ModTile.UnlockChest allow for proper locked chest support. See ExampleChest
Preprocessor symbols and unsafe support
Global/ModNPC.CanGoToStatue and OnGoToStatue - Allow modded town npc to teleport to King and Queen statues.
GetWeaponDamage now obsolete, use ModifyWeaponDamage
New PickAmmo method arguments for the weapon item.
ModifyManaCost/OnMissingMana/OnConsumeMana hooks for dynamic mana costs and effects
Main.trashSlotOffset - Adding ability to offset trash slot
Font support improved

Fixes
Fix world corruption bug caused by ModTileEntities
Fix an ItemFrame bug that deleted mod items
Fix Banner placement on platforms
Fix Reforge losing ModItem data
Fix ModLoader.TextureExists bug
Fixed IsAnglerQuestAvailable logic
Fix 20+ line bug with item tooltips
Fix bad ModPack menu issue
Clearer Mod Browser error messages
Fix more memory leaks
Fix exceptions not being logged from server
Fix 50 townNPC limit in housing UI
Fixed issue with Old Ones Army items giving too much damage boost
Fix PostDrawTiles scale
Map background drawing now accommodates non-standard sizes
Fix GlobalItem.OnConsumeAmmo
TownNPC chat now supports chat tags.
Mac and Linux installer works better
Fix multiplayer damage for hits over 32767 damage
Fix modded hair dye saving
Fix no audio device errors
Fix random PlayerInput bugs during mod loading
Fix HoldoutOrigin hooks
Fix TileLoader.PostDraw
Fix ModPack illegal filename issues
Fix potential ItemTag issues
Cancelling mod syncing will no longer delete the mod in question
Fix vanilla angler quests reseting on world reload
Fix TextureDisposedException (The blank screen bug on Linux and Mac)
Linux and Mac support greatly improved (mod building)
Fixed Black Screen loading error on Mac and Linux
Fix Texture Pack support on Mac and Linux (Vanilla bug)

QOL
GOG version support
Mods will automatically be enabled and reload when leaving the mod browser
Automatic player and world migration
Common exceptions are ommited from exception logging
Mod Sources now hidden until developer mode is enabled
Localized menus should now fit inside menu buttons
Load errors are now more informative and provide more options
SteamID checked before publishing mod
ModNet diagnostics. Press F8 to see how many packets each mod is sending.
Repeated errors are no longer spammed
Mod Browser search now checks internal name as well
File Association for .tmod files on Windows. Double click to install or enable mods.
Mod Memory consumption UI in Mods menu - Enable in tModLoader settings and then restart.
Mod->More Info->Homepage button now shows URL when hovered
Mod Browser listing downloads quicker
Warning for mods that fail to unload fully
Runs on system installed Mono
Full debugging and stack trace support on Mac and Linux
Smarter installer
All exceptions are now logged to logs by default
Progress bar messages now less ugly
Experimental Autoupdate on Windows
Automatic World and Player Backups
Download All with Dependencies via Mod Browser
Mod Info and Mod Browser more responsive

Example Mod
ExampleOre, ExampleBar
ExampleBulllet now properly hits tiles and makes bounce sounds
ExampleTrap - Shows custom hammering, multiple AddMapEntry, non-autoload approach
ExampleUI now rebounds onto screen
ExamplePersonUI and VanillaItemSlotWrapper show an NPC UI example with an item slot
ExampleAdvancedRecipe shows inheriting from ModRecipe, RecipeAvailable and OnCraft usage.
Much cleaner code
ExampleLamp - Shows toggling via wire
ExampleSnail - Shows editing a vanilla RecipeGroup, bugnet usage, and IL editing via MonoMod
NonStopParty - ModPlayer.SendClientChanges, OnEnterWorld, and clientClone example.
ExampleHairDye. Thanks @DarkLight66
ExampleOre and ExampleBar. Thanks @SheepishShepherd for the sprite.
Minesweeper Tile - ModTile.TileFrame example
WaspNest - IL Editing beginner guide and example
Example Person trade/quest example - Trade Hive Pack for Wasp Nest
ExampleChest now has a locked style
No more build warnings
ItemID.Sets.SortingPriorityBossSpawns usage examples
ExampleTravelingMerchant - Traveling Merchant Example, thanks @SheepishShepherd
Example Critter Cage

Patreon Thanks
Thanks so much to our Golem level Patrons.
Added Squid and Glory patreon sets
Added Jofairden developer set

Contributor Thanks
Thanks to @DarkLight66, @Leemyy, @SheepishShepherd, @Agrair
Big Thanks to @0x0ade for developing MonoMod.

Install
Download only the zip that corresponds to your operating system. Unzip the download and use the installer. Read the readme.txt if the installer doesn't work.

Don't miss a new tModLoader release

NewReleases is sending notifications on new releases.