KingEnderBrine-ExtraSkillSlots icon

ExtraSkillSlots

Utility mod that allows adding more skills for characters

Last updated 2 weeks ago
Total downloads 1121
Total rating 4 
Dependency string KingEnderBrine-ExtraSkillSlots-1.0.4
Dependants 0 other mods depend on this mod

This mod requires the following mods to function

KingEnderBrine-ScrollableLobbyUI-1.2.1 icon
KingEnderBrine-ScrollableLobbyUI

Adds scrolling to lobby UI (skills, loadout, character select)

Preferred version: 1.2.1
tristanmcpherson-R2API-2.4.29 icon
tristanmcpherson-R2API

A modding API for Risk of Rain 2

Preferred version: 2.4.29
bbepis-BepInExPack-3.2.0 icon
bbepis-BepInExPack

Unified BepInEx all-in-one modding pack - plugin framework, detour library

Preferred version: 3.2.0
README

For users

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:
Keybingins


For developers

TL; DR;

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.


Full documentation

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:

    • GenericSkill extraFirst - contains info about first extra skill
    • GenericSkill extraSecond - contains info about second extra skill
    • GenericSkill extraThird - contains info about third extra skill
    • GenericSkill extraFourth - contains info about fourth extra skill
  • ExtraInputBankTest - Containts info about user inputs state for extra skills.
    Fields:

    • InputBankTest.ButtonState extraSkill1 - contains info about first extra skill state
    • InputBankTest.ButtonState extraSkill2 - contains info about second extra skill state
    • InputBankTest.ButtonState extraSkill3 - contains info about third extra skill state
    • InputBankTest.ButtonState extraSkill4 - contains info about fourth extra skill state
  • ExtraSkillSlot - 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.


Small tips

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.

  • To access ExtraInputBankTest(and any component that not stored in fields) from EntityState you should use outer field, for example:
var extraInputBankTest = outer.GetComponent<ExtraInputBankTest>();
  • Mini guide about adding extra skill
//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;

Bugs

Feel free to ping me on discord @KingEnderBrine if you found one.


Changelog

1.0.4

  • Actually fixed stats recalculation hook.

1.0.3

  • Fixed issue where stats recalculation starts throwing errors in console.

  • Updated dependencies

1.0.2

  • One more Readme fix

1.0.1

  • Readme fix

1.0.0

  • Mod release.

Available versions

Please note that the install buttons only work if you have compatible client software installed. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2020-7-23 1.0.4 566 KingEnderBrine-ExtraSkillSlots-1.0.4.zip Install
2020-7-23 1.0.3 15 KingEnderBrine-ExtraSkillSlots-1.0.3.zip Install
2020-7-12 1.0.2 489 KingEnderBrine-ExtraSkillSlots-1.0.2.zip Install
2020-7-12 1.0.1 19 KingEnderBrine-ExtraSkillSlots-1.0.1.zip Install
2020-7-12 1.0.0 32 KingEnderBrine-ExtraSkillSlots-1.0.0.zip Install