Versions 1.2.0.4 and higher require modtek v3 or higher

Versions 1.4.0.0 amd higher require IRBTModUtils, available here: https://github.com/BattletechModders/IRBTModUtils/releases

This is a mod for HBS Battletech that allows developers to give players choices when it comes to leveling up abilities. Special thanks to kMiSSioN for allowing the reuse of their code adding additional ability buttons to the Combat HUD.

To use, place your new AbilityDefs in an appropriate subfolder, either in the Abilifier folder or elsewhere in your modpack, and ensure you have the appropriate manifest entry in your mod.json so modtek will load the new AbilityDefs, e.g.

 "Manifest": [
		{ "Type": "AbilityDef", "Path": "Abilities" },

In addition, you must add the new Ability Ids to SimGameConstants under the Progression entry, e.g.:

	"Progression" : {
		"GunnerySkills" :[
			[
				"TraitDefWeaponHit1"
			],
			[
				"TraitDefWeaponHit2"
			],
			[
				"TraitDefWeaponHit3"
			],
			[
				"TraitDefWeaponHit4"
			],
			[
				"TraitDefWeaponHit5",
				"AbilityDefG5",
				"AbilityDefG5a"
			],

Using the above, a player reaching Gunnery 5 will have the choice between the abilities with Ids AbilityDefG5 and AbilityDefG5a. Using the existing naming scheme (appending "a", "b", etc. for new abilities in a skill tree) is not required, but is recommended for potential future compatibility.

Lastly, developers have a choice between the display style for the ability selection pop-up. The default method is to display the entire body of the Ability details in the AbilityDef .json, e.g:

The alternative style is to use a hover tooltip, but this requires a little extra work on the developers' part:

To use a hover tooltip, you will need to create BaseDescriptionDef (essentially lore hover items) .jsons for all abilities, including any vanilla abilities being used, and place them in Abilifier/AbilityDescs. The BaseDescriptionDef Id must be identical to the AbilityDef Id, ending in "Desc" as below:

{
    "Id" : "AbilityDefP5aDesc",
    "Name" : "MOSTEST SUREST FOOTING",
    "Details" : "PASSIVE: 'Mechs piloted by this MechWarrior gain ALL THE EVASIVE CHARGES after moving (can exceed the unit's maximum). If the move is not a sprint, jump, or charge to melee, the 'Mech also gains ENTRENCHED (50% stability damage reduction).",
    "Icon" : ""
}

Abilifier now ships with an additional config .json called EffectDataExtensions.json. This file defines optional new capabilities and restrictions for EffectData affecting StatCollections in game. The config comprises a Dictionary, where the "key" is equal to the EffectData.Description.Id for which you want to impose additional restrictions.

More Details

A few new fields have been added to AbilityDefs, providing some additional functionality.

More Details

Settings available in the mod.json:

More Details

As of v1.3.0.0, Abilifier has absorbed the AbilityRealizer mod. Settings for AbilityRealizer module can be found in AbilityRealizerSettings.json in the Abilifier mod folder. All existing settings and behavior have been maintained.

More Details

Troubleshooting information for trait pip generation.

More Details