Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Welcome to the tModLoader wiki!
This place serves as a center for guides related to tModLoader. These guides help to teach basic concepts regarding tModLoader modding and should prove as a useful resource to modders. Please feel free to contribute guides for topics not yet covered.
Note that the automatically generated documentation will be ahead of the current released version. There is no guarantee that everything here will be present in the current released version.
You can navigate through the pages through the links in one of the sidebars on the right.
A list of useful resources can be found here
Below is a structured list of wiki pages that you can use to learn more about the API.
If you wish to contribute, please view our contribution guidelines beforehand.
These pages tend to describe certain files or folders.
- Basic tModLoader Usage Guide
- Basic tModLoader Usage FAQ
- Debugging Multiplayer Usage Issues
- Basic tModLoader Modding Starter Guide - Start here if you want to make a mod.
- Basic tModLoader Modding FAQ
These pages aim to aid you to learn how to develop mods properly, how to setup your developing environment etc.
- Developing with Visual Studio
- Developing with Rider
- Developing with Notepad++
- Developing on Mac or Linux
- Why Use an IDE
These guides are easy and should be used if you are new to the API. Their goal is to get you familiar with tML and help you learn certain classes.
- Basic Guide Prerequisites
- Basic ModItem
- About NPC Spawning
- About NPC Drops and Loot
- Autoloading guide
- ModRecipe guide
- Making a basic ammo
- Sounds guide
- ModDust guide
- ModTile guide
- ModTile/TileObjectData guide
- Basic JSON & ModConfigs
- Basic Logging
- Basic Glowmasks
The following guides are more advanced than the easy ones, but not advanced or expert level.
- Intermediate Guide Prerequisites
- Saving and loading using TagCompound
- Intermediate Recipes: RecipeGroups, RecipeFinder/RecipeEditor
- Multiplayer Compatibility: ModPacket
- Modding with C#6
- Modding with C#7
- Git & mod management
The following guides are considered advanced, and should only be attempted if the intermediate level is mastered.
Expert-level guides are not necessarily harder than advanced guides, but they more often cover a particular (difficult) subject. Expert guides should be followed if you are interested in learning about complicated topics or improving your mod's quality.
- Vanilla Ammo IDs
- Vanilla Buff IDs
- Item Class Documentation
- Vanilla Item Field Values
- Vanilla Item IDs
- Vanilla NPC Field Values
- Vanilla NPC IDs
- BannerToNPC Conversions
- Projectile Class Documentation
- Vanilla Projectile AIs
- Vanilla Projectile IDs
- Vanilla Projectile Field Values
- Vanilla Recipes
- Vanilla Sound IDs
- Vanilla Tile IDs
- Tile Class Documentation
- Vanilla Wall IDs
- Vanilla World Generation Steps
- Useful Vanilla Fields
- Useful Vanilla Methods
- Vanilla Interface layers values
- Vanilla Interface Changes
These are pages that we have so far failed to categorize or simply do not belong in one.