fire_itemshow 插件功能说明

模型外显系统 — 基于 ESX / ox_inventory / oxmysql 的玩家身上物品外显（背挂）管理器。

核心功能

• 背挂外显：将枪械、自定义物件等模型挂载到玩家骨骼上（位置/旋转/骨骼可调）

• 快捷键 F11 打开 NUI 编辑界面（HTML/CSS/JS）

• 100+全身预设：背部 / 右腿 / 左腿 / 右肩 / 胸前，一键套用

• 5 个个人槽位：每把武器可保存 5 套自定义参数（含 components / tint）

• 预设体系

  • 玩家自有预设（KVP）

  • 服务器官方预设（管理员保存）

  • 社区预设（默认拉取上限 50）

• 远端同步：StateBag 路径同步给附近其他玩家，含 ped 流送补救线程

• 效果设置：自身/他人透明度、最大显示距离（2–100m），KVP 持久化

• 完整骨骼库：常用 / 躯干 / 头颈 / 四肢 / 手指 / 面部 共 10 大类，含 hash + 中英文标注

管理员功能

• 菜单内动态注册/编辑可外显物品（持久化到数据库）

• 保存"服务器默认"参数覆盖配置文件

• 通过 Config.AdminGroups（admin / superadmin）判定

集成与安全

• fire_skate 联动：自动检测并注册滑板物品为可外显模型，骑行时自动隐藏背挂避免重影（通过 exports.fire_skate 取物品代码 / 默认/当前牌面）

• 物品检测：通过 ox_inventory:Search 校验玩家持有

• 服务端安全：rate limit、输入清洗、数值 clamp（pos ±3 / rot ±360）、components 白名单（仅 [%w_]，最多 10 个）