维克的点射HMI兼容

VPB 手部动画兼容层

VPB 手部动画兼容层是一款面向 Fabric 客户端的兼容模组，用于 Vic's Point Blank、Hold My Items 和 Punchy。

它让 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 制作。