Standalone [1.3] tModLoader - A Modding API


tModLoader-Logo1.png

Current version: v0.9.1
Compatible with Terraria 1.3.4.4
Steam Platforms: Windows, Mac, Linux
GOG Platforms: Windows, Mac, Linux

Note: The mod browser will sometimes go down during heavy load. Modders, please also provide your own downloads of your mod for whenever this happens.

  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


YdXk3Ru.png

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.



INqo7SN.png

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.9.1 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

Mod Skeleton Generator (use this to generate files to get you started on your mod)

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: http://discord.me/tmodloader
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



Iujuy01.png

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.



j0Qj6pd.png




rIPriBf.png

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


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

v0.9.0.3: Windows | Mac | Linux - Terraria v1.3.4.4
v0.9.0.2: Windows | Mac | Linux - Terraria v1.3.4.4
v0.9.0.1: Windows | Mac | Linux - Terraria v1.3.4.4
v0.9.0.0: Windows | Mac | Linux - Terraria v1.3.4.4
v0.8.3.5: Windows | Mac | Linux | GOG Windows - Terraria v1.3.3.3
v0.8.3.4: Windows | Mac | Linux | GOG Windows - Terraria v1.3.3.2
v0.8.3.3: Windows | Mac | Linux - Terraria v1.3.3.1
v0.8.3.2: Windows | Mac | Linux | GOG Windows - Terraria v1.3.2.1
v0.8.3.1: Windows | Mac | Linux | GOG Windows - Terraria v1.3.2.1
v0.8.3: Windows | Mac | Linux - Terraria v1.3.2.1
v0.8.2.1: Windows | Mac | Linux - Terraria v1.3.1.1
v0.8.2: Windows | Mac | Linux - Terraria v1.3.1.1
v0.8.1.2: Windows | Mac | Linux | GOG Windows - Terraria v1.3.1.1
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



xC00PcG.png

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.



HiViKx8.png

