Confluence Lib

Confluence Lib

A small, generic Forge 1.20.1 library: a named, team-scoped gauge fed by one or more independent “sources”, with a configurable threshold and Forge events fired when that threshold is crossed in either direction.

What it does

Confluence Lib has no lore, no entities, and no content of its own. It just counts, and tells you when a rule is met. If you’re building a mechanic like “corruption”, “reputation”, or “harmony” that should accumulate per FTB Teams team from multiple independent triggers, this library handles the bookkeeping so you don’t have to touch team NBT or reinvent threshold-crossing logic yourself.

• Register any number of independent gauges, each with its own threshold and minimum distinct-source requirement.
• Contribute to or reduce a gauge from anywhere in your own code, Confluence Lib never knows why, only how much.
• GaugeThresholdReachedEvent / GaugeThresholdClearedEvent fire exactly once per crossing, in either direction.
• Optional passive daily decay per gauge, disabled by default.
• Data lives under a namespaced key in the team’s own extra data, no separate save file, no collision with other mods.

Cryptic Life Mod’s Resonance and Convergence systems are both built entirely on this API, see the full API guide for usage and a real worked example.

Dependencies (hard)

• FTB Teams : gauges are always scoped to a Team, never to a player directly.
• Minecraft Forge 1.20.1-47.4.10+

License

All Rights Reserved – Free to use in any modpack, fork/modify freely, but no reupload/redistribution elsewhere without explicit permission.