兵工厂终极重量

Warfactory Ultimate Weight

WarFactory Ultimate Weight 是一款支持多版本的 Minecraft 模组，专注于物品栏负重、移动惩罚和体力系统。

该模组以性能优先的物品栏追踪为核心设计理念，而非许多旧版负重模组及其前身所采用的全物品栏暴力遍历方式。

它基于共享核心构建，并针对不同版本提供了运行时钩子。当前支持的目标版本：

Minecraft	加载器
1.12.2	Legacy Forge
1.20.1	Fabric, Forge
1.21.1（计划中）	NeoForge, LexForge

特性

• 可配置的物品和物品栏负重系统
• HUD 和工具提示中的负重显示
• 基于负重的移动和跳跃惩罚
• 硬锁定阈值，阻止拾取和转移操作
• 服务器至客户端的配置同步
• 支持基于增量更新的物品栏负重计算
• 体力系统包含：totalStamina、staminaLossRate、staminaGainRate
• 受负重影响的体力消耗惩罚
• 可选：奔跑和跳跃消耗体力
• 支持嵌套物品栏负重
• 模组兼容补丁及面向模组开发者的 API

支持的模组

Ultimate Weight 会读取模组存储物品的内容，使物品的负重根据其容纳的物品大小进行调整，并计算佩戴在额外装备栏（Baubles / Curios）中的物品。任何暴露标准物品处理器（IItemHandler）功能的物品都会自动获得支持；以下模组还拥有针对其自定义存储的专用处理逻辑。兼容补丁仅在目标模组存在时加载，不存在时则不会加载，安全可靠。

1.12.2

模组	支持方式
Baubles	佩戴的饰品计入负重
Traveler's Backpack	背包本身及携带的背包内容物
Retro Sophisticated Backpacks	背包内容物及已安装的升级项
GregTech（CE Unofficial）	机器/物品栏内容
HBM's Nuclear Tech	存储箱内容
Storage Drawers	抽屉内容
任何具有 IItemHandler 的物品	通用方式计算嵌套内容

1.20.1（Forge）

模组	支持方式
Curios	佩戴的饰品计入负重
Sophisticated Backpacks	佩戴（Curios/胸甲栏）及携带的内容，点击存包功能
Traveler's Backpack	背包本身及携带的背包内容物
GregTechCEu Modern	机器物品栏，包括箱子
Superb Warfare	弹药箱（按类型统计弹药数量）
Storage Drawers	抽屉内容
任何具有 IItemHandler 的物品	通用方式计算嵌套内容

补丁所使用的注册表也作为公开 API 对外开放，因此其他模组可以注册自己的负重提供者。在 1.20.1 Fabric 版本中，会计算原版嵌套容器，但上述针对特定模组的处理器和通用物品处理器读取功能仅限 Forge 版本。（可能发生变化）

配置

配置项因版本而异：

• 1.12.2 config/wfweight/weight_config_1_12.yaml
• 1.20.1 config/wfweight/weight_config_modern.yaml

完整参考文档：

• CONFIGURATION.md

许可证

本项目采用 GPLv3 许可证。