ModifierManager

A type-safe stat modifier system for Roblox games. Manage buffs, debuffs, equipment bonuses, and stat modifications with automatic expiration, stacking rules, and client sync.

Documentation

Installation

Wally

[dependencies]
ModifierManager = "waterdreamer/modifier-manager@1.0.0"

Quick Example

local ModifierManager = require(ReplicatedStorage.ModifierManager)
local stats = ModifierManager.EntityManager.new()

-- Set base stat
stats:SetBase("enemy_1", "Combat.Health", 100)

-- Add a temporary buff
stats:AddModifier({
    entity = "enemy_1",
    path = "Combat.Health",
    value = 50,
    type = "Additive",
    source = "HealthPotion",
    duration = 30,
})

-- Get calculated value (150)
local health = stats:Get("enemy_1", "Combat.Health")

Note: EntityManager and PlayerManager can only be created on the server. Use ClientStatReader on the client.

License

MIT