Confluence 库

Confluence 库

一个用于FTB Teams团队范围仪表的小型库

Confluence Lib

一个轻量级的、通用的 Forge 1.20.1 库：一个命名的、以团队为作用域的仪表，由一个或多个独立的“数据源”提供数据，具有可配置的阈值，并在越过该阈值（无论方向）时触发 Forge 事件。

功能

Confluence Lib 没有背景故事、实体或自身的内容——它只是进行计数，并在规则满足时通知你。如果你正在构建一个类似“腐化”、“声望”或“和谐”的机制，需要由多个独立的触发源按 FTB Teams 团队进行累积，这个库会处理相关的记账工作，这样你就不必直接操作团队的 NBT 数据或自己重新实现阈值判断逻辑。

  • 注册任意数量的独立仪表，每个仪表都有自己的阈值和最小独立数据源数量要求。
  • 在你自己的代码中的任何地方增加或减少仪表数值——Confluence Lib 从不关心为什么，只知道数量。
  • GaugeThresholdReachedEvent / GaugeThresholdClearedEvent 事件在每次越过阈值时（无论方向）精确触发一次。
  • 每个仪表可选的被动每日衰减功能，默认禁用。
  • 数据存储在团队自身扩展数据中的一个命名空间键下——无独立存档文件，不会与其他模组冲突。

Cryptic Life Mod 的 Resonance 和 Convergence 系统完全构建在此 API 之上——请参阅完整的 API 指南以了解用法和实际示例。

依赖（硬性）

  • FTB Teams — 仪表始终以 Team 为作用域，不直接作用于玩家。
  • Minecraft Forge 1.20.1-47.4.10+

许可证

保留所有权利 — 可在任何整合包中免费使用，可自由分叉/修改，但未经明确许可不得在其他地方重新上传/重新分发。