MOD COMPATIBILITY GUIDE


THE BASICS


Torchlight 2 Rapid Respec has the potential to be compatible with many mods for Torchlight 2, even modded classes! However, you must configure it properly to work with whatever set of mods you happen to have. The purpose of this guide is to help you configure Torchlight 2 Rapid Respec to work with your mods.

Although configuring Torchlight 2 Rapid Respec is a lot simplier than making mods for Torchlight 2, some people will probably find it too complex. If you find this guide overwhelming, you may be able to find configuration files made by other users available on the internet. Mod makers are encouraged to release Torchlight 2 Rapid Respec configuration files to accompany their mods.

The files that need to be changed to configure Torchlight 2 Rapid Respec for mod compatibility can be found in two places: the .txt files located in "<Torchlight 2 Rapid Respec Installation Directory>\Data" and the .png files in "<Torchlight 2 Rapid Respec Installation Directory>\Images". In case you mess up, backups of the .txt files can be found in "<Torchlight 2 Rapid Respec Installation Directory>\Data_Backup.7z". If you fiddle with the image files, you will have to remember to make backups on your own.


GUIDES TO THE .TXT FILES


Important Notes:
  1. The best and easiest way to understand these instructions is to open the existing files and use them as examples.
  2. The .txt files need to be ASCII encoded. Do not use unicode.
  3. Every .txt file ends with a blank line. Do not delete this blank line. It is necessary.
  4. There should not be any other blank lines in the file.
  5. The descriptions of file contents are formatted like so:
    • Text that should appear in the .txt file exactly as it appears here is shown with a blue background.
    • Text that should appear in the .txt file exactly as it appears here, except that you should replace the {} marks and their contents, is shown with a green background, and you should replace {this}.
    • Text that is a description of what should appear in the .txt file has no background, except that types of data (e.g. integer, text string, etc.) are shown with a pink background.
    • Unless otherwise specified, each entry in the description should take up one line in the .txt file, in the order shown.
List of Files


MaxCharLevel.txt

This file tells Torchlight 2 Rapid Respec what the maximum possible character level is in your mod.

What it affects in Torchlight 2 Rapid Respec:
The maximum character level is referenced when creating a new saved build, and for determining if a saved build is valid when you try to load it.

Format of the file:

Notes:

MaxFameLevel.txt

This file tells Torchlight 2 Rapid Respec what the maximum possible fame level is in your mod.

What it affects in Torchlight 2 Rapid Respec:
The maximum fame level is referenced when creating a new saved build, and for determining if a saved build is valid when you try to load it.

Format of the file:

Notes:

FameRanks.txt

This file tells Torchlight 2 Rapid Respec what the names of the fame ranks are in your mod.

What it affects in Torchlight 2 Rapid Respec:
The information in the file is used for displaying your character's fame level.

Format of the file:

Notes:

HPPerVit.txt

This file tells Torchlight 2 Rapid Respec how much hp your character gets per point of vitality in your mod.

What it affects in Torchlight 2 Rapid Respec:
This value is referenced when resurrecting a dead hardcore character.

Format of the file:


Pets.txt

This file tells Torchlight 2 Rapid Respec about the pet types and pet transformations in your mod.

What it affects in Torchlight 2 Rapid Respec:
The information in this file is used for displaying and changing your character's pet's type, transformation type, and scale.

Format of the file:

Format of the 6-line entries:
Rules for pet coloration numbers :
Notes:

Classes.txt

This file lists the character classes in your mod and provides some basic information about them.

What it affects in Torchlight 2 Rapid Respec:
For a class to be recognized by Torchlight 2 Rapid Respec, it must have an entry in this file.

Format of the file:

Format of the 8-line entries:
Details about portraits:
Details about backgrounds:
Notes:

<ClassName>.txt

This file provides most of the information about a given class. If you you want Torchlight 2 Rapid Respec to recognize a new modded class, you need to make a new .txt file for that class. You can name the file anything you want so long as Classes.txt correctly refers to it.

What it affects in Torchlight 2 Rapid Respec:
For a class to be recognized by Torchlight 2 Rapid Respec, this file must exist and contain the necessary information.

Format of the file:

Format of the 4-line entries:
Details about faces and hair:
Details about skills:
Details about skill icons:
Notes:

SkillLevelCaps.txt

This file tells Torchlight 2 Rapid Respec what the maximum possible number of points you can put in any skills is, and what the level progressions are for skills.

What it affects in Torchlight 2 Rapid Respec:
The information in this file controls how many points you can put into any skill (which is also used to determine if a saved build is valid when you try to load it), and how the "obey level based skill caps" function works.

Format of the file:

Format of the level progression entries:
Details about level progressions:
Notes: