RarityLib
A utility library for adding custom rarities to the game.
| Date uploaded | 2 years ago |
| Version | 1.1.5 |
| Download link | Root-RarityLib-1.1.5.zip |
| Downloads | 28180 |
| Dependency string | Root-RarityLib-1.1.5 |
This mod requires the following mods to function
BepInEx-BepInExPack_ROUNDS
BepInEx pack for ROUNDS. Preconfigured and ready to use.
Preferred version: 5.4.1100
willis81808-UnboundLib
This is a helpful utility for ROUNDS modders aimed at simplifying common tasks.
Preferred version: 2.7.3
Pykess-CardChoiceSpawnUniqueCardPatch
Patches erroneous logic in the base game CardChoice method SpawnUniqueCard
Preferred version: 0.1.7
Pykess-ModdingUtils
Utilities aimed at making modding easier and more accessible
Preferred version: 0.3.5README
RarityLib
Adds the ability to create and fetch custom rarities for cards, along with functionality for modifying the relative rarity of a card.
Currently there are 3 known additional rarities for cards:
- Legendary (from this mod)
- Epic (WillsWackyManagers)
- Scarce (WillsWackyManagers)
- If you made a rarity you want added to this list, please DM 『 root 』#9063 on discord. If you do not share a server with us, you can use this link: https://discord.gg/9XWgYUUEzZ
Functions
### AddRarity() ```cs int AddRarity(string name, float relativeRarity, Color color, Color colorOff) ``` #### Description Adds a new rarity for cards to utilize and returns the integer representation of that value.Parameters
- string
namethe name of the rarity to add. - float
relativeRarityhow rare should it be (Common is 1, Rare is 0.1). - Color
colorwhat color should the rarity be when the card is selected. - Color
colorOffwhat color should the rarity be when the card is not selected.
Example Usage
RarityUtils.AddRarity("Legendary", 0.025f, new Color(1, 1, 0), new Color(0.7f, 0.7f, 0));
Notes
AddRarity should be utilized in your mod's Awake function, that way the rarities are present before building the cards that need them.
GetRarity()
CardInfo.Rarity GetRarity(string rarityName)
Description
Returns the rarity with the given name if it exists, otherwise returns Common.
Parameters
- string
rarityNamethe rarity to fetch.
Example Usage
RarityUtils.GetRarity("Legendary");
GetRarityData()
Rarity GetRarityData(CardInfo.Rarity rarity)
Description
Returns the data for a rarity.
Parameters
- CardInfo.Rarity
raritythe rarity data to fetch.
Example Usage
RarityUtils.GetRarityData(CardInfo.Rarity.Common);
GetCardRarityModifier()
float GetCardRarityModifier(CardInfo card)
Description
Returns the rarity modifier for a card.
Parameters
- CardInfo
cardthe rarity data to fetch.
Example Usage
float rarityMod = RarityUtils.GetCardRarityModifier(card);
UnityEngine.Debug.Log(rarityMod);
SetCardRarityModifier()
void SetCardRarityModifier(CardInfo card, float modifier)
Description
Sets the default rarity modifier for a card.
Parameters
- CardInfo
cardthe rarity data to fetch. - float
modifierthe new default rarity modifier for the card.
Example Usage
RarityUtils.SetCardRarityModifier(card, 5);
AjustCardRarityModifier()
void AjustCardRarityModifier(CardInfo card, float add = 0, float mul = 0)
Description
Adjusts the rarity modifier for a card.
Parameters
- CardInfo
cardthe rarity data to fetch. - float
addthe amount the default rarity modifier is adjusted by additively. - float
multhe amount the default rarity modifier is adjusted by multiplicatively. Applies after the additive modifier.
Example Usage
RarityUtils.AjustCardRarityModifier(CardInfo card, 5, 100)
Classes
Rarity
Description
The information about a given card rarity.
Fields
- string name
- The name of a rarity.
- float relativeRarity
- How common the rarity is compared to commons.
- float calculatedRarity
- No idea.
- Color color
- The color of the rarity when a card is selected.
- Color colorOff
- The color of the rarity when a card is not selected.
- CardInfo.Rarity value
- The CardInfo rarity of a card rarity.
