可见武器

《GTA V》可见武器系统 MOD 使用指南
【核心介绍】
让角色身上始终显示所持武器（主武器、手枪、近战武器），支持自动配件识别、位置微调与NPC同步，无需复杂配置，开箱即用。
【安装指南】
1. 必须先安装前置依赖：
– 「ScriptHookVDotNet」夜间版本（[GitHub 最新 nightly]( 网址链接
– 「LemonUI」v2.2 或更高版本（[GTA5-Mods 下载页]( 网址链接
2. 将下载的 `VisibleWeapons.dll` 和 `VisibleWeapons.ini` 两个文件同时放入游戏根目录 `/scripts` 文件夹（缺一不可）；
3. 卸载旧模组：若曾安装 `WeaponsOnBack.dll` / `WeaponsOnBack.ini`，请彻底删除，否则将冲突。
【功能详情】
✅ 已优化：
– 角色身上实时显示主武器（前/后背）、左右腰侧（手枪/近战）共 4 个槽位；
– 自动识别并显示附加配件（如瞄准镜、握把等）及武器颜色；
– 支持 NPC（保镖/跟随者）同步显示武器，可在游戏内菜单开启/关闭；
– 提供武器偏移量调节功能，有效缓解穿模问题；
– 内置 LemonUI 游戏内菜单，支持手柄/键盘快捷打开（手柄：重装弹 + 回头键；键盘：输入 `VIWE`）；
– 兼容「Trail Carry v2.0」；
❌ 未修改：
– 基础武器动画逻辑（如换弹、瞄准动作）；
– 游戏原生武器拾取/切换机制；
✨ 额外调整：
– 新增死亡/进入载具时自动隐藏武器选项；
– 支持槽位间武器快速切换与独立位置偏移设置；
– 修复 Bullpup Mk2、电击枪、重型武器（RPG 等）位置异常问题。
【使用要求】
– 游戏版本：需运行于 GTA V 增强版（Enhanced Edition）；
– 运行环境：必须使用 ScriptHookVDotNet 夜间版（非稳定版）；
– 语言：配置文件与菜单为英文，需基础英语阅读能力（关键选项均有直观图标提示）。
【兼容性说明】
– 兼容范围：
– 所有官方 DLC 武器（含「血与酒」等扩展内容）；
– 保镖/跟随类模组（如「Simple Bodyguard」）；
– 「Trail Carry v2.0」（需单独安装）；
– 不兼容模组：
– 「PYGO / PullYourGunsOut」：仅在禁用 `VisibleWeapons.ini` 中的 `AnimatePutGunToBack = false` 时可共存；
– 其他直接覆盖武器挂点或动画的模组（如自定义武器挂点替换器）；
– 兼容补丁：暂未推出。
【注意事项】
– 狙击枪、RPG 等重型武器在「前面模式」下会自动移至背后（避免视觉穿插），此为默认行为，不可关闭；
– v1.4.0 起启用全新 `VisibleWeapons.ini` 格式：切勿整体复制旧版 ini 文件，仅迁移需保留的数值（如 `OffsetX = 0.1`、`EnableNPC = true`）；
– 视频演示已过时，请以压缩包内 `README.txt` 为准；
– 若遇崩溃，请先确认是否满足全部前置要求、已卸载 `WeaponsOnBack` 相关文件，并检查 `VisibleWeapons.ini` 语法格式（无中文标点、无空格错位）；
– 差评前未提供错误日志或复现步骤，将不予技术支持。
【更新日志】
2024 年 4 月 12 日　v1.6.2：新增对「Trail Carry v2.0」兼容性；LemonUI 升级至 v2.2；
2024 年 3 月 28 日　v1.6.1：修复 NPC 收起/取出武器时的延迟创建/移除问题；
2024 年 2 月 15 日　v1.6.0：增强 NPC 武器同步，兼容主流保镖/跟随模组；
2023 年 12 月 5 日　v1.5.0：新增武器槽位交换与独立偏移调节；修复瞄准镜缩放异常及武器重复显示；
2023 年 10 月 17 日　v1.4.1：修复 Bullpup Mk2 位置偏移失效问题；
2023 年 9 月 20 日　v1.4.0：全面重构，NPC 武器系统上线；原「WOB_Comeback」正式更名为「Visible Weapons」；
2023 年 7 月 3 日　v1.3.1：修复手柄射击时武器异常重现问题；
2023 年 5 月 22 日　v1.3.0：新增 DLC 武器支持、前后/腰侧双模式切换、重型/近战武器定位优化；
2023 年 3 月 10 日　v1.2.1：修复 `EquipOnBack = false` 时动画残留；新增腰侧武器开关与子菜单；
2023 年 1 月 29 日　v1.2.0：集成 LemonUI 游戏内菜单；新增武器位置调节器；新增死亡/载具内自动隐藏；
2022 年 11 月 8 日　v1.1.0：支持全部 DLC 武器；新增前面/腰侧挂点；支持前/后双模式切换；
2022 年 9 月 1 日　v1.0.0：初始发布。