Effectlib is a Vintage Story mod by llama3013. Effectlib is a library for creating items that grant temporary or death-bound player effects through JSON or code, with an admin command for applying them.
Why this mod is worth installing
This dependency is intended for modders who want consumables, tools, or other items to apply configurable player effects. Server administrators can also use it to grant temporary effects without adding a special item.
What Effectlib adds
Effectlib provides a framework for item-driven player effects. A mod can define the effect in JSON or create it in code, then attach it to an item behavior such as a consumable. This supports examples like a food item that grants speed, a wand that spends durability, or a pill that performs a one-time action.
Effect definitions can include an effect ID, duration, HUD visibility, notifications, icons, consumption rules, durability cost, use animation, and sound. Effects sharing an ID can be prevented from stacking, while separate attribute fields allow one item to carry more than one effect behavior.
The library also exposes the /efflib command for administrators. It can grant a temporary effect or one that remains until the target player dies, making it useful for testing and server events as well as for content created by other mods.
Where to download Effectlib
The official Vintage Story Mod DB page is the right place to get the current release through the in-game mod manager.