VPB Hand Animation Compatibility Layer

VPB 手部动画兼容层

VPB 手部动画兼容层是一个客户端 Fabric 兼容模组，用于协调 Vic’s Point Blank、Hold My Items 和 Punchy。

它让 Point Blank 以及 Point Blank 内容包中的枪械继续掌控自己的第一人称手部动画，同时把普通物品交给 Hold My Items 和 Punchy 处理。该模组刻意保持范围狭窄：它不会改变武器机制、伤害、开火/装填逻辑、后坐力、弹药、输入、碰撞或服务端行为。

修复内容

• 让 VPB 枪械动画优先于 Hold My Items 的第一人称渲染重定向。
• 当 Point Blank 枪械占据主手时，抑制 HMI 的第一人称动作姿态手部。
• 通过 Punchy 自带的物品黑名单路径，让 Punchy 对 Point Blank 物品让位。
• 让非 Point Blank 物品继续正常使用 HMI 和 Punchy。
• 通过常规的 pointblank 命名空间允许列表，支持 Point Blank Blue Archive 内容包枪械。
• 通过配置保留可选的调试诊断功能。

1.0.0 版本的新内容

• 公开项目名称改为 VPB 手部动画兼容层。
• 在现有的 Hold My Items 兼容之外，加入了 Punchy 兼容。
• 提供 Minecraft 1.21.11、1.21/1.21.1 和 1.20.1 的发布构建。
• 缺失的配置开关会在首次启动或迁移时根据已安装模组自动填充。
• holdmyitems 和旧版 hold-my-items 模组 ID 均被识别，用于 HMI 兼容。
• 技术模组 ID 仍为 vpb_hmi_compat，以保持更新连续性。

兼容性

可用的发布版本线：

• Minecraft 1.21.11
• Minecraft 1.21 和 1.21.1
• Minecraft 1.20.1

请使用与你的 Minecraft 版本匹配的文件。该模组仅客户端可用，对单人或多人的客户端都安全；服务端不需要安装。

安装

将匹配的 vpb-hmi-compat jar 放入客户端或整合包的 mods 文件夹，并与 Vic’s Point Blank 以及 Hold My Items、Punchy 或两者一起放入单独的客户端配置文件中。

配置

首次启动客户端时，模组会创建：

config/vpb_hmi_compat.json

如果配置文件或某个兼容开关缺失，模组会根据已安装模组自动填充缺失的开关。后续启动时不会覆盖用户自定义的选择。

要测试特定物品 ID，请将其添加到 bypassItemIds，例如 "pointblank:ba_ariusar"。要收集诊断信息，请临时将 debugLogging、heldItemLogging 和 mixinLogging 设为 true。

兼容性说明

• 该模组仅针对 VPB 第一人称手部动画冲突。
• 它不声称与所有动画模组广泛兼容。
• 此处未对 Fresh Animations、EMF 和 ETF 进行修补。

许可证

当前及未来的 1.0.0+ 项目代码和公开元数据均为源码可用 / 保留所有权利，除非文件另有说明。此前以 MIT 发布的版本不会被追溯更改。

官方未修改的构建可以包含在整合包中。独立兼容模组/附加组件在通过正常运行时行为交互时是允许的。复制、修改、移植、重新分发修改后的构建、发布分支或基于此代码/资源创建衍生作品需要获得许可。

致谢

由 Swiyss 和 elizinro 创建。