unity-decorator-pattern

You dynamically modify stats at runtime by wrapping base stat objects with decorators like PercentageModifier and FlatModifier. This approach enables composable buffs and debuffs without altering base classes, using the IDecorator<T> interface for layered value computation.

The decorator pattern in Unity stat systems is used for dynamically modifying numeric statistics at runtime. It allows developers to stack buffs, debuffs, and damage calculations by wrapping base stats, enabling reusable and composable effects.

Yes, you can stack multiple buffs and debuffs on a single base stat. The system supports composable effects by wrapping a BaseStat with multiple PercentageModifier and FlatModifier instances, computing a deterministic final value when GetValue is called.

To apply a flat bonus and a percentage buff, create a BaseStat and wrap it sequentially with PercentageModifier and FlatModifier instances. Calling GetValue computes the final result by layering the decorators over the base stat value.

No, this Unity stat modifier system does not require external dependencies. It operates independently using a generic IDecorator<T> interface along with built-in BaseStat, PercentageModifier, and FlatModifier components to calculate final values.

You should use the decorator pattern for stat calculations when you need to dynamically add or remove buffs and debuffs at runtime. It prevents class explosion from deep inheritance hierarchies by allowing composable stat modifiers to wrap objects individually.