枪械与弹药

《Valheim》枪械与弹药扩展 MOD 使用指南
【核心介绍】
新增6种枪支（含步枪、火枪）与18种子弹，支持自定义武器属性、弹药配方及热键切换，全程服务器同步。
【安装指南】
1. 下载文件：获取「GunzNBullets.dll」（主插件文件）；
2. 粘贴路径：将该文件放入游戏根目录 /BepInEx/Plugins/ 文件夹；
3. 配置重置：必须删除原有配置文件 `/configs/blacks7ar.GunzNBullets.cfg`，启动游戏后模组将自动生成新版配置（缺一不可）。
【功能详情】
✅ 已优化：
– 新增6种枪支（含步枪、火枪）及18种子弹；
– 支持通过热键在背包中循环切换当前子弹类型（默认键可配置）；
– 所有武器与弹药数据均支持通过配置文件或「Official_BepInEx_ConfigurationManager」调整；
– 全功能支持多人服务器同步。
❌ 未修改：
– 游戏原有武器、弓弩、法术等系统；
– 角色模型、动画、UI 界面布局。
✨ 额外调整：
– 提供完整中文配置项注释（需使用支持 UTF-8 的编辑器打开 cfg 文件）。
【使用要求】
– 必备前置：已安装「BepInEx」框架（v5.4.21 或更高版本）；
– 游戏版本：仅兼容 Valheim 正式版 v0.219.11 及后续小版本（不兼容测试分支或旧版）；
– 无额外硬件要求。
【兼容性说明】
– 兼容范围：与绝大多数物品/武器类 MOD 兼容（如「ValheimArmory」「BetterArchery」）；
– 不兼容模组：不兼容直接修改 `ItemDrop` 或 `Projectile` 核心行为的 MOD（例：「True Arrows」需禁用其弹道重写模块）；
– 兼容补丁：暂未推出专用兼容补丁。
【注意事项】
– 首次运行后务必重启游戏，确保配置文件正确生成；
– 若热键切换无效，请检查 `/configs/blacks7ar.GunzNBullets.cfg` 中 `EnableAmmoCycling` 是否为 `true`；
– 服务器端需所有玩家均安装本 MOD，否则新枪械无法显示或使用；
– 模组不修改原版存档结构，卸载后原有存档可正常加载（已获得的枪械/弹药将消失）。
【更新日志】
2024 年 4 月 12 日新增对 Valheim v0.219.11 的适配，修复服务器端弹药同步延迟问题；
2024 年 3 月 5 日首发正式版，开放全部配置项与热键切换功能。