Standalone [1.3] tModLoader - A Modding API

[thegamemaster1234]

Someone can correct me if I'm wrong, but I think

public virtual void DrawEffects(PlayerDrawInfo drawInfo, ref float r, ref float g, ref float b, ref float a, ref bool fullBright)

is what you're looking for. The tModloader wiki says, "Allows you to create special effects when this player is drawn, such as creating dust, modifying the color the player is drawn in, etc..."

Nope, doesn't work. I made a loop that iterates over the Main.playerDrawData list which has a Main.NewText call inside it. The NewText never appears, so the only conclusion is that Main.playerDrawData is empty (as a for loop with i=0;i<Main.playerDrawData.Count will not execute if Main.playerDrawData.Count = 0).

 

[Geo]

Right click / altFunctionUse breaks a lot for me

It usually happens when I first load up the game or when I'm clicking too close to my character

Does anyone else have this issue?

 

[colinavvv]

How would I make an NPC face the way is moving, like how spazmatism faces toward you when it does when it does the charge attack.

 

[Devintrainer]

Problem. When I open the .exe that's supposed to open vanilla Terraria, it activates tModLoader anyway. It's only happening after deleting the original vanilla .exe due to a version numbering problem and installing tModLoader again.

 

[Iriazul]

How would I make an NPC face the way is moving, like how spazmatism faces toward you when it does when it does the charge attack.

Allright, for this you first want a direction vector between the player and the boss. This can be obtained like so:

Vector2 dir = Main.player[npc.target].position - npc.position;

Then you want to convert that direction vector to an angle in radians like so:

float rotation = (float)(Math.Atan2(dir.Y, dir.X) / (2 * Math.PI));
npc.rotation = rotation;

This should be all the code for getting the correct rotation.

 

[Geo]

Right click / altFunctionUse breaks a lot for me

It usually happens when I first load up the game or when I'm clicking too close to my character

Does anyone else have this issue?

I've narrowed the problem down to specific circumstances

1 > If your cursor is on a solid block within 3 tiles of your character, you can't activate RMB (right mouse button) item functions
2 > If you try to RMB while your cursor fulfills the first condition and then move the cursor into open space (with RMB held down), it disables RMB completely

 

[thegamemaster1234]

I found something odd. When I use this code, it sometimes causes very strange issues:

public bool bodyTexMatch()
{
    string bodyTexPath = "MyMod/Items/Armor/MyChest_Body";
    string bodyFemTexPath = "MyMod/Items/Armor/MyChest_FemaleBody";

    DrawData data;
    for(int i=0;i<Main.playerDrawData.Count;i++){
        data=Main.playerDrawData[i];
        Main.NewText("Texture name:"+(data.texture.Name ?? ""));
        if(data.texture.Equals(mod.GetTexture(bodyTexPath)) || data.texture.Equals(mod.GetTexture(bodyFemTexPath)))
        {
            return true;
        }
    }
    return false;
}

Code summary: Iterates over the Main.playerDrawData list and checks each value to see if it is either drawing my mod's body texture or female body texture. Returns true if one is found, returns false if one isn't. A Main.NewText call is there for debugging purposes and displays the name of the texture for each DrawData object.
Error: I placed calls to this method in several ModPlayer methods for testing purposes. When I do, the player fails to render and clicking "play" is disallowed. Selecting "New" to create a new character crashes the game with no error log.
I removed the locations in other methods and just kept one in FrameEffects. I was able to obtain this error log:

MyMod/Items/Armor/MyChest_Body
  at Terraria.ModLoader.Mod.GetTexture (System.String name) [0x00000] in <filename unknown>:0 
  at MyMod.MyPlayer.bodyTexMatch () [0x00000] in <filename unknown>:0 
  at MyMod.MyPlayer.FrameEffects () [0x00000] in <filename unknown>:0 
  at Terraria.ModLoader.PlayerHooks.FrameEffects (Terraria.Player player) [0x00000] in <filename unknown>:0 
  at Terraria.Player.PlayerFrame () [0x00000] in <filename unknown>:0 
  at Terraria.Main.DrawMenu (Microsoft.Xna.Framework.GameTime gameTime) [0x00000] in <filename unknown>:0 
  at Terraria.Main.do_Draw (Microsoft.Xna.Framework.GameTime gameTime) [0x00000] in <filename unknown>:0 
  at Terraria.Main.Draw (Microsoft.Xna.Framework.GameTime gameTime) [0x00000] in <filename unknown>:0

Tested both with and without including "MyMod/" at the beginning of the directory. It seems that, for whatever reason, mod.GetTexture is unable to get the texture, even though I am 100% certain that the given texture is in the correct directory, and that there are no misspellings, down to the capitalization. I am also certain that the texture has been loaded, since my chest armor does display on the character.

 

[jopojelly]

Problem. When I open the .exe that's supposed to open vanilla Terraria, it activates tModLoader anyway. It's only happening after deleting the original vanilla .exe due to a version numbering problem and installing tModLoader again.

