XWGunBridge

XWGunBridge 是面向 Minecraft 1.21.11 的客户端/服务端枪械实现：客户端使用 Fabric、Fabric API 与 GeckoLib，服务端使用 Paper API 并按 Luminol/Folia 1.21.11 的 Region 所有权模型开发。

功能

• 服务端权威射击、弹药、射速、换弹、伤害与弹丸结算。
• 仅在服务端确认主手持枪时启用自定义准星、HUD、左右键和 R/B/V。
• 原创 XW-15 与 XW-9 模型、动画、纹理、图标和 OGG 音效。
• 远端玩家动作使用原版挥手表现并播放空间音效；1.0.0 不包含第三人称 GeckoLib 枪模动画。
• 客户端版本与默认枪包 SHA-256 握手校验。
• Folia 实体/区域调度封装、并发会话表和完整禁用清理。
• 独立使用 xwgun 命名空间，可与 CraftEngine、WeaponMechanics 和 PacketEvents 共存。

操作

操作	默认按键
开火	鼠标左键
瞄准	鼠标右键
换弹	R
切换模式	B
检视	V

构建

需要 Java 21。Windows：

.\gradlew.bat clean test build

产物：

• client-fabric/build/libs/xwgun-client-1.0.0.jar
• server-plugin/build/libs/XWGunBridge-1.0.0.jar

安装与测试见 docs/install-zh_CN.md。协议见 docs/protocol.md，枪包格式见 docs/gunpack-format.md。

许可证

代码及本仓库原创资产采用 GPL-3.0-only。TaCZ 官方默认枪包未被复制、修改或分发，详细来源见 docs/asset-sources.md。