It's utility mod and does almost nothing on its own.
What you should know about it is that mod has key bindings for extra skills that must be assigned in settings.
Here's, I think, the best key bindings (default, starting from 1.4.0):
Adding extra skill is almost the same as adding normal skills.
Along with SkillLocator, you need to use ExtraSkillLocator. It contains info about extra skills.
Here's code snipet for adding extra skills:
var extraSkillLocator = commandoPrefab.AddComponent<ExtraSkillLocator>();
extraSkillLocator.extraFirst = firstExtraSkill;
extraSkillLocator.extraSecond = secondExtraSkill;
extraSkillLocator.extraThird = thirdExtraSkill;
extraSkillLocator.extraFourth = fourthExtraSkill;
That's all it takes for adding simple skills.
All defined classes extend corresponding classes from RoR2. Class naming follows one pattern: Extra{NameOfRoR2Class}.
ExtraSkillLocator - The main thing that you need. It's a component that you add to your character prefab to be able to use extra skills.
Fields:
extraFirst - contains info about first extra skillextraSecond - contains info about second extra skillextraThird - contains info about third extra skillextraFourth - contains info about fourth extra skillExtraInputBankTest - Containts info about user inputs state for extra skills.
Fields:
extraSkill1 - contains info about first extra skill stateextraSkill2 - contains info about second extra skill stateextraSkill3 - contains info about third extra skill stateextraSkill4 - contains info about fourth extra skill stateExtraSkillSlot - Contains consts for extra skill slots. Can be used to get skills from the corresponding slot from SkillLocator.
RewiredActions - Contains consts for rewired actions. With that info, you can manually access corresponding buttons state via Rewired.Player
ExtraSkillSlotsPlugin - Main class of this mod. There's nothing you can do with it, except to look at BepInPlugin definition to define a dependency to that mod.
If you got to the point where you need more skills, you probably know enough about creating characters/skills, just want to leave here a small guide for skills creating.
ExtraInputBankTest(and any component that not stored in fields) from EntityState you should use outer field, for example:var extraInputBankTest = outer.GetComponent<ExtraInputBankTest>();
//Create new SkillFamily
var firstSkillFamily = ScriptableObject.CreateInstance<SkillFamily>();
//IMPORTANT! Do not forget to add name for SkillFamily
//because game uses it for saving loadout
//Also I recomend to follow naming convention "{PrefabName}{SkillSlot}Family";
(firstSkillFamily as ScriptableObject).name = "MyCharacterBodyFirstExtraFamily";
//Adding skill variants to the family
firstSkillFamily.variants = variants;
//Registering skill family in catalog
LoadoutAPI.AddSkillFamily(firstSkillFamily);
//Adding new GenericSkill component to character prefab
var firstExtraSkill = myCharacterPrefab.AddComponent<GenericSkill>();
//Setting SkillFamily to our GenericSkill
firstExtraSkill.SetFieldValue("_skillFamily", firstSkillFamily);
...
//Adding ExtraSkillLocator to character prefab
var extraSkillLocator = myCharacterPrefab.AddComponent<ExtraSkillLocator>();
//Assigning our skill to corresponding slot
extraSkillLocator.extraFirst = firstExtraSkill;
Feel free to ping me on discord @KingEnderBrine if you found one.
1.5.1
Bubbet. (Now icons work with BetterHudLite)1.5.0
Survivor of the Void update.1.4.5
ExtendedLoadout break for Captain1.4.4
1.4.3
1.4.2
1.4.1
1.4.0
DrBibop for code example.1.3.2
1.3.1
1.3.0
1.2.2
1.2.1
Moved extra skill row up a bit, to not interfere with the default skills stock number.
Optimization.
1.2.0
Added BaseSkillState hooks
Again fixed stats recalculation.
1.1.0
Updated for RoR2 release version.
Changed extra skill slot indices (11, 12, 13, 14). Mainly this was done to not interfere with Sniper's ammo.
Added support for Purity cooldown reduction.
1.0.4
1.0.3
Fixed issue where stats recalculation starts throwing errors in console.
Updated dependencies
1.0.2
1.0.1
1.0.0