Add Pilots

From Battletech Modding Wiki
Revision as of 06:05, 6 May 2018 by Crackfox (talk | contribs) (Making the new pilot appear in the campaign.)
Jump to: navigation, search

This guide covers adding pilots to Skirmish and the Campaign

Please note the file locations are for the Steam Version, GOG may differ.

Tools needed are NOTEPAD++, DB Browser if you are going to add the pilot to the campaign and GIMP 2 is handy for picture editing.

Please note the text in the JSONS and the DB is case sensitive so be careful.

The pilot files can be found in:



Create a new folder in BattleTech_Data\StreamingAssets\ called mods


Create a folder inside mods with a name for the mod I chose crackfox


Create another folder called pilots and within that folder another called jsons and another called sprites

Creating a new pilots JSON file

First of all copy an existing pilot's JSON file to your mods/crackfox/pilots/json folder and rename it.

pilot_backer_Alaniz.json for example and change it to pilot_crackfox.json

Open your new pilot file in Notepad++ and you should see the following listed below (parts to change are highlighted in BOLD and comments in bold/italic)
"Description": {
"Id": "pilot_backer_Alaniz", - This ideally needs to be the same as your new pilots json file so the "pilot_back_Alaniz" we change it to "pilot_crackfox".
"Name": "Dragon 66", - This is the pilots name, Change the "Dragon 66" to your pilot's nickname. So we put "Crackfox"
"FirstName": "Zin", - This is the pilots first name, Change the "Zin" to your pilot's first name. So we put "Harry".
"LastName": "Ala", - This is the pilots last name, Change the "Ala" to your pilot's last name. So we put "Rams".
"Callsign": "Dragon 66", - This is the pilots Callsign, Change the "Dragon 66" to your pilot's Callsign. So we put "Crackfox"
"Gender": "Male", - This is the characters Gender, Change the "Male" to "Female" if creating a female pilot.
"Faction": "Davion", - This is the characters faction "I will add a list of possible pilot factions to another section, for the moment leave it as Davion
"Age": "41", - Pilots age just change the number to whatever you desire.
This section is your pilots BIO just enter whatever you please within the quotations
"Details": "Dragon 66 was born Zin Ala in the Federated Suns, the child of a family of military bureaucrats. His stable, safe childhood left him craving more excitement than bureaucracy could provide, so when he was old enough, he enrolled in the planetary guards.\r\n\r\nAfter boot camp, his aptitude tests placed him in logistical support roles \u2014 not that different from what his family did, but at least he was on the more exciting front lines. Through dedicated service and commitment, Zin worked his way up from driving supply vehicles to planning their routes to overseeing entire logistical operations.\r\n\r\nAll that changed when an operation he was involved with collapsed, leaving him one of the few able-bodied soldiers able to defend a key location. He did a hero's job, but when reinforcements won through, they came with military lawyers and wagging fingers over breaches of protocol.\r\n\r\nAs a result, he ended up on Solaris VII, where he stayed just long enough to establish a reputation. But knowing he had no future there, he moved on to the Periphery, looking for a chance to once again start at the bottom and work his way up.",
"Icon": "guiTxrPort_backerAlaniz_utr" - This is the pilots portrait, the picture needs to be 512x512 PNG format with or without a transparent background, note put the file name without the extension. Call the picture something similar to the pilot name EG "pilot_crackfox_sprite"
"BaseGunnery": "3", - Pilots Gunnery, set to whatever you like within the quotations. For the purpose of this example change it to 4.
"BonusGunnery": 0,
"BasePiloting": "5", - Pilots Piloting, set to whatever you like within the quotations. For the purpose of this example change it to 4.
"BonusPiloting": 0,
"BaseGuts": "2", - Pilots Guts, set to whatever you like within the quotations. For the purpose of this example change it to 4.
"BonusGuts": 0,
"BaseTactics": "5", - Pilots Tactics, set to whatever you like within the quotations. For the purpose of this example change it to 4.
"BonusTactics": 0,
"ExperienceUnspent": 0,
"ExperienceSpent": 6600,
"Injuries": 0,
"Health": 3,
"LethalInjury": false,
"Incapacitated": false,
"Morale": 0,
"Voice": "m_pro03_brit", - This is the name of the voice pack the Pilot will use, there are 12 Female and 12 Male voice packs not counting story Characters. I will list the voice packs separately.
"abilityDefNames": [ - Abilities and Traits are listed in another section, I am not sure what happens if you add more than 2 active abilities as this may cause UI Issues. If adding more abilities make sure there is not a , after the last ability.
"AIPersonality": "Undefined",
"PilotTags": { - Not sure what bearing most of these have on the game other than pilot_backer and pilot_release_skirmish. Add pilot_release_skirmish to enable the pilot to appear in the skirmish side of the game.
"items": [
"pilot_backer", -
For simplicity change the pilot tags to the following:

"items": [



"pilot_release_skirmish" - Only if you want the pilot to appear in Skirmish.

"tagSetSourceFile": ""
"PilotCost": 0,
"IsRonin": true,
"IsVanguard": true - Change this to false.

Abilities and Traits List

Pilots can have multiple abilities, Unknown if having more than 2 usable abilities will cause UI Issues.

Abilities List

"AbilityDefG5" - MULTI TARGET



"AbilityDefP8" - ACE PILOT

"AbilityDefGu5" - BULWARK

"AbilityDefGu8" - JUGGERNAUT

"AbilityDefT5A" - SENSOR LOCK


Trait List

Coming Soon

Voice pack List

Female Voices













Male Voices













Adding the pilot to versionmanifest.csv

Versionmanifest.csv is located at:


Open the file in notepad++ and scroll all the way to the bottom

We will need to add 2 new lines to the CSV file for each new pilot, DO NOT leave a gap between the lines as this will cause the game to not load.



The sections highlisted in bold are what you need to change to your pilots json file and portrait and their location, everything after them just copy it directly without changing it.

If everything has gone to plan your new pilot should appear in the skirmish game.

Making the new pilot appear in the campaign.

Coming soon.