September's Stable TML release is here with new API features & modernization, polishing, and a wagon of stability improvements.

New Changes' Highlights

The following is a list of the most noteworthy pull requests and commits that have been pushed to 1.4-preview in August, and are now available on the default/stable branch.

Tag Compound Arrays by ExterminatorX99

• You can now easily store and retrieve arrays (including multi-dimensional ones)
• Eg, tag.Get<Vector2[]>("positions")
• Lists and single-dim arrays are serialized identically so if you were previously using GetList<Item>
• (...).ToArray() you can now just Get<Item[]>(...) and similar

More ModPylon Improvements by MutantWafflez

• Fixes a bug where teleports were failing after 10-20 minutes of gameplay due to no NPCs nearby, despite NPCs being nearby.
• Fixes texture bleeding, lack of dust and wrong crystal height in ModPylon.DefaultDrawPylonCrystal
• Adds ModPylon.ModifyTeleportationPosition to prevent teleporting into the air/ground with tiny or giant pylons
• The Crystal Spritesheet has been split into two: the crystal sprite itself and its Smart Cursor highlight, to allow re-using the highlight texture for multiple different pylons.

Porting Notes: #preview-update-log in Discord

Add ModItem.MeleePrefix, ModItem.WeaponPrefix... by Tyfyter

• Adds overridable methods to ModItem to opt-in/out of a vanilla prefix category.
• Use when the default logic for the categories is insufficient

Porting Notes: #preview-update-log in Discord

Fix RangedPrefix not counting throwing by direwolf420

• Makes throwing weapons (those where Item.CountsAsClass(DamageClass.Throwing)) get ranged prefixes by default.
• You can now opt-out of this by overriding RangedPrefix to return false on each throwing weapon you don't want ranged prefixes on.

Swath of Workshop Fixes & Cleanup by Solxanich

• Fixes updates not showing for GoG
• Slightly improves Mod Browser reliability
• Implements an experimental workaround to enable playing & mod browser on Family Share tModLoader on 1.4
• A speed improvement for the Mod Browser is being looked into. No ETA at this time

Localization Updates

• Spanish - Thanks to Wolf-Igmc4.

Bug Fixes

[BUG FIX] Restore attack speed scaling on spears by ThomasThePencil

• Fixes a bug where vanilla spears were getting DamageType = MeleeNoSpeed and thus not scaling with attack speed
• Adds ItemID.Sets.Spears

Porting Notes: #preview-update-log in Discord

Mirsario: Eight Missing Patron Sets
Chicken-Bones: Fix Typo in ModBiome BackgroundColor
TheLuxure: Fix ItemDropDatabase.tml.cs
LandarXT: CLarify where Client.Log can be found
JavidPack: Updates for Example Boss Bag
Chicken-Bones: Fix Destroyer Dropping Skeletron Prime Mask
Chicken-Bones: Fix Deerclops bag in ItemID.Sets
Doombubbles: Fix Feral glove counts as class
Chicken-Bones: Fix TCP buffer overwrites on Mac/Linux
LittleJay1985 and John Whitehead and Mirsario: Mitigate Razer Chroma Chrashes
ExterminatorX99: Fix double enumeration in UIList.AddRange
Chicken-Bones: Allow tModLoader to run under WSL
Antirhinnum: Fix modded UG backgrounds drawing under ocean
Steviegt6: Download all missing mod dependencies on start-up.
Direwolf420: Clear static particle lists on unload

Removed Hooks/Features

Note: Obsolete hooks have been left in for compatibility where possible, but they will be removed in following months, so please move away from these.
As always, tModPorter is available to help providing hints and refactors.

None this Month!

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 do the following:
1. Right click on tModLoader in Steam and select 'Properties...', then 'BETAS';
2. Select the branch you want in the drop-down menu on top;
3. Close the window. You don't need to enter any passwords.
Please note: 1.4-preview versions of TML are intended to only be used by mod developers and testers who know what they're doing. Some popular mods' authors do not intend for their mods to always work with it.

When 1.4.4 tModLoader???

To Be Determined
Once ReLogic has released 1.4.4 to everyone, we will be looking to port to the newest version in a way that aligns with our goal to minimize breaking mods. This may mean a period of delay between Terraria and tModLoader. We recommend taking the chance to play the update in all its glory!
Stay tuned to our Discord for the latest news.

When will tModLoader be 64-bit???

It's already 64-bit!
TML runs in AnyCPU mode with x86_64 natives on .NET 6.0+, using the FNA framework under a singular universal cross-platform release.

I have a 32-bit OS, will it be supported?

Work is finishing up on improving our handling of native libraries, so we can add 32-bit Windows support. If everything goes well in testing, this will be pushed to the stable branch as soon as it is ready, with an announcement in our Discord.

Our Lovely Supporters

Special thanks to the following people who have supported us on Patreon in the last month:

Andrew Spinks, Marco, John Gabriel Wilson, Andrew Nelson, Orian34, Daniel Skoglund Hansen, Peter Doucette, Neuron, SheepishShepherd, Chris Cheeseman, Chris Book, absoluteZero, Steptimus Heap, Hao Wu, Soft Scratch, Toni Stache, Patcheresu, Hunter Amelink, Jeremy Weeks

See you in October!