Well, the installer might have seen a modded Terraria.exe and thought it was the vanilla, renaming it to Terraria v1.3.1.exe even though it technically wasn't. Just have steam verify, then reinstall.

 

[DivermanSam]

Could anyone enlighten me on how to add a second line of text to a set bonus string?

 

[jopojelly]

Could anyone enlighten me on how to add a second line of text to a set bonus string?

"Line 1\nLine 2"....Although I'm not sure if vanilla will handle that correctly.

 

[UberCAKE]

c:\Users\Administrator\Documents\My Games\Terraria\ModLoader\Mod Sources\CakeMod\Items\Armor\SkaediumHUD.cs(43,54) : error CS1026: ) expected

c:\Users\Administrator\Documents\My Games\Terraria\ModLoader\Mod Sources\CakeMod\Items\Armor\SkaediumHUD.cs(43,56) : error CS1002: ; expected

c:\Users\Administrator\Documents\My Games\Terraria\ModLoader\Mod Sources\CakeMod\Items\Armor\SkaediumHUD.cs(43,56) : error CS1525: Invalid expression term ')'

using System.Collections.Generic;

using Terraria;
using Terraria.ID;

using Terraria.ModLoader;


namespace CakeMod.Items.Armor

{
    public class SkaediumHUD : ModItem
    {
        public override bool Autoload(ref string name, ref string texture, IList<EquipType> equips)
        {
            equips.Add(EquipType.Head);
            return true;
        }

        public override void SetDefaults()
        {
            item.name = "Skaedium HUD";
            item.width = 22;
            item.height = 24;
        item.toolTip = "Increases ranged damage by 15%";
            item.value = 10000;
            item.rare = 2;
            item.defense = 11;
        }

        public override bool IsArmorSet(Item head, Item body, Item legs)
        {
            return body.type == mod.ItemType("SkaediumBreastplate") && legs.type == mod.ItemType("SkaediumPants");
        }
        public override void UpdateArmorSet(Player player)
        {
            player.setBonus = "Increases ranged damage by 15%";
            player.rangedDamage += 0.15f; 
        }
        public override void AddRecipes() 
        {
            ModRecipe recipe = new ModRecipe(mod);
            recipe.AddIngredient(null, "SkaediumBar" 15);
            recipe.AddTile(TileID.Anvils);        ;
            recipe.SetResult(this);
            recipe.AddRecipe();
        }
    }
}

 

[jopojelly]

c:\Users\Administrator\Documents\My Games\Terraria\ModLoader\Mod Sources\CakeMod\Items\Armor\SkaediumHUD.cs(43,54) : error CS1026: ) expected

c:\Users\Administrator\Documents\My Games\Terraria\ModLoader\Mod Sources\CakeMod\Items\Armor\SkaediumHUD.cs(43,56) : error CS1002: ; expected

c:\Users\Administrator\Documents\My Games\Terraria\ModLoader\Mod Sources\CakeMod\Items\Armor\SkaediumHUD.cs(43,56) : error CS1525: Invalid expression term ')'

using System.Collections.Generic;

using Terraria;
using Terraria.ID;

using Terraria.ModLoader;


namespace CakeMod.Items.Armor

{
    public class SkaediumHUD : ModItem
    {
        public override bool Autoload(ref string name, ref string texture, IList<EquipType> equips)
        {
            equips.Add(EquipType.Head);
            return true;
        }

        public override void SetDefaults()
        {
            item.name = "Skaedium HUD";
            item.width = 22;
            item.height = 24;
        item.toolTip = "Increases ranged damage by 15%";
            item.value = 10000;
            item.rare = 2;
            item.defense = 11;
        }

        public override bool IsArmorSet(Item head, Item body, Item legs)
        {
            return body.type == mod.ItemType("SkaediumBreastplate") && legs.type == mod.ItemType("SkaediumPants");
        }
        public override void UpdateArmorSet(Player player)
        {
            player.setBonus = "Increases ranged damage by 15%";
            player.rangedDamage += 0.15f;
        }
        public override void AddRecipes()
        {
            ModRecipe recipe = new ModRecipe(mod);
            recipe.AddIngredient(null, "SkaediumBar" 15);
            recipe.AddTile(TileID.Anvils);        ;
            recipe.SetResult(this);
            recipe.AddRecipe();
        }
    }
}

 

[^=^]

Current version: v0.8.1.2
Compatible with Terraria 1.3.1.1
Requires Steam (any platform) or GOG (Windows)
Platforms: Windows, Mac, Linux
Servers currently can only be hosted by Windows​

Spoiler: Table of Contents

1. Introduction
2. Creating Mods
   1. Documentation
   2. Example Mod
   3. Instructions
   4. Help and Resources
   5. tModReader
3. Legal Stuff
4. Credits
5. Download
   1. Direct Download
   2. Open Source
   3. Past Versions
