HELP FILE

THE BASICS

Torchlight 2 Rapid Respec is an unofficial, fan-made respec editor for Torchlight 2.

• Free, unlimited respec of attributes, skills, and spells.
• Faster (and more forgiving of mistakes) than the in-game interface with a respec mod, especially for high-level characters.
• Optional character legitimacy controls to restrict build possibilities to only those that could have been produced through normal gameplay. (If you use these, your character will not be labeled as a cheater.)
• Guild-Wars-style load and save builds with a single click. (A customizable scaling and breakpointing algorithm adapts builds across different character and fame levels.)
• Guilds-Wars-style build codes for sharing builds over forums or in-game chat.
• Aesthetic controls -- change your character's name, sex, face, hairstyle, hair color, bandana color (Outlander), pet name, and pet type.
• Cheats -- give your character more gold, clone your character, change single-player difficulty level, change NG cycle, resurrect dead hardcore characters, promote a softcore character to hardcore, and (resurrect and) demote a hardcore character to softcore. (Your character will not be labeled as a cheater.)
• Remove the "cheater flag" caused by console use.

• Version 1.03 is compatible with Torchlight 2 patches 1.12.X.7 through 1.16.X.3. It will remain compatible for all future versions retaining .svb version number 0x42, and quite possibly beyond that.
• Spell/tome respec is still experimental. It may improve in future versions.
• Level-based skill caps don't always match the game. This is because the skill caps for certain skills are buggy in the game. There's nothing I can do about this.
• The "unequip items if stats fall too low" (non-)feature from the beta is gone and probably never returning.

• Version 1.03:
  • Fixed bug that caused "Parse Error: Never found huge pre-pet FF block" for some high-level characters.
  • Added new EXPERIMENTAL spell respec feature. In v1.03 spell respec only works for players (not pets) and can only add spells if you have blank slots.
  • Build codes have been further compressed from 76 characters down to 72 characters. There is backwards compatibility for old build codes.
  • Fixed bug with file selector for saved build codes initially pointing to the wrong directory.
  • Minor UI improvments such as tab order fixes and typo correction.
• Version 1.02:
  • Support for extra-long names. Rather than disallowing any name longer than Torchlight 2's name length limit (15 characters), name change/clone features will now warn that a name exceeds the limit and let you choose whether to proceed. (Use extra-long names at your own risk)
  • Fixed bug with name change/clone sometimes not working if new name was not the same length as old name.
  • Fixed bug with pet name sometimes being incorrectly detected as "yyyyyyyyyy."
  • Improved parser's ability to detect when a parse error has occured. (Leads to more error messages, but fewer corrupted save files.)