-Mac/Linux can now host servers
-Added support for modded tile entities
-Added PreHitWire hook for GlobalTile
-Added CanExplode hook for walls
-Added broadcast parameter to Mod.ChatInput
-Fixed bug where defender forge can't save modded items
-Minor fixes
-Fixed saving for Item Frames containing mod data
-Fixed GlobalItem Saving
-Fixed gores not disappearing
-Fixed Background flicker on reload
-Fixed DrawLifebar server bug
-Fixed Balloon Offset Bug
-Server command: ModList
-Fixed bug where modded NPC banner drops crash the game
-Fixed bug where worlds with modded walls can't load
-Changed save format for modded data of players and worlds
-Mod: Support for SpriteFonts packaged in Mods
-ModItem/GlobalItem: PreDrawInWorld and PostDrawInWorld now have "int whoAmI" as a parameter
-ModProjectile/GlobalProjectile: List<int> drawCacheProjsOverWiresUI added to DrawBehind hook
-ModProjectile/GlobalProjectile: CanCutTiles hook
-ModWorld: PreUpdate hook
-ModBrowser: Now displays time since last update
-ModBrowser: More responsive
-ModPacks: Delete Button
-ModPlayer: PlayerConnect, PlayerDisconnect, OnEnterWorld hooks
-ModNPC/GlobalNPC: BossHeadRotation bug fix
-ModHotKey: Hotkeys have been redesigned. HotKeyPressed no longer recommended to be used
-ModHotKey: Hotkey key bindings will now persist correctly
-Settings Menu: Options available.
-TexturePacks: Instead of the vanilla approach of 1 texture pack named Texture Pack.zip, all .zip in Terraria\ModLoader\TexturePacks will be loaded
-ModSources Menu: Now sorted by latest built
-IDs: New Generic overloads for getting IDs for various things
-All ModifyHit hooks related to Projectiles: Added a hitDirection parameter
-tModLoader: updated to Terraria 1.3.4.4 codebase
-Updated to Terraria 1.3.3.3
-Added mod packs - ability to enable/disable groups of mods at once
-Added ability to search mod browser by author
-Added ModifyInterfaceLayers hook
-DrawLayers can now modify the DrawInfo parameter
-Added whoAmI parameter to world-drawing hooks for items
-Made Main._drawInterfaceGameTime public
-Fixed bug where custom tile kill check uses liquid placement check
-Added modpath option for dedicated server command line
-Minor fixes and improvements
-Updated to Terraria 1.3.3.2
-Fixed bug where modded trees get drawn incorrectly
-Fixed a bug with modded walls beyond a certain ID
-Added ability to change modded tree top/branch frames
-Added fishing power parameter to ModPlayer.CatchFish
-Fixed bug where return value of TileLoader.Slope is ignored
-buildIgnore now accepts both slash types for directories
-Updated to Terraria 1.3.3.1
-Hopefully fixed Mac/Linux not being able to host servers
-Fixed bug where modded buffs beyond a certain ID cannot be synced
-Security for Mod Browser
-Minor fixes
-Fixed bug where modded items disappear upon sorting
-Added a weak mod dependency system
-Added support for biome backgrounds
-Added support for custom water and waterfall styles
-Added support for custom saplings, trees, palm trees, and cacti
-Added PostDrawInterface, PostDrawFullscreenMap, and PostUpdateInput hooks
-Added clientClone, SyncPlayer, and SendClientChanges hooks for ModPlayer
-Added ModifyZoom and ModifyScreenPosition hooks
-Added updateType field for ModGore
-Made all classes in Terraria.GameContent.UI.Elements public
-Made Main.rare public
-Added modpath option for dedicated server config
-Added search filter to Mods menu
-Disabled buggy hotbar scrolling during auto select
-Fixed bug where music boxes cannot record custom music
-Fixed world generation bugs involving modded tiles
-Updated to Terraria 1.3.2.1
--Added support for alternate ModNPC textures
--Added UsesPartyHat hook for ModNPC
-Added PreReforge and PostReforge hooks for items
-Added CustomBuffTipSize and DrawCustomBuffTip hooks for GobalBuff
-Added CanDamage and ShouldUpdatePosition hooks for projectiles
-Added Clone hooks for entity infos
-Fixed bug where ModifyBuffTip is not called from inventory menu
-Fixed bug where modded NPCs aren't listed under banner buff tooltip
-Fixed bug where ModItem and EntityInfo are not initialized during mod-loading
-Fixed bug where GlobalItem saving hooks are called for empty item slots
-Made Wiring._currentWireColor public
-Added SaveCustomData and LoadCustomData hooks for GlobalItem
-Added client/server sync hooks for ModWorld
-Added client/server sync hooks for ModPlayer custom biomes
-Added hook for complete control over all item tooltips
-Added CanUseAbility and UseAbility hooks for ModMountData
-Added RecipeFinder and RecipeEditor for easy recipe editing
-Added hook for drawing NPC health bars
-Support for preserving unloaded mod tiles
-Name property for mod textures are now assigned
-Animations for opening/closing modded chests
-Made Main.DrawHealthBar public
-Made Terraria.Graphics.Shaders.GameShaders public
-Fixed bug where ConsumeItem is called for wrong item
-RecipeGroup bugfixes
-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
-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
-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...
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
-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)
-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
-Servers no longer crash on settling liquids or liquid updates
-Pause menu now shows for clients on steam servers
-Added ResetNearbyTileEffects hook for ModWorld
-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
-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
-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
-Finished buff support
-Added GlobalBuff
-Added Update(NPC) hook
-Added ReApply hooks
-Added canBeCleared and longerExpertDebuff fields
-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
-Added disableSmartCursor field and AutoSelect hook for ModTile
-Added support for torches
-Added SetDrawPositions hook for ModTile
-Added WalkDust and MouseOverFar hooks
-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
-Added CheckActive and CheckDead hooks for NPCs
-Added DrawEffects hook for NPCs
-Added ResetEffects and UpdateLifeRegen hooks for NPCs
-Added CloneDefaults methods for NPC
-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
-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
-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
-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
-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
-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
-Added support for theoretically infinite recipes
-Improved error-handling
-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
-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
-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)
-Wiring._wireList is now public
-Fixed bug where GlobalItem.SetDefaults did not change vanilla names and tooltips
-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
-Removed some log writes that I accidentally left in
-Fixed bug with custom item data saving
-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
-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
-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
-Support for mods, recipes, and basic items



PjZa7pT.png

My goals for the future:

-Make escape except out of Mods menu, etc. - Complete
-Add hook for changing useTime and useAnimation - Complete
-Add NetSendIntercept hook - Complete
-Add hook to override player physics
-Fix bug where modded backgrounds aren't captured by camera mode
-Add support for grass block framing - Complete
-Add hook for manually calling NPCLoot
-Add PreSave hook
-Add PreUpdate hook for ModWorld
-Add hook for bait consumption
-Add global hook for dust
-Add support for custom wing framing
-Add music priority system
-Add option to delete unloaded save content
-More mount hooks
-Add more general game hooks?