6. Installation
7. Version History
8. The Future
9. News

tModLoader is essentially a mod that provides a way to load your own mods without having to work directly with Terraria's source code itself. This means you can easily make mods that are compatible with other people's mods, save yourself the trouble of having to decompile and recompile Terraria.exe, and escape from having to understand all of the obscure "intricacies" of Terraria's source code. It is made to work for Terraria 1.3+.

tModLoader saves worlds and players separately from vanilla worlds and players. Vanilla worlds and players can be ported to tModLoader worlds and players simply by copying over save files. Modded content is saved in files separate from .plr and .wld files, so you can also port modded players and worlds back to vanilla at the cost of losing your modded stuff.

My goal for tModLoader it to make it simple as possible while giving the modder powerful control over the game. A secondary goal is that anyone who works with tModLoader enough will be able to make their own standalone mods. tModLoader is designed in a way as to minimize the effort required for me to update to future Terraria versions. Feel free to either suggest hooks or push hooks to Github (link in a later section).

Also please don't email me, I almost never check my email.

Back to Top

Documentation
Link to Documentation​

The documentation contains everything you need to know about what tModLoader has to offer. It contains information on all the features, hooks, etc., in tModLoader, complete with descriptions on what everything is used for. Unlike other modding API's, this documentation is kept up-to-date as features are added. Do note that often it will even be ahead of the current released version.

Example Mod​

I use an example mod to test features that I add to tModLoader. You can download a zip file here so you can use it to learn how to make your own things.
Example Mod v0.8.1.2 Download

Instructions​

To create a mod, first run tModLoader. Click on the "Mod Sources" button in the main menu, then click on the "Open Sources" button to open the folder which contains your mod sources. In this folder, create another folder for your mod, then put all of your .cs files and .png files in that folder. When you are done, build your mod from the "Mod Sources" menu . If the mod failed to build, the game will show you one compile error, and give you an option to view all compile errors as a text file. If the mod successfully builds you will be returned to the main menu. If the game crashes or a mod fails to load, the game will display the error and also give you the option to view the error as a text file. Mods that crash on loading are automatically disabled. Mods are automatically enabled when they are built.

If you are using Mac/Linux, it is possible that your mod will fail to build, no matter what you do. In this case, you will have to pre-compile your mod (see documentation on build.txt for more info). Detailed instructions can be found here: http://forums.terraria.org/index.ph...der-a-modding-api.23726/page-526#post-1001200

To distribute a mod, once you have built it, click on the "Mods" button in the main menu, then click on the "Open Mods Folder" button. You will find a file with the .tmod extension for you to distribute.

To install someone else's mod, simply copy the .tmod file to your own Mods folder.

Help and Resources​

http://forums.terraria.org/index.ph...amples-handy-code-snippets.28901/#post-656323

Tile Properties and stuff

I and other people who can help with problems can usually be found in the following chatrooms:
tModLoader Discord chat: https://discord.gg/0ZhxukM0qzlWKEqe
tAPI IRC room: http://www.esper.net/publicirc.php (channel = #tapi)

tModReader​

tModReader is an application that allows you to unpack .tmod files (assuming the modder has the .tmod file set to allow being unpacked).
tModReader v0.8+ Download
tModReader v0.7-v0.7.1.1 Download

Back to Top

Disclaimer and Agreements

• By downloading tModLoader, you agree to everything in this disclaimer and agreements.
• I am not responsible for anything that happens to your computer if you download tModLoader. Common sense stuff.
• Do not use tModLoader to do anything that breaks the Terraria Forums rules. In other words, the rules for making and sharing mods are the same as the rules for sharing mods on these forums; no unobtainble items, no console content, etc.
• Mods uploaded through the Mod Browser are tagged with your Steam username, so we will know if you do something bad.
• You are allowed to mod tModLoader (similar to how tModLoader is a mod of Terraria), given that you provide a link to this thread.

Back to Top

• the tModLoader team
  • @bluemagic123
    
  • @jopojelly
  • @Chicken Bones
• @Itamar - Help with mount support
• @Jeckel - GOG version
• Re-Logic - Creating such a great game to mod
• The tAPI team - Creating tAPI, the 1.2 modding API

Back to Top

Current version: v0.8.1.2
Direct Download Links:
Steam: Windows | Mac | Linux
GOG: Windows

Open Source
In case you want to see how messy my code has become, tModLoader is now open source! Feel free to suggest features either on this thread or over Github.
Github Repository Link

Spoiler: Past Version Downloads

