Skip to content

Mod Compiling

NalydddNobel edited this page Jun 12, 2023 · 1 revision

Why would I want to compile the mod?

Knowing how to compile the Mod Project would let you try out previous versions, and in-development content. Allowing you to be special and play around with stuff that many people would've not seen. It is also vital if you want to beta test an update or bugfix before it's published as a Beta or Release.

Requirements for Compilation

Matching tModLoader and Aequus versions

Unless you are trying out old versions of Aequus for not-readily available versions of tModLoader, this is a very simple process. Check here for a tutorial on how to install any version of tModLoader.

Otherwise, there are currently 3 Main Branches of Aequus for each Main version of tModLoader. image

main-1.4.4, the Default Branch, is built for the 1.4.4-preview beta of tModLoader.

legacy-1.4.3 is built for the None (1.4.3 stable) beta of tModLoader.

legacy-1.3, is built for the 1.3-legacy beta of tModLoader.

Getting the Aequus Source Code

The source code is publicly available on this Github Repository. Below are 3 common ways to download the source files.

Manual

Download the .zip of the code. You can download the most recent code from the green "Code" button.

image

After downloading the .zip, place it in your Mod Sources folder. This folder is different for 1.3 and 1.4+ versions of tModLoader.

For 1.3, extract the code into Documents\My Games\Terraria\ModLoader\Mod Sources\AQMod

For 1.4, extract the code into Documents\My Games\Terraria\tModLoader\ModSources\Aequus

You now successfully have the Source Code downloaded and placed where tModLoader can read it!

Through Github Desktop

Through Visual Studio

Compiling

This part will only talk about compiling on 1.4, compiling on 1.3 requires activating developer mode and is slightly different overall.

Launch tModLoader, and go to the Workshop tab on the Main Menu

image

Navigate to the Develop Mods tab.

image

Build, or Build+Reload, both will compile you a .tmod file to use. Build+Reload automatically reloads your mods and enables Aequus.

image

If Aequus doesn't appear in this menu, or an error occurs, you might have done a step wrong, or are using the wrong version of tModLoader for that Aequus build.