武器投掷/丢弃/传递/保存加载模组

本模组为《侠盗猎车手五》单人模式打造深度武器互动系统，通过手动控制武器投掷/丢弃力度、NPC武器传递、持久携带模式、功能性枪架及全局武器保存加载，彻底打破原版武器“自动消失”“交互单一”的限制。模组以高自由度武器管理为核心，让玩家像“战术专家”一样掌控每一把武器的位置与状态，为角色扮演、游戏录像或硬核射击玩法增添真实细节。

核心特性

1. 手动武器操作（丢弃/投掷/拾取）​

丢弃与投掷（控制键：G键，按点击次数区分力度）：

单次点击（500ms内）：普通丢弃武器（落地静止）；

双击（500ms内）：轻扔武器（短距离抛物线，落地滚动）；

三击（500ms内）：重扔武器（长距离抛物线，落地可能弹起或损坏）。

拾取武器（控制键：H键）：

单次点击拾取附近武器，根据武器相对位置（低/中/高）触发三种拾取动画，增强真实感。

2. NPC武器互动​

传递武器：靠近NPC时按DpadRight，将当前武器交给NPC（NPC会持械）；

取回武器：NPC持有你的武器时，再次按DpadRight可收回；

自动拾取开关：按Shift+N（配置项ToggleAutoNPC）启用/禁用“NPC自动拾取地面武器”（未武装NPC可能捡起附近武器）；

武器限制开关：按Shift+B（配置项ToggleWeaponRestrictions）关闭“大武器限制”（原版持大武器时无法跳跃/攀爬，关闭后武器自动收起，类似原版）。

3. 持久携带模式（Carry Mode）​

切换模式：在非载具状态下按DpadLeft，切换“携带模式”与“正常持械模式”；

核心优势：携带模式下，武器永不消失，始终可见并附着于左手，适用于以下场景：

游泳、攀爬物体/梯子、滑行、跌落、骑摩托车/自行车；

任何原版会“自动收枪”的动作（如翻滚、攀爬），武器均保持左手持握；

双持能力：携带模式下可单手解除保险（如手枪），实现“左手持大武器+右手用单手武器”双持效果；

拾取限制：携带模式下仅能拾取单手武器（避免双手持械冲突）。

4. 功能性枪架系统（Gunrack）​

生成地面枪架：按Shift+K（配置项SpawnGunrack）生成枪架（需开启字幕，通过射线拾取提示定位）；

枪架操作（控制键：DpadRight）：

注视武器或枪架槽位，按DpadRight存储/取出武器（射线拾取机制）；

地面武器靠近枪架时若阻碍拾取，按H键优先拾取地面武器；

车辆枪架：

按Shift+V（配置项AttachOrAdjustGunrack）在载具内生成枪架，用箭头键调整位置后，再次按Shift+V锁定（枪架隐形）；

第三次按Shift+V删除车辆枪架（注意：车辆枪架不保存，重启游戏后消失）；

保存特性：地面枪架存储的武器随枪架保存/加载（类似其他武器数据）。

5. 全局武器保存与加载​

保存武器：按Shift+S（配置项SaveData）保存地图上所有武器（含枪架、地面、NPC持有）的位置与状态；

加载武器：按Shift+L（配置项LoadData）加载上次保存的所有武器，恢复原地图武器分布。

6. 模组开关与其他控制​

开关模组：按Shift+W（配置项ToggleMod）启用/禁用整个模组；

其他按键：

DpadRight：NPC传递/取回武器（与手动拾取/投掷区分，拾取用H键，投掷用G键）；

DpadLeft：切换携带模式（非载具状态）；

箭头键：调整车辆枪架位置。

使用说明

手动武器操作：

丢弃/投掷：靠近武器按G键，500ms内点击1/2/3次分别对应丢弃/轻扔/重扔；

拾取：靠近地面武器按H键单次，触发低/中/高动画拾取。

NPC互动：

靠近NPC按DpadRight传递武器，再次按取回；

按Shift+N开关“NPC自动拾取地面武器”功能。

携带模式：

非载具状态下按DpadLeft开启，武器左手持握不消失，可双持单手武器；

携带模式下仅能拾取单手武器（如手枪、微型SMG）。

枪架系统：

地面枪架：按Shift+K生成，开字幕后用DpadRight射线存取武器；

车辆枪架：按Shift+V生成，箭头键调整位置后Shift+V锁定（隐形），第三次Shift+V删除；

地面武器近枪架阻碍拾取时，按H键优先拾取地面武器。

保存加载与模组开关：

按Shift+S保存当前地图所有武器状态，Shift+L加载恢复；

按Shift+W开关整个模组（禁用后所有功能暂停）。

注意事项

按键冲突：所有按键（G/H/Shift组合键等）可通过模组配置文件修改，避免与其他模组冲突；

携带模式限制：仅非载具状态可用，且仅能拾取单手武器；

枪架字幕要求：地面枪架需开启字幕才能显示射线拾取提示（否则无法定位槽位）；

车辆枪架保存：车辆生成的枪架不保存，重启游戏后消失（仅地面枪架保存）；

武器限制开关：Shift+B关闭“大武器限制”后，持大武器时可跳跃/攀爬，但武器会自动收起（类似原版）；

单人模式专属：模组仅支持故事模式，不影响线上游戏。

注意！！ 此mod与其他相同类型的mod有冲突，请单独使用！