v0.8.1.1: Windows | Mac | Linux - Terraria v1.3.1.1
v0.8.1: Windows | Mac | Linux - Terraria v1.3.1
v0.8: Windows | Mac | Linux - Terraria v1.3.0.8
v0.7.1.1: Windows | Mac | Linux - Terraria v1.3.0.8
v0.7.1: Windows | Mac | Linux - Terraria v1.3.0.8
v0.7: Windows | Mac | Linux - Terraria v1.3.0.8
v0.6: Windows | Mac | Linux - Terraria v1.3.0.8
v0.5: Windows - Terraria v1.3.0.8
v0.4.1: Windows - Terraria v1.3.0.8
v0.4: Windows - Terraria v1.3.0.8
v0.3.2.1: Windows - Terraria v1.3.0.7
v0.3.2: Windows - Terraria v1.3.0.7
v0.3.1.1: Windows - Terraria v1.3.0.7
v0.3.1: Windows - Terraria v1.3.0.7
v0.3.0.1: Windows - Terraria v1.3.0.7
v0.3: Windows - Terraria v1.3.0.7
v0.2.0.1: Windows - Terraria v1.3.0.7
v0.2: Windows - Terraria v1.3.0.7
v0.1.2: Windows - Terraria v1.3.0.6
v0.1.1: Windows - Terraria v1.3.0.5
v0.1: Windows - Terraria v1.3.0.3

If you're on Mac/Linux, you can download Mod Browser mods from here: http://javid.ddns.net/tModLoader/DirectModDownloadListing.php

Back to Top

Instructions​

Once your download is complete, you should have a zipped folder. Unzip this folder. Open the extracted folder and copy all the contents to your Terraria's Steam folder. You may wish to back-up your vanilla Terraria.exe file first. More detailed instructions are in the README file included with the download.

Back to Top

Spoiler: v0.8.1.2 - 6/5/16

-Fixed bug where ModGore code does not autoload
-Added support for dressers
-Fixed bug where jungle temple door can't be unlocked... again
-Fixed a ton of bugs with modded chests and dressers
-Made Wiring.DeActive and Wiring.ReActive public
-Modded maximum life now displays in character selection

Spoiler: v0.8.1.1 - 6/1/16

-Fixed bug where certain modded NPCs disappear upon being hit on expert servers
-Fixed bug where ModProjectile extra AI is not synced between clients/server
-Updated to Terraria v1.3.1.1
-Added the ability to clone new instances of mod entities
-Fixed bug where explosives don't kill tiles on servers

Spoiler: v0.8.1 - 5/27/16

-Servers now sync mods with clients that connect
-Added the ability to send custom net messages between servers/clients
-Added the ability to tamper with net messages
-Added ModifyTransformMatrix hook for drawing
-Updated to Terraria 1.3.1
-I can't tell if I'm forgetting anything...

Spoiler: v0.8 - 4/2/16

Spoiler: Bugfixes

Server Bugs:
-Fixed server sync bug with OnPickup hook for items
-Fixed server bug where chests are not synced properly
-Fixed bug where Steam servers don't work
-Hopefully fixed ItemLoader.GetAlpha crash for clients on servers
-Hopefully fixed NPCs disappearing on servers? Please?
-Fixed server bug where custom item data is not synced
-Fixed server bug where custom town NPCs do not work
Other Bugs:
-Fixed bug where bottom half of long hair does not draw
-Fixed bug where modded tiles crashed the game in early stages of world generation
-Fixed bug where Start Bag cannot contain vanilla items
-Fixed bug where Mod.GetEquipTexture always returns null
-Mods with sounds now load for people without sound cards
-Fixed NPC.CloneDefaults with buffImmune
-Fixed bug where SetMatch hook doesn't work at all

Spoiler: Improvements

-Added the ability to build and debug mods from Visual Studio
-Improved the .tmod file format
-Added the ability to support future .tmod file format changes
-Renamed Other.dll to Mono.dll for noCompile mod-building
-Mods can now reference embedded dlls
-Added the ability to compile mods in C# 6
-Made the Mod Browser more secure
-ItemIO can now save items in general, including vanilla items
-Mods menu now displays how much stuff each mod adds
-Detect and display modder errors in LoadCustomData
-Huge performance improvements
-Changed structure of equipment update code to make it easy to create new equipment slots
-Converted some local world generation variables to static fields
-Made Player.jumpSpeed and Player.jumpHeight public
-Made a bunch of Mount fields public
-Added April Fools (sorry this was late)

Spoiler: Mod Loader stuff

-Added GlobalRecipe and RecipeAvailable hook for recipes
-Added gender parameter to SetMatch hook for items
-Added generic GetModX accessors for reduced redundancy
-Added OnCraft hook for recipes and items
-Added TileCountsAvailable hook for ModWorld
-Added GetMapBackgroundImage hook for ModPlayer
-Added ModifyBuffTip hook for buffs
-Added option to use constructor for cloned ModPlayers
-Added DrawEffects and CanExplode hooks for tiles
-Made code source files hidden from tModReader based on hideCode instead of hideResources

Spoiler: v0.7.1.1 - 2/23/16

-Servers no longer crash on settling liquids or liquid updates
-Pause menu now shows for clients on steam servers
-Added ResetNearbyTileEffects hook for ModWorld

