KingEnderBrine-ExtraSkillSlots icon

ExtraSkillSlots

It's a library for other devs!!! It allows adding more skills for characters

Last updated 3 months ago
Total downloads 6582
Total rating 7 
Dependency string KingEnderBrine-ExtraSkillSlots-1.2.1
Dependants 3 other mods depend on this mod

This mod requires the following mods to function

KingEnderBrine-ScrollableLobbyUI-1.3.1 icon
KingEnderBrine-ScrollableLobbyUI

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

Preferred version: 1.3.1
tristanmcpherson-R2API-2.5.7 icon
tristanmcpherson-R2API

A modding API for Risk of Rain 2

Preferred version: 2.5.7
bbepis-BepInExPack-5.3.1 icon
bbepis-BepInExPack

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

Preferred version: 5.3.1
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.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

  • 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-8-23 1.2.1 4006 KingEnderBrine-ExtraSkillSlots-1.2.1.zip Install
2020-8-22 1.2.0 282 KingEnderBrine-ExtraSkillSlots-1.2.0.zip Install
2020-8-17 1.1.0 803 KingEnderBrine-ExtraSkillSlots-1.1.0.zip Install
2020-7-23 1.0.4 835 KingEnderBrine-ExtraSkillSlots-1.0.4.zip Install
2020-7-23 1.0.3 42 KingEnderBrine-ExtraSkillSlots-1.0.3.zip Install
2020-7-12 1.0.2 512 KingEnderBrine-ExtraSkillSlots-1.0.2.zip Install
2020-7-12 1.0.1 45 KingEnderBrine-ExtraSkillSlots-1.0.1.zip Install
2020-7-12 1.0.0 57 KingEnderBrine-ExtraSkillSlots-1.0.0.zip Install