Tentative Future Plans
v0.9.2: Hooks for mounts
v0.9.3: Hooks for interface
v0.9.4: ModOptions
Further in the future: JSON support + other stuff I'm forgetting + full release



dwFwaFN.png

(Updated December 24, 2016) v0.9.1 has been released! Mac/Linux computers can now host&play servers! https://forums.terraria.org/index.p...der-a-modding-api.23726/page-749#post-1164603

(Updated December 11, 2016) v0.9.0.0 has been released for Terraria 1.3.4.4! http://forums.terraria.org/index.ph...der-a-modding-api.23726/page-724#post-1152991
Here is a guide on porting over your mods: https://docs.google.com/document/d/1pytx2sCLq56qXZLIQ_mKzv0_-Nf6E3hncExL8Mf9OJ8/edit?usp=sharing

(Updated September 2, 2016) I haven't done anything in a while and things will probably stay like this for the foreseeable future, but I will keep updating tModLoader to future Terraria versions as fast as possible. Also remember that tModLoader is open source and that you can contribute in the meantime! http://forums.terraria.org/index.ph...der-a-modding-api.23726/page-638#post-1082664

The only download link that works for me makes me install a file called "tModLoeader-master" and it's just files that you don't need for tmod loader to work with steam on windows?
 
windows download link is not currently working

The windows github download for v0.9.1 is not working atm. Is there another way to download?

same, i'm not able to download

It seems to be github. so I am trying to see if there is some other place we can download it from in the meantime. Maybe someone could upload it to some other site and share the link until the github link is fixed?
Hmm, the download link is working just fine for me. It's possible Github maye have had some downtime.
Link: https://github.com/bluemagic123/tModLoader/releases/download/v0.9.1/tModLoader.Windows.v0.9.1.zip
 
Is the browser currently not working in the current version? I can't seem to use it but I know I have in the past.
 
is anyone else having a problem when you load your mods then you run out of memory and you have to reload till you get lucky and they all load and the weird thing is my old laptop has not done this now my new one does plus i also i have to go to fullscreen if not when i make terraria larger the screen turns white
 
the memory problem says an error occurred while loading this is were they would say the mod then it says this mod has automatically been disables. insufficient memory to continue the execution of the program
at microsoft.xna.framework.helpers.get exception from result (Ulnt32 result)
at microsoft.xna.framework.graphics.texture2d..ctor(graphicsdevice graphicsdevice, stream stream,int32 width, iint32 height
xnalmageoperation operation)
at terraria.modloader.mod.autoload()
at terraria.modloader.modloader.do_load(object threadcontext) and done
 
is anyone else having a problem when you load your mods then you run out of memory and you have to reload till you get lucky and they all load and the weird thing is my old laptop has not done this now my new one does plus i also i have to go to fullscreen if not when i make terraria larger the screen turns white
Run out of memory....
how much GB you got?
 
yeah its weird i tried using my 960m and my intel graphics and my ssd is all most filled
[doublepost=1488398092,1488398070][/doublepost]but nothing worked
[doublepost=1488398502][/doublepost]my computer uses around 2gigs
 
I've noticed multiple instances of the same mod popping up for new update patches, will the affected mods take twice as much space in my computer if I download the new patches?
[doublepost=1488400964,1488400832][/doublepost]A filter for mods based on last updated dates sounds cool too, but what I mean is like a label on the mod saying when was it last updated.
 
Weird question, and I've done a bit of searching without much luck... for some odd reason, in multiplayer, none of the NPCs, modded or otherwise, can target enemies. It leads to them being murdered in droves by anything getting in. Can anyone tell me what's up with that?

Edit: That is to say, running the tmodloader server file. Haven't tried host and play yet.

Edit2: Same thing, NPCs throw their attacks, they hit, but the attacks pass right through. I'm sure I'm missing something simple.
 
Last edited:
How is a safe way to uninstall tmodloader? Not that I hate you product, just wanted to try some things without it.
 
How is a safe way to uninstall tmodloader? Not that I hate you product, just wanted to try some things without it.
just delete the modded exe. If you used the installer you should have vanilla still in your install directory called Terraria_1.3.4.4.exe. You can actually just launch that if you want to play vanilla for a while.