Spoiler: v0.7.1 - 2/22/16

Spoiler: Bugfixes and Crash fixes

-Servers now work (so far only on Windows)
-Fixed mods with music being unable to load on Mac/Linux
-Fixed severe FPS drop when armor is equipped and visible
-Fixed bug where custom data could duplicate and corrupt .tplr
-Fixed bug where ItemInfo is not cloned by Item.Clone
-Fixed bug where "endless" ammo can get prefixes
-Fixed bug where modded chest names start out empty
-Fixed vanilla bug with DrawData.useDestinationRectangle

Spoiler: Features

-Added ModWorld
-Added Initialize hook for ModPlayer and ModWorld
-Added SaveCustomData and LoadCustomData hooks for ModWorld
-Added ModifyWorldGenTasks and PostWorldGen hooks for ModWorld
-Added PostUpdate hook for ModWorld
-Added Dangersense hook for tiles
-Added hideVisual parameter to UpdateAccessory hook for items
-Added DrawBehind hook for projectiles
-Added scroll bar to mod info screen
-Added ability to search in the mod browser
-Added the ability to exclude certain files from .tmod resources
-Compiler warnings are now included in the compiler error log file

Spoiler: v0.7 - 1/11/16

Spoiler: ModPlayer

-Added ModPlayer
-Added ResetEffects and UpdateDead hooks
-Added SaveCustomData and LoadCustomData hooks
-Added SetupStartInventory hook
-Added UpdateBiomes and UpdateBiomeVisuals hooks
-Added UpdateBadLifeRegen, UpdateLifeRegen, and NaturalLifeRegen hooks
-Added PreUpdate, SetControls, PreUpdateBuffs, and PostUpdateBuffs hooks
-Added PostUpdateEquips, PostUpdateMiscEffects, PostUpdateRunSpeeds, and PostUpdate hooks
-Added FrameEffects hook
-Added PreHurt, Hurt, and PostHurt hooks
-Added PreKill and Kill hooks
-Added PreItemCheck and PostItemCheck hooks
-Added GetWeaponDamage and GetWeaponKnockback hooks
-Added ConsumeAmmo, Shoot, and MeleeEffects hooks
-Added OnHitAnything hook
-Added CanHitNPC, ModifyHitNPC, and OnHitNPC hooks
-Added CanHitNPCWithProj, ModifyHitNPCWithProj, and OnHitNPCWithProj hooks
-Added CanHitPvp, ModifyHitPvp, and OnHitPvp hooks
-Added CanHitPvpWithProj, ModifyHitPvpWithProj, and OnHitPvpWithProj hooks
-Added CanBeHitByNPC, ModifyHitByNPC, and OnHitByNPC hooks
-Added CanBeHitByProjectile, ModifyHitByProjectile, and OnHitByProjectile hooks
-Added CatchFish, GetFishingLevel, AnglerQuestReward, and GetDyeTraderReward hooks
-Added DrawEffects, ModifyDrawLayers, and ModifyDrawHeadLayers hooks

Spoiler: Buffs

-Finished buff support
-Added GlobalBuff
-Added Update(NPC) hook
-Added ReApply hooks
-Added canBeCleared and longerExpertDebuff fields

Spoiler: Items

-Revamped equipment texture system (Added EquipTexture)
-Added all vanity-related ModItem hooks to EquipTexture
-Added Clone hook for ModItem
-Added ExtractinatorUse hook
-Added AutoLightSelect hook for ModItem
-Added PostUpdate hook
-Added SetMatch hook
-Added UpdateVanity hook
-Added GetWeaponDamage and GetWeaponKnockback hooks
-Added projOnSwing field
-Added CaughtFishStack, IsQuestFish, IsAnglerQuestAvailable, and AnglerQuestChat hooks
-Added HoldoutOffset and HoldoutOrigin hooks
-Added DrawHands, ArmorDrawColor, and ArmorArmGlowMask hooks
-Added DrawBody and DrawLegs hooks
-Added support for alternate use functions (right-clicking)
-ItemLoader hooks are now called for hotkey presses and right-click-equips
-Added CloneDefaults methods for Item

Spoiler: Tiles

-Added disableSmartCursor field and AutoSelect hook for ModTile
-Added support for torches
-Added SetDrawPositions hook for ModTile
-Added WalkDust and MouseOverFar hooks

Spoiler: Projectiles

-Added hooks for grappling hook projectiles
-Added PreDrawExtras hook for projectiles
-Added drawHeldProjInFrontOfHeldItemAndArms field for ModProjectile
-Added support for contact-damage minion projectiles
-Added CloneDefaults method for Projectile

Spoiler: NPCs

-Added CheckActive and CheckDead hooks for NPCs
-Added DrawEffects hook for NPCs
-Added ResetEffects and UpdateLifeRegen hooks for NPCs
-Added CloneDefaults methods for NPC

