Easily make flexible parameters for your characters, items, abilities, buffs in Unity.
Your game character has some parameters, for example - move speed, max health, etc.
You need to add posibility to affect these params - potions buffs, which will increase values of character parameters; enemies attacks debuffs, which will decrease these values, etc. And all of these should be combined easily.
So, there you can use this extension.
It is just replaces basic variables to a new thing called Modifier Param (wip naming). It can be max health, damage, move speed - any other thing. These values can be added to params group, which is simple called Modifier. This group describes params of some object - character, buff, item, etc.
There is a Modifier class, which contains of user-defined parameter types, you can flexible change it. Every buff or other thing has its own Modifier. Modifier is a simple ScriptableObject, so every modifier is just an asset in project folder.
There also Modifable class, which you can add for your character/weapon/etc. It contains basic params of this object (something like default Modifier), and can be affected by adding/removing other modifiers from code. Modifable is a MonoBehaviour, it can be added to your objects by drag n drop.
You can access Modifable parameters with a simple API and get values of your params - it automatically will summarize all modifiers, added to this object, and return final value, actual for this param.
All these parameters can be edited or added/removed at all without any code and project recompile.
Modifiers work example:
Character move speed without modifiers is 3.
Some speed up buff adds extra 2 speed.
But also there is some debuff which really slows down character, its speed value -4.
So, final value (returned by the API) of character speed is 1 (3 + 2 + (-4)).
Modifiers extension allows you to:
- Unified serialization.
- Ready-made Sum and Subtract operations for the params.
- Easily get values from GameObject, there is no need to use GetComponent or something other.
- Easy to add new or remove old ones with minimum refactoring amount, which can be easily done with modern IDEs.
It is works nice with MonoBehaviour approach, in other cases you may prefer your own implementation. Also there are still some limitations etc - for example, if your game have stats for different types of objects (items, characters, etc), it is not very comfy to work with them in one Enum.
Download repo as source code, unpack to your project. Also you can check Releases for unitypackage.
Package manager install will not be supported on this repo.
Insert it to enum ModifierType, add new ones (remove default values, it is just for example).
Right click in the Project window -> Modifiers -> New modifier.
Next, you're need to add required params to the list in this modifier.
Right click in the Project window -> Modifiers -> New buff.
Setup buff parameters, add buff modifiers.
You can create your own buff class (derived from Buff) and add there your info, it can be icon, text id or something other.
This is one of the most common actions. You add and remove stats for your characters etc regularly.
[SerializeField] Modifier modifier;
void Start()
{
// This and below code uses custom extensions methods
// Add
gameObject.AddModifier(modifier);
// Remove (note that if you instance modifier, by remove method you will be able to remove only modifiers, same to instance, not the original one).
gameObject.RemoveModifier(modifier);
}This is another most common action. To handle any values, you need to get them somehow. This example shows, how it done in this extension.
// Getting value of Max Health param
gameObject.GetModifierValue(ModType.MaxHealth);If you need to tag object and check if object have some tags, you can use these methods. Tags are just simple numbers like other stats, but these methods allows to work with them easily and make code more short.
gameObject.AddTag(ModType.TagA);
if (gameObject.HasTag(ModType.TagA))
{
// do something
}
// checking for multiple tags, AND condition example
if (gameObject.HasAllTags(ModType.TagA, ModType.TagB))
{
// do something if there all on the object
}
// OR condition example
if (gameObject.HasAnyTags(ModType.TagA, ModType.TagB))
{
// do something if there at least one tag of the listed above.
}// making filter which will filter all objects with team 1
Filter filter;
void Start()
{
filter = Filter.Make(ModType.Team, 1);
}
void Update()
{
var results = filter.GetResults();
foreach (GameObject teamedGo in results)
{
// you can do something with result objects
}
}Other usage examples can be found in the Example folder.
You can find it in the Example folder, there is a sample scene. It shows simple character with Max Health, Regeneration and Defense parameters. Also there is a "damager" which have Damage and Critical Chance parameters. Damage will be applied to the character on left mouse button click. Critical chance will be used to make x2 damage, if random value hits the chance.
Battleproofed in the Echo Storm game.
MIT