If you don't have the vanilla exe anymore, use steam to verify integrity of the game and it will redownload it.

C:\Program Files (x86)\Steam\steamapps\common\Terraria
 
does anyone know how to make a Clone of a Bosses projectile friendly? trying to make a Lunatic Cultist Lighting Magic weapon.
Code:
using Microsoft.Xna.Framework;
using Terraria;
using Terraria.ID;
using Terraria.ModLoader;

namespace Trelamium.Projectiles
{
public class Lighting: ModProjectile
{
public override void SetDefaults()
{
projectile.CloneDefaults(ProjectileID.CultistBossLightningOrbArc);
projectile.name = "Lightning";
aiType = ProjectileID.CultistBossLightningOrbArc;
}

public override bool PreKill(int timeLeft)
{
projectile.type = ProjectileID.CultistBossLightningOrbArc;
return true;
}

public override bool OnTileCollide(Vector2 oldVelocity)
{
for (int i = 0; i < 5; i++)
{
int a = Projectile.NewProjectile(projectile.Center.X, projectile.Center.Y - 16f, Main.rand.Next(-10, 11) * .25f, Main.rand.Next(-10, -5) * .25f, ProjectileID.Starfury, (int)(projectile.damage * .5f), 0, projectile.owner);
Main.projectile[a].aiStyle = 1;
Main.projectile[a].tileCollide = true;
}
return true;
}
}
}
 
does anyone know how to make a Clone of a Bosses projectile friendly? trying to make a Lunatic Cultist Lighting Magic weapon.
Code:
using Microsoft.Xna.Framework;
using Terraria;
using Terraria.ID;
using Terraria.ModLoader;

namespace Trelamium.Projectiles
{
public class Lighting: ModProjectile
{
public override void SetDefaults()
{
projectile.CloneDefaults(ProjectileID.CultistBossLightningOrbArc);
projectile.name = "Lightning";
aiType = ProjectileID.CultistBossLightningOrbArc;
}

public override bool PreKill(int timeLeft)
{
projectile.type = ProjectileID.CultistBossLightningOrbArc;
return true;
}

public override bool OnTileCollide(Vector2 oldVelocity)
{
for (int i = 0; i < 5; i++)
{
int a = Projectile.NewProjectile(projectile.Center.X, projectile.Center.Y - 16f, Main.rand.Next(-10, 11) * .25f, Main.rand.Next(-10, -5) * .25f, ProjectileID.Starfury, (int)(projectile.damage * .5f), 0, projectile.owner);
Main.projectile[a].aiStyle = 1;
Main.projectile[a].tileCollide = true;
}
return true;
}
}
}
Try adding the following to your SetDefaults hook.
Code:
projectile.friendly = true;
projectile.hostile = false;
Though I'm not sure if that exact combination will work. Experiment with different combinations of true and false if it doesn't work.
 
Try adding the following to your SetDefaults hook.
Code:
projectile.friendly = true;
projectile.hostile = false;
Though I'm not sure if that exact combination will work. Experiment with different combinations of true and false if it doesn't work.
ive tried that before, even though i changed it to friendly, it is still hostile.
 
i kind of had trouble with changing out the older ver of tmod and well i dont know what is ok to delete and whats not can anyone help? (i did buy the game off steam if that helps) i still want to play modded and i too had that weird lag problem but it only did it on the modded ver even if no mods where being used. normal terraria runs fine its really the reason i came to this forum to see if there was a fix then i remembered the mess the files are in form my attempt to update tmod loader >,< i did have to use the verify thing to get the game to run the none modded ver but due to the mess i cant play modded
 

Attachments

  • tmodloader 1.PNG
    tmodloader 1.PNG
    51.9 KB · Views: 236
i kind of had trouble with changing out the older ver of tmod and well i dont know what is ok to delete and whats not can anyone help? (i did buy the game off steam if that helps) i still want to play modded and i too had that weird lag problem but it only did it on the modded ver even if no mods where being used. normal terraria runs fine its really the reason i came to this forum to see if there was a fix then i remembered the mess the files are in form my attempt to update tmod loader >,< i did have to use the verify thing to get the game to run the none modded ver but due to the mess i cant play modded
Well, if you are concerned about all the extra files: This is the install directory, you can just delete it all, then use steam to get a fresh vanilla install in there with the verify cache thing. Once Vanilla is restored, just run the tmodloader installer.
 
Back
Top Bottom