Spoiler: Other stuff

-Added PostSetupContent hook for Mod
-Added MidUpdate hook for ModDust
-Added GetLoadedMods method for ModLoader
-Finished music support
-Added support for screen shaders and custom skies
-Custom saved modded item data now persists through the mod being unloaded
-Added DrawLayer and DrawInfo system for custom drawing
-Added EntityInfo system for storing information per entity
-Added the ability to manage mods published on the Mod Browser
-Added sorting buttons to the Mod Browser
-The Mod Browser now checks for tModLoader updates
-Added homepage link and description to mod files
-Added mod info buttons to Mods menu
-Made Terraria.ModLoader.IO.ItemIO public
-Made all hook calls public
-Exception messages now show inner exceptions
-Warnings are now hidden from compile error messages and logs
-Added tModLoader version information to .tmod file structure
-Probably other stuff I forgot

Spoiler: Bugfixes

-Mods now unload in the reverse order they were loaded in
-ModifyHitNPC and ModifyHitByItem for NPCs can now modify damage
-Modded items lying in the world now animate at the correct speed
-The Extractinator no longer accepts every single modded item ever
-Doors no longer cause chaos on servers
-Abstract classes are no longer autoloaded
-Fixed severe vanilla-CraftGroup-related FPS drop
-Word wrap on exception messages and mod info no longer splits up words

Spoiler: v0.6 - 10/24/15

-Proofed ModRecipe methods against modder mistakes
-Mac support
-.cs files are no longer saved as .tmod resources (woops!)
-Made mods compatible cross-platform
-Added support for building .dll files as mods
-Added Unload hook for Mod
-Revamped how minimap handles mod tiles and walls to cut down minimap's RAM usage
-Fixed bug that made .twld files larger than they had to be
-Made some private Projectile fields public
-Fixed bug where Jungle Temple door cannot be unlocked
-Fixed bug with sign GUI
-Fixed bug where cloud saves are not separate from vanilla cloud saves
-Added mod browser - an easy way to upload / download mods
-Basic buff support
-Added support for platform-like tiles
-Fixed bug where miscellaneous custom sounds don't work
-Improved saving for mannequins and item frames with modded items
-Gave ModDusts their own types
-Added hooks for vanity effects for armor sets
-Linux support
-Made a fancy installer
-Partial music support
-Added "Open Mods Folder" button to Mods menu
-Added support for animating vanilla tiles

Spoiler: v0.1 - v0.5

Spoiler: v0.5 - 9/6/15

-Added support for using vanilla textures
-Two mods can no longer share the same internal name
-Mods must now share names with the folder that contains their content
-Added a default mod that will always be enabled
-Loading mods now completely refreshes recipe list
-Added support for storing items whose mods are unloaded
-Added support for custom NPC banners
-Added support for singleplayer chat + ChatInput hook
-Added support for custom sounds
-Improved system for gores
-Added partial support for mounts
-Added support for miscellaneous file resources in .tmod files
-Added CanTownNPCSpawn and CheckConditions hooks for NPCs
-Added TownNPCName and GetChat hooks for NPCs
-Added SetChatButtons and OnChatButtonClicked hook for NPCs
-Added SetupShop and SetupTravelShop hooks for NPCs
-Fixed bug where locked Jungle Temple door can be opened
-Added BuffTownNPC hook
-Added TownNPCAttackStrength, TownNPCAttackCooldown, TownNPCAttackProj, TownNPCAttackProjSpeed hooks for NPCs
-Added TownNPCAttackShoot, TownNPCAttackMagic, and TownNPCAttackSwing hooks for NPCs
-Added DrawTownAttackGun and DrawTownAttackSwing hooks for NPCs

Spoiler: v0.4.1 - 8/24/15