• Version 1.01: Fixed bug with female → male sex change.
• Version 1.00b: Fixed bug where manual update check incorrectly thought it was v0.99.
• Version 1.00:
  • New features:
    • Added cheat option to remove "cheater flag" for console use.
    • Added cheat option to change newgame cycle.
    • Added persistent default save directory choice to the options menu.
    • Options menu now pops the very first time the program is run so user can make choices about default save directory and automatic update checks.
  • Bug Fixes:
    • Fixed major crash bug. (This should fix ALL instances of "the program crashes when I try to do X.")
    • Fixed bug with softcore/hardcore change not working properly with NG+ characters.
    • Fixed sex-change file corruption bug. Face and hairstyle are now both set to type 0 when changing sex.
    • User is now outright prevented from attempting to change pet type when pet is transformed.
    • Expanded character set for name change features to include ` ! @ # $ % ^ & * ( ) - = _ + [ ] { } \ | ; : ' " , . < > / ?
    • Fixed bug with Outlander hair/bandana colors.
• Version 0.99: Initial release.

TABLE OF CONTENTS

BASIC USAGE

1. Click "Load Character" on the Load tab (or "Load Character Save File" from the "File" menu), then select the character you want to respec.
2. Use the "Attributes" tab, the "Skill Tab X" tabs, and Spells tab to adjust the character's attributes, skills, and spells to your liking.
3. Press "Respec" in the main window (or "Respec Character Save File" in the "File" menu).

1. Click "Load Character" on the "Load" tab (or "Load Character Save File" from the "File" menu), then select the character whose build you want to save.
2. Use the "Attributes" tab, the "Skill Tab X" tabs, and Spells tab to adjust the character's attributes, skills, and spells to your liking.
3. Press "Save Build" in the main window (or "Save Build to a Saved Build File" in the "File" menu).

1. Click "Load Character" on the "Load" tab (or "Load Character Save File" from the "File" menu), then select the character you want to apply a build to.
2. Click "Load and Apply Build" on the "Load" tab (or "Load and Apply Saved Build" from the "File" menu), then select a saved build file or paste a build code into the box.
3. Use the "Attibutes," "Skill Tab X," and "Spells" tabs to adjust the character's attributes, skills, and spells to your liking.
4. Press "Respec" in the main window (or "Respec Character Save File" in the "File" menu).

1. Either:
   • Click "Load Character" on the "Load" tab (or "Load Character Save File" from the "File" menu), then select the character whose build you want to share; or
   • Click "Load Build for Editing" on the "Load" tab (or "Load Saved Build for Editing" from the "File" menu), then select a saved build you want to share.
2. Click "Show Build Code" in the main window (or "Show Build Code" from the "File" menu), then copy the build code and paste it to forums, in-game chat, e-mail, or whatever you want to do with it.

1. Click "New Build for Editing" on the "Load" tab (or "Create New Saved Build" from the "File" menu), then specify the class, level, and fame level you want to use.
2. Use the "Attributes" tab, the "Skill Tab X" tabs, and Spells tab to adjust the build's attributes, skills, and spells to your liking.
3. Press "Save Build" in the main window (or "Save Build to a Saved Build File" in the "File" menu).

1. Click "Load Build for Editing" on the "Load" tab (or "Load Saved Build for Editing" from the "File" menu), then then select a saved build file or paste a build code into the box.
2. Use the "Attributes" tab, the "Skill Tab X" tabs, and Spells tab to adjust the build's attributes, skills, and spells to your liking.
3. Press "Save Build" in the main window (or "Save Build to a Saved Build File" in the "File" menu).

THE MAIN SCREEN/LOAD TAB

If the default directory is not correct, press "Change Directory" (or type a new directory on the "Save Directory" line) to select the directory where your save files are located.
Click on a character name to select that character and display a preview of that character's class, portrait (gender), level, and fame level.
Click "OK" to load the selected character.
Click "Cancel" to cancel.

Load and Apply Build
The "Load and Apply Build" button launches the saved build selection dialog.
This dialog applies the selected saved build to the currently loaded Torchlight 2 character.
An error pop-up will be displayed if no Torchlight 2 character is currently loaded.
Any character legitimacy controls enabled at the time the build is applied will affect how the build is applied.

To load and apply a saved build from a file, click "Choose a File" (or type the file path on the "Choose a File..." line), then click "OK (Load from File)."
To load and apply a saved build from a build code, paste the build code into the box, then click "OK (Use Build Code)."
Click "Cancel" to cancel.

Load Build for Editing
The "Load Build for Editing" button launches the saved build selection dialog.
This dialog loads a saved build file (.txt) into Torchlight 2 Rapid Respec so that it may be edited.
Remember to save your build after editing.

To load and apply a saved build from a file, click "Choose a File" (or type the file path on the "Choose a File..." line), then click "OK (Load from File)."
To load and apply a saved build from a build code, paste the build code into the box, then click "OK (Use Build Code)."
Click "Cancel" to cancel.

New Build for Editing
The "New Build for Editing" button launches the new build dialog.
This dialog creates a new saved build with the class, level, and fame level you specify.
If you select a level greater than 1 before selecting a fame level greater than 1, an appropriate fame level will be estimated. You may still change the fame level if you dislike the estimate.
Remember to save your build after creating and editing it.

Preview Panel
The preview panel displays the name, class, portrait (gender), level, and fame level of the currently loaded Torchlight 2 character or saved build.
Saved builds display the name "Create/Edit a Saved Build" and have a random gender.

Respec
The "Respec" button rewrites the currently loaded Torchlight 2 character save file (.SVB) so that the character has the currently selected attributes, skills, and spells.
An error pop-up will be displayed if no Torchlight 2 character save file is loaded.
If "Backup save files before respeccing" is checked, a backup directory will be created in the same location as the currently loaded Torchlight 2 character save file, and a backup of the save file will be created.
It is strongly recommended that you leave "Backup save files before respeccing" checked at all times.

Save Build
The "Save Build" button launches a file selection dialog.
A saved build file (.txt) is created from the currently selected class, level, fame level, attributes, skills, and spells.
An error pop-up will be displayed if neither a Torchlight 2 character save file (.SVB) nor a saved build is loaded.

Show Build Code
The "Show Build Code" button displays a dialog whence you can copy/paste the build code for the currently selected class, level, fame level, attributes, skills, and spells.
Build codes are 72-character ASCII (plain text) strings that contain all of the data for a particular build.
An error pop-up will be displayed if neither a Torchlight 2 character save file (.SVB) nor a saved build is loaded.

Character Legitimacy Controls
These settings are designed to restrict build possibilities to only those that could have been produced through normal gameplay.
Using these settings should prevent your character from being flagged as a cheater.

THE ATTRIBUTES TAB

"Unallocated Attribute Points" displays the current number of attribute points not assigned to any attribute.
The "Zero All Attributes" button will deallocate all assigned attribute points.
If "Obey class-based attribute floors" is enabled, the "Zero All Attributes" button will reset all attributes to their starting values for that class rather than to zero.
For each attribute, the number in the box on the left shows the attribute points originally assigned to that attribute by the currently loaded Torchlight 2 character file or saved build, and the number in the box on the right shows the new value.
You can change the number of points assigned to each attribute by clicking the corresponding +/- buttons or typing the new value in the box on the right.

The "scaled"/"exact" setting only matters when saving a build file or generating a build code. This setting controls how Torchlight 2 Rapid Respec accounts for level differences between a saved build and the character it is applied to. When "exact" is selected for an attribute, Torchlight 2 Rapid Respec attempts to allocate exactly that many points to that attribute. This is useful for attributes that need to be just high enough to equip a certain item, and no higher. When "scaled" is selected, Torchlight 2 Rapid Respec attempts to scale the number of points allocated to that attribute so that it receives the same percentage of available attribute points, regardless of how many attribute points the character has.

The "Obey class-based attribute floors" setting has a profound effect on the way "scaled" attributes are applied. When "Obey class-based attribute floors" is disabled, Torchlight 2 Rapid Respec looks at each attribute's share of all attribute points. When "Obey class-based attribute floors" is enabled, Torchlight 2 Rapid Respec instead looks each attribute's share of attribute points earned since level 1.

"Obey class-based attribute floors" is enforced if it is enabled at the time the build is loaded.

THE SKILLS TABS

"Unallocated Skill Points" displays the current number of skill points not assigned to any skill.
The "Zero All Skills" button will deallocate all assigned skill points.
If "Keep one point in starter skill" is enabled, the "Zero All Skills" button will reset the starter skill to one rather than to zero.
For each skill, the number in the box on the left shows the skill points originally assigned to that skill by the currently loaded Torchlight 2 character file or saved build, and the number in the box on the right shows the new value.
You can change the number of points assigned to each skill by clicking the corresponding +/- buttons or typing the new value in the box on the right.

The "scaled"/"exact" setting only matters when saving a build file or generating a build code. This setting controls how Torchlight 2 Rapid Respec accounts for level differences between a saved build and the character it is applied to. When "exact" is selected for a skill, Torchlight 2 Rapid Respec attempts to allocate exactly that many points to that skill. This is useful for skills that need to be just high enough to reach a certain breakpoint, and no higher. When "scaled" is selected, Torchlight 2 Rapid Respec attempts to scale the number of points allocated to that skill so that it receives the same percentage of available skill points, regardless of how many skill points the character has.

When "Obey level-based skill caps" is enabled, you will not be able to assign more points to a skill than you ordinarily could at your character's level.

THE SPELLS TAB

Spell respec is EXPERIMENTAL in version 1.03. If you want to use this experimental feature, please make sure that "Backup save files before modifying them" is enabled. If you don't want to use this feature, simply leave all spells set to "<NO CHANGE>."

In version 1.03, spell respec only works for players, not pets. Pet spell respec may be implemented in a future version.

In version 1.03, you can only add spells if you have blank slots. If you want to change the spells that a character already has, you will have to remove those spells in Torchlight 2, then use Torchlight 2 Rapid Respec to add the skills you want. If you remove less than all of that character's spells, you may wish to load and save the character one extra time in Torchlight 2 before using Torchlight 2 Rapid Respec. This will make sure that spells are properly shuffled into the left-most positions.

You will be automatically prevented from equipping two copies of the same spell, or two different ranks of the same passive spell.

If the "Obey spell level requirements" character legitimacy control is enabled, you will be prevented from equipping spells that your character does not meet the level requirement for. If your character meets the requirement for a lower rank of the same spell, the lower ranked version will be used instead. This setting is enforced each time you try to change a spell or its rank, and when a build is applied to a character.

Spells marked with "(cheat)" in the drop-down menu do not normally exist in Torchlight 2. You can equip them via Torchlight 2 Rapid Respec, but it's cheating...
Spells marked with "(cheat, DNW)" in the drop-down menu do not normally exist in Torchlight 2. They also DO NOT WORK. You can equip them via Torchlight 2 Rapid Respec, but they will do nothing when clicked besides consuming mana and cast time.

Sometimes a new spell does not appear the first time a character is loaded in Torchlight 2, especially if the existing spells were not left-shuffled prior to using Torchlight 2 Rapid Respec. Before restoring from backup, try saving and reloading the character in Torchlight 2.

THE AESTHETICS TAB

The "Aesthetics" tab allows you to change some visual aspects of your character that do not affect gameplay.
The features of the "Aesthetics" tab only work if you have loaded character from a Torchlight 2 save file.

Change Name
Your character's current name is displayed in the top box. To change your character's name, enter a new name in the bottom box and press "Change Name." If you enter a name longer than Torchlight 2's native name length limit (15 characters), a pop-up will ask if you want to continue. What, if any, side-effects can be caused by an extra-long name is unknown. An error pop-up will be displayed if the name you choose contains illegal characters. The .SVB and .restore files will be renamed to match the new character name.

Change Sex
Your character's current sex is displayed in the top box. To change your character's sex, press "Change Sex."

Your character's face will be changed to the first face variant for the new sex. The same is true for the hairstyle. Hair color (and bandana color for Outlanders) is retained.

Change Appearance
Your character's current face, hair style, hair color, and bandana color (for Outlanders only) are displayed in the top boxes. To change your character's appearance, select new options in the drop-down boxes and press "Change Appearance."

Change Pet Name
Your character's pet's current name is displayed in the top box. To change your character's pet's name, enter a new name in the bottom box and press "Change Pet Name." If you enter a name longer than Torchlight 2's native name length limit (15 characters), a pop-up will ask if you want to continue. What, if any, side-effects can be caused by an extra-long name is unknown. An error pop-up will be displayed if the name you choose contains illegal characters.

Change Pet Type
Your character's pet's current type (both species and color) is displayed in the top box. To change your character's pet's type, select a new type from the drop-down box and press "Change Pet Type."

If your pet is currently transformed due to eating a fish, Torchlight 2 Rapid Respec will not permit you to change its type. First let the transformation expire normally in Torchlight 2, then you will be able to change pet type using Torchlight 2 Rapid Respec.

THE CHEAT TAB

The "Cheat" tab allows you to cheat in some ways. Your character will not be flagged as a cheater.
The features of the "Cheat" tab only work if you have loaded character from a Torchlight 2 save file.

Cheat Gold
Your character's current gold is displayed in the top box. To change your character's gold, enter a new amount in the bottom box and press "Cheat Gold." Values over 2 billion are not permitted. If you enter a value over 2 billion, you will be asked whether you wish to proceed with a new value of 2 billion instead.

Clone Character
To create a copy of your character with a new name, enter a new name in the box and press "Clone Character." If you enter a name longer than Torchlight 2's native name length limit (15 characters), a pop-up will ask if you want to continue. What, if any, side-effects can be caused by an extra-long name is unknown. An error pop-up will be displayed if the name you choose contains illegal characters. Please note that, while a clone is created, the original character is the one that remains loaded in Torchlight 2 Rapid Respec.

Remove Console Cheater Flag
The box displays whether or not your character has been flagged as a "cheater" for using the console. To remove the "cheater flag," press "Remove Flag."

Change Difficulty
Your character's single-player difficulty level is displayed in the top box. To change your character's single-player difficulty level, select a new difficulty level in the drop-down box and press "Change Difficulty."

Change Newgame Cycle
Your character's newgame cycle is displayed in the top box. To change your character's newgame cycle, select a new newgame cycle in the drop-down box and press "Change NG Cycle."

Please take note that Torchlight 2 does NOT save independent progress data for each newgame cycle. Your progress in the new cycle will be the same as your progress in the current cycle. Additionally, your saved game world will NOT be compatible with the new cycle. You are strongly advised to reroll the world immediately.

If you want to correct your progress upon entering a new newgame cycle, use the following console commands, then use Torchlight 2 Rapid Respec to remove the cheater flag.

Swap Core
Your character's status as hardcore or softcore is displayed in the box. To change your from hardcore to softcore or vice versa, press "Swap Core."

If your character is a dead hardcore character, you can perform a Path-of-Exile-style "revive and demote to softcore" by pressing "Swap Core." Your character will be revived with 100hp.

Hardcore Resurrect
Your character's status as alive, dead, or not hardcore is displayed in the box. To revive a dead hardcore character press "Hardcore Resurrect." Your character will be revived with 100hp. This button does nothing if your character is either softcore or alive. If you would rather do a Path-of-Exile-style "revive and demote to softcore," press "Swap Core" instead. (See above.)

THE MENU

• "Load Character Save File" -- same as Load Character button.
• "Load and Apply Saved Build" -- same as Load and Apply Build button.
• "Load Saved Build for Editing" -- same as Load Build for Editing button.
• "Create New Saved Build" -- same as New Build for Editing button.
• "Respec Character Save File" -- same as Respec button.
• "Save Build to Saved Build File" -- same as Save Build button.
• "Show Build Code" -- same as Show Build Code button.
• "Exit" -- exits Torchlight 2 Rapid Respec.

• "Check for update when program starts." If checked, when Torchlight 2 Rapid Respec first starts, it will connect to the internet and check to see if an update is available. Obviously, you should disable this if you don't have an always-on internet connection.
• "Ask for extra confirmation before disabling save file backup." If checked, when you try to disable save file backups, Torchlight 2 Rapid Respec will remind you one extra time that this is probably not a good idea.
• "Torchlight 2 save directory." Tells Torchlight 2 Rapid Respec where your Torchlight 2 save directory is located. The default is "<My Documents>\My Games\Runic Games\Torchlight 2\save" This should be correct for users of the Runic/Perfect World version of Torchlight 2. Users of the Steam version of Torchlight 2 will need to change this setting.

Help

• "Help" -- launches this help file in the default web browser.
• "Check for Update" -- connects to clockworkcore.org to check if a new version of Torchlight 2 Rapid Respec is available.
• "About" -- displays the "about" dialog.