Agency-Repairkit：玩家真正使用的简单车辆维修工具

现场维修问题

您的车辆在任务中途受损。修理厂距离有10分钟车程。坐在那里开车会破坏您正在进行的任何动作序列的节奏。但即时自我修复感觉不公平。Agency-Repairkit通过可用但有限的现场修理工具找到中间地带。

三层套件

基础套件能快速修复小伤害。高级套件能较慢修复中等伤害。专业套件处理重大伤害，但应用时间明显更长。分级让玩家根据库存和情况做出有意义的选择。

动画完整性

每次修理都使用车辆受损部位的可见动画。玩家不能在驾驶座快速修理，必须下车走到损坏处并执行修理动画。这防止战斗中滥用现场修理，使动作更具成就感。

中断事项

在修理过程中受到伤害或被击中会中断修理并消耗修理包。修理应在非战斗状态下进行，而非战斗中。这保护了追逐场景不至于变成无效的打地鼠。

经济整合

修理工具包可由机械师NPC或玩家机械师通过Agency-Minerjob的金属供应链制作。整个汽车经济、采矿、制造、现场修理、店铺修理，形成一个连贯的网络。工具包不是一次性物品，而是更大系统中的一个节点。

安装与设置

从你的Tebex库下载Agency-Repairkit并将文件夹放入你的resources目录。添加 ensure agency-repairkit 到 server.cfg. 若需跨重启持久跟踪装备包，资源依赖 oxmysql；否则装备数量仅限会话，服务器重启时重置。

套件物品需要在您的框架物品列表中注册。配置文件附带了适用于QBCore和ESX的正确物品名称。对于独立设置，物品注册钩子是一个函数调用，位于 config.lua.

配置选项

该 config.lua 暴露对kit行为的完全控制：

• 套件等级，定义任意数量的工具包类型，每种有最大修复量、修复速度和动画时长。
• 战斗锁定，玩家处于战斗状态时是否允许修理。默认：战斗中禁用。
• 中断伤害阈值，收到多少伤害会取消正在进行的修理。设为0则任何伤害均取消。
• 按伤害区域的动画，发动机损坏、车身损坏和轮胎损坏播放不同动画。
• 经济整合，启用制作事件钩子，使Agency-Minerjob金属产出可用于工具包制作。

框架兼容性

Agency-Repairkit ships with built-in adapters for QBCore and ESX. Framework detection is automatic, drop the resource in, and it detects which you're running. For standalone servers:

• 实现 Config.GetItem 和 Config.RemoveItem 连接您的物品系统。
• 实现 Config.GetVehicleHealth 和 Config.SetVehicleHealth 用于您的车辆损坏层。
• 其他所有（动画、UI、中断逻辑）均无需更改即可工作。

为什么这对角色扮演很重要

车辆损坏是RP摩擦最稳定的来源之一。当任务在距离最近机械店15分钟外出现问题时，玩家面临选择：拖着车破坏节奏、呼叫并快速传送，或拥有可行的现场选项。修理包提供了第三条路径，感觉是努力获得而非免费。

分级工具包系统创造了自然的库存经济决策。您是携带专业工具包“以防万一”并支付携带成本，还是依赖基础工具包并接受严重损伤需去修理店？这些是让库存管理感觉真实而非随意的有意义微决策。

战斗中断机制对追逐RP尤为重要。没有它，被追逐玩家可能在追捕过程中进行现场修理，完全削弱紧张感。有了它，修理成为冲突后或场景间的活动，而非紧急按钮。

常见问题

机械师可以从他们的菜单出售修理套件吗？

是的。Agency-Repairkit导出一个服务器端事件。 agency-repairkit:giveKit 任何机械师脚本都可调用。传递玩家服务器ID、工具包等级和数量。您现有的机械师店脚本只需在销售流程中添加一次事件调用。

该套件是否适用于船只和飞机？

是的。伤害系统使用 FiveM 的原生车辆健康属性，适用于所有车辆类型。飞机使用简化动画（玩家无法在飞行中走到特定损伤区域），船只则从码头位置修理。两种行为均可配置。

我可以限制某些职业使用的套件等级吗？

基于工作的装备访问在物品定义中支持。设置 requiredJob = 'mechanic' 基于套件类型，只有该职业的玩家可使用。这对于希望将专业套件限定为机械师专用工具而非可购买商品的情况非常有用。

套件如何与车辆重生脚本交互？

Agency-Repairkit fires agency-repairkit:onRepairComplete 带有车辆netId和修理金额，当修理包成功使用时触发。任何监听此事件的脚本都可相应处理，你的车辆持久化脚本可将车辆标记为现场修理以便记录。

需求

• FiveM 服务器（QBCore、ESX 或独立）
• oxmysql（可选，用于持久化套件追踪）
• 拥有有效 Agency-Repairkit 许可证的 cfx.re 账户
• 用于套件物品的框架物品注册

在服务器经济中平衡修理包

服务器对Agency-Repairkit最常问的经济问题是：修理包应有多稀有？答案取决于您服务器现有的经济平衡。

如果您的服务器有活跃的机械店且角色扮演良好，请合理提供基础和高级套件，但专业套件应稀有或仅限机械师使用。这将重大维修推回店铺，同时允许小型现场维修，保持机械师角色扮演的可行性。

如果您的服务器在机械师工作中玩家参与度不足，请减少现场套件供应，并确保机械师制作的套件优于市售产品。访问玩家机械师的经济激励必须真实存在，而非仅仅是叙事。

如果您的服务器有强大的犯罪经济，通过 Agency-Blackmarket 制作套件价格或玩家制作创造了平行市场。作为黑市物品的军用级修理套件产生有趣的物流角色扮演，同时不破坏民用机械市场。

关键原则：现场修理应感觉是有用选项，而非最优选项。如果玩家从不光顾修理店，说明你的修理包过于强大或过于便宜。调整产出和价格应同时进行，而非单独调整。