Agency-Vehiclekeys：细微的不便如何让汽车更真实

非功能性反特性

要求车辆启动需要钥匙听起来像是反功能。谁想在开车前多走几步？但沉浸式RP往往正是建立在这种有意义的摩擦上。车辆盗窃变成了有风险的偷窃。锁车成为真实动作。热接线成为可学习的技能。

重要的按键状态

Agency-Vehiclekeys 为每辆车设定三种钥匙状态：拥有（你有实体钥匙物品）、共享（有人给了你一把副本）、热线连接（暂时可以使用，但有被警方追踪的风险）。每种状态都有不同的音效提示、启动动画和引擎行为。借朋友的车和偷车的玩家会有不同体验，这正是应有的设计。

开锁小游戏

我们提供一个简单的三层锁匠小游戏，随车辆等级调整难度。Sultan RS比Faggio耗时更长且失败率更高。小游戏基于技巧但不惩罚失败，失败只损失时间和工具，不影响角色进度。这是一个合适的难度曲线，作为一个应当制造紧张感而非设置门槛的机械。

框架集成

QBCore 车辆所有权、ESX 车库和独立自定义登记处均通过一套钩子连接。钥匙作为库存物品存储，因此可以自然地与掉落、交易和库存搜索交互。没有特殊处理。

经济影响

基于钥匙的车辆访问创造了真实的经济角色。锁匠成为可行的职业。汽车盗贼成为真正的威胁。保险公司变得有用。系统间的相互响应带来自发的角色扮演，Agency-Vehiclekeys是这拼图中的一部分。

安装与设置

Agency-Vehiclekeys requires oxmysql to persist key ownership across server restarts. Import vehiclekeys.sql，将资源文件夹拖入服务器，并添加 ensure agency-vehiclekeys 到 server.cfg. 资源从您的框架车库或车辆登记处读取车辆所有权数据，QBCore 和 ESX 适配器随包发布并在启动时自动检测。

钥匙物品需要在您的框架物品系统中注册。配置文件附带了适用于QBCore和ESX的物品名称和元数据定义。独立设置通过配置钩子定义物品处理。

配置选项

该 config.lua 提供对每个关键机制的细粒度控制：

• 开锁工具等级，定义每种车辆类别的成功概率和失败行为。超级跑车比经济车更难热接线。
• 热线检测概率，成功热接线时每分钟发送警察警报的概率。
• 钥匙复制费用，在锁匠工作台制作复制钥匙所需的物品和金钱成本。
• 锁匠工作要求，可选，限制钥匙制作仅限于锁匠工作角色的玩家。
• 退出时自动锁定，司机下车时车辆是否自动上锁。默认：禁用（更真实）。
• 共享密钥过期，临时密钥可设置现实时间限制，自动失效。

框架兼容性

完整的 QBCore 和 ESX 适配器包含在包内。对于独立部署，实现四个配置函数：车辆所有者查询、物品给予/移除、警察警报触发，以及可选的锁匠职业检查。核心钥匙状态机、动画、小游戏和热接线逻辑无需框架知识。

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

没有有意义访问控制的车辆所有权只是装饰。Agency-Vehiclekeys让拥有车辆和访问车辆之间的差距变得真实。停在银行外的锁车不仅仅是背景，而是潜在目标或安全资产，取决于观察者是谁。

锁匠经济是最大的衍生益处。一旦钥匙成为可复制、丢失或被盗的实体物品，锁匠角色便有了真正的服务价值。丢失钥匙的玩家需选择热接线（有风险）或寻找锁匠（需信任和协商）。这种互动是脚本安装前不存在的纯RP内容。

热线检测追踪使车辆盗窃成为有风险的计算行为，而非轻而易举的动作。热线并驾驶一小时的玩家承担了重大风险。经验丰富的小偷学会频繁换车。警察学会监视热线信号。脚本生成有机的犯罪和执法角色扮演，无需任何脚本事件。

常见问题

玩家可以把钥匙给另一个玩家吗？

是的。钥匙是库存物品，可以交易、丢弃或通过任何标准库存转移方式赠送。这包括通过Agency-Phone市场赠送钥匙或在某地丢弃供他人拾取，完整物品经济适用。

关键物品丢失或删除会怎样？

服务器端钥匙登记独立于物品跟踪所有权。丢失实体钥匙物品的玩家可在锁匠店生成替代钥匙（需时间和金钱）或通过管理员命令获得。车辆不会永久无法访问。

迷你游戏能否针对特定玩家角色禁用？

是的。锁匠小游戏可为具有特定职业角色（例如高级锁匠）或特定物品（专业锁匠工具包与基础工具包）玩家绕过。绕过条件可在 Config.LockpickItems.

是否与现有车库脚本冲突？

Agency-Vehiclekeys 会读取车库所有权数据，但不会修改车库系统。车辆仍由你现有的车库脚本生成。钥匙系统在此基础上运行：从车库生成车辆时，系统会自动在你的背包中生成钥匙物品。

需求

• FiveM 服务器（QBCore、ESX 或独立）
• oxmysql
• 拥有有效 Agency-Vehiclekeys 许可证的 cfx.re 账户
• 兼容的车库或车辆所有权系统

在 Keys 服务器上扮演锁匠角色

Agency-Vehiclekeys 让无钥匙服务器上原本不存在的真正锁匠职业成为可能。以下是这个角色在实际游戏中的玩法：

提供钥匙复制服务的锁匠角色需要客户联系渠道，Agency-Phone负责此事。需要一个工作台道具用于钥匙复制动画，协调服务器的MLO团队或使用原版工作台道具。服务收费，资金流经经济框架。可能携带高级开锁工具，能打开其他玩家工具无法开启的车辆，需赢得需要特定车辆访问的犯罪客户信任。

信任维度尤其有趣。一个未经授权复制钥匙的锁匠，或者向警方举报钥匙制作客户的锁匠，或者在“维修”时故意损坏车辆的锁匠，这样的角色具有真实的道德复杂性和游戏内决策后果。Agency-Vehiclekeys创造了这种角色存在的条件。