-Added ScaleExpertStats hook for NPCs
-Added PreAI, AI, PostAI, SendExtraAI, and ReceiveExtraAI hooks for projectiles and NPCs
-Added FindFrame and HitEffect hooks for NPCs
-Added aiType field for ModProjectile and ModNPC + animationType field for ModNPC
-Added support for gores
-Added TileCollideStyle, OnTileCollide, PreKill, and Kill hooks for projectiles
-Added PreNPCLoot and NPCLoot hooks for NPCs
-Added BossLoot hook and bossBag field for NPCs
-Made it easier to customize vanilla NPC loot
-Added CanHitNPC and CanHitPvp hooks for items
-Added CanHitNPC, ModifyHitNPC, and ModifyHitNPC hooks for projectiles
-Added CanHitPvp, ModifyHitPvp, and OnHitPvp hooks for projectiles
-Added CanHitPlayer, ModifyHitPlayer, and OnHitPlayer hooks for projectiles
-Added CanHitPlayer, ModifyHitPlayer, and OnHitPlayer hooks for NPCs
-Added CanHitNPC, ModifyHitNPC, and OnHitNPC hooks for NPCs
-Added CanBeHitByPlayer, ModifyHitByPlayer, and OnHitByPlayer hooks for NPCs
-Added CanBeHitByProjectile, ModifyHitByProjectile, and OnHitByProjectile hooks for NPCs
-Added Colliding hook for projectiles and StrikeNPC hook for NPCs
-Added support for NPC map icons
-Added BossHeadSlot, BossHeadRotation, and BossHeadSpriteEffects hooks for NPCs
-Added support for NPC music
-Added GetAlpha, drawOffset, PreDraw, and PostDraw hooks for projectiles
-Added GetAlpha, PreDraw, drawOffsetY, and PostDraw hooks for NPCs
-Added EditSpawnRate, EditSpawnRange, CanSpawn, EditSpawnPool, and SpawnNPC hooks for NPCs
-Added OpenBossBag hook for items
-Added NearbyEffects hook for tiles
-Code is now optimized by compiler
-Deleting players and worlds will now also delete the associated .tplr and .twld files
-Fixed bug where stackable mod items (ie ammo) can have prefixes
-Fixed bug where vanilla NPC display names are wrong
-Fixed bug where open modded doors invalidate houses
-Removed a log write I accidentally left in
-Possibly other stuff I've forgotten

Spoiler: v0.4 - 8/14/15

-Updated to Terraria 1.3.0.8
-Modded world and player data now saves in separate .tplr and .twld files
-Added tModLoader version to main menu

Spoiler: v0.3.2.1 - 8/11/15

-Added support for theoretically infinite recipes
-Improved error-handling

Spoiler: v0.3.2 - 8/11/15

-Added support for crafting groups
-Added PreOpenVanillaBag and OpenVanillaBag hooks for GlobalItem
-Gave tModLoader exe an (uncreative) icon
-Fixed bug where multi-tile subtiles and alternates are not checked
-Fixed bug where Main.tileValue doesn't work for modded tiles
-Added CanKillTile hook for tiles
-Added support for doors, chests, and beds
-Fixed assembly resolve for dll and mod references
-Added GrabRange, GrabStyle, and OnPickup hooks for items
-Bugfixed custom projectiles and NPCs

Spoiler: v0.3.1.1 - 8/7/15

-Finally fixed bug where "Build + Reload" wouldn't unload mods
-Hopefully fixed dll reference system
-Autoloading now occurs before manual loading
-Added README to installation

Spoiler: v0.3.1 - 8/7/15

-Added support for multiple global entities per mod
-Added support for autoloading global entities
-Added support for autoloading multiple EquipTypes per item
-Fixed bug where AddTooltip duplicates tooltips
-Improved dll reference system
-Fixed bug where missing equipment textures crashes the game
-Made WorldGen class public
-Added support for walls
--Added support for wall kill sounds, dust, drops, and kill-related hooks
--Added support for wall map colors and names, and related hooks
--Added ModifyLight and RandomUpdate hooks for walls
--Added AnimateWall, PreDraw, and PostDraw hooks for walls
-Added MouseOver and Slope hooks for tiles
-Added support for very basic projectiles and NPCs (Untested)

Spoiler: v0.3.0.1 - 8/3/15

-Wiring._wireList is now public
-Fixed bug where GlobalItem.SetDefaults did not change vanilla names and tooltips

Spoiler: v0.3 - 8/2/15

-Added build properties to specify display and dependency stuff
--Mod author and version are now build properties
--Added support for mod and dll dependencies
-Modified WorldFile.ValidateWorld so worlds containing modded stuff can load
-Added support for custom tiles (ModTile and GlobalTile)
--Added support for tile kill sounds, dust, drops, and kill-related hooks
--Added support for custom TileObjectData and multi-tile blocks
--Added ModifyLight, SetSpriteEffects, AnimateTile, PreDraw, and PostDraw hooks for tiles
--Added support for tile map colors and names, and related hooks
--Added RandomUpdate and TileFrame hooks for tiles
--Added mineResistance and minPick fields for ModTile
--Added CanPlace and AdjTiles hooks for tiles
--Added RightClick and HitWire hooks for tiles
-Added ConsumeItem hook for ModRecipe
-Added PreDrawInInventory and PostDrawInInventory hooks for items
-Fixed bug with removing custom armor from mannequins
-Improved error-handling for missing textures
-Safeproofed installation process
-Mod.Load is no longer abstract

Spoiler: v0.2.0.1 - 7/26/15

-Removed some log writes that I accidentally left in
-Fixed bug with custom item data saving

Spoiler: v0.2 - 7/26/15

-Mods now build as a single file that includes image resources
-Added support for automatically loading items, etc.
-Updated to Terraria 1.3.0.7
-Added ModItem.AddRecipes hook
-Added support for custom dust through ModDust
-Added CanEquipAccessory hook for items
-Added GlobalNPC with PreNPCLoot and NPCLoot hooks since everyone wants that
-Added ModItem.SaveCustomData and ModItem.LoadCustomData hooks
-Made tooltips easier to add

Spoiler: v0.1.2 - 7/20/15

-Mods that crash the game while loading are now auto-disabled
-Mods are now auto-enabled when they are built
-Added a button to the Mod Sources menu to open the Mod Sources folder
-In-game error messages now appear when the game would have crashed and when a build fails
-Item display names can now be separated from internal names in the SetDefault hook
-Added a ton of hooks for ModItem and GlobalItem
--CanUseItem, UseStyle, UseItemFrame, UseItem, and ConsumeItem
--HoldStyle, HoldItem, and HoldItemFrame
--Shoot, ConsumeAmmo, UseItemHitbox, and MeleeEffects
--ModifyHitNPC, OnHitNPC, ModifyHitPvp, and OnHitPvp
--UpdateInventory, UpdateEquip, UpdateAccessory, IsArmorSet, and UpdateArmorSet
--CanRightClick, RightClick, and Update
--VerticalWingSpeeds and HorizontalWingSpeeds
--GetAnimation (ModItem only), GetAlpha, PreDrawInWorld, and PostDrawInWorld
-Added support for armors and accessories
-Fixed decompile bug that caused minimaps to not save
-Updated to Terraria v1.3.0.6

Spoiler: v0.1.1 - 7/16/15

-Fixed missing .dll bug when building mods
-Split ModLoader class into ModLoader and ItemLoader
-Slightly changed the way modded items are saved
-Updated to Terraria v1.3.0.5
-Added support for prefixes for modded items
-Vastly improved the GUI for building and loading mods
--Menu shows status of loading and building mods
--Added menus that show lists of mods and mod sources
--Added the ability to enable and disable mods
--Added the ability to build mods individually
-Added GlobalItem

Spoiler: v0.1 - 7/8/15

-Support for mods, recipes, and basic items

Back to Top

My goals for the future:

-Add SaveCustomData and LoadCustomData hooks for GlobalItem - Complete
-Add client/server sync hooks for ModWorld - Complete
-Add client/server sync hooks for ModPlayer custom biomes - Complete
-Add hook for item tooltip display
-Make it easier to change or remove recipes
-Add hook for NPC health bars
-Assign Name property for mod textures
-Add more hooks for ModWorld?
-More support for storing unloaded mod content
-Add more hooks for biomes
-Add general game hooks
-Make a bunch of shader stuff public (Does anymore remember what this was exactly?)

Tentative Future Plans
v0.8.2: Forgotten miscellaneous stuff
v0.8.3: Biome-related stuff
v0.8.4: Hooks for mounts and tile entities
v0.8.5: Hooks for interface
Further in the future: JSON support + other stuff I'm forgetting + full release

Spoiler: Known Server Bugs

? = needs more confirmation
-Mac/Linux cannot host servers

Back to Top

(Updated June 1, 2016) v0.8.1.1 has been released! This is a server-bugfix update and works for Terraria v1.3.1.1. http://forums.terraria.org/index.php?threads/1-3-tmodloader-a-modding-api.23726/page-505#post-991994

(Updated June 5, 2016) v0.8.1.2 has been released! Have fun on servers now. http://forums.terraria.org/index.php?threads/1-3-tmodloader-a-modding-api.23726/page-514#post-996210

(Updated June 7, 2016) tModLoader now works for the Windows GOG version! http://forums.terraria.org/index.php?threads/1-3-tmodloader-a-modding-api.23726/page-518#post-997519

Back to Top

Am I the only one that is getting my modded terraria deleted from windows defender when I try to open it?? i was just workin on a mod, i went to test, then BOOM. Not working.

 

[DaRealRoan]

I want to try to make my Own mod but i do not understand how to use the ItemID or the TileID ext.
If someone could help me I would be very happy

 

[Kazzymodus]

I want to try to make my Own mod but i do not understand how to use the ItemID or the TileID ext.
If someone could help me I would be very happy

All the items in the base game are indexed according to those IDs. Because the type (ID) of an item or tile is stored in an integer, you can't just use the item name instead. With the ID classes, you can look up the type that goes with the item and then use it for logic.

So for instance, if you want to add a Dirt Block to an item ingredient, then AddIngredient("DirtBlock"); won't work, because this overload of AddIngredient needs an int to function. You have to use AddIngredient(ItemID.DirtBlock); to give AddIngredient the type it needs.

 

[DaRealRoan]

Thank you but how do I know what I'd I need to use with what item?

 

[Iriazul]

Thank you but how do I know what I'd I need to use with what item?

Here is a list of all items and their variable names you can access from the ItemID class.

 

[UberCAKE]

What's that program you're using?

 

[Kazzymodus]

What's that program you're using?

Looks like Visual Studio to me.

 

[jopojelly]

What's that program you're using?

Yeah, Visual Studio Community. Free. I highly recommend it especially if you find fixing or finding syntax mistakes a bother.