Agency-Vehiclekeys：微小摩擦如何让车辆感觉更真实

非功能性反特性

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

重要的按键状态

Agency-Vehiclekeys models three key states per vehicle: owned (you have a physical key item), shared (someone gave you a copy), hotwired (temporarily accessible with police trace risk). Each state has different sound cues, startup animations, and engine behavior. Players who borrow friends' cars feel different from thieves, as they should.

开锁小游戏

我们提供一个简单的三层锁匠小游戏，随车辆等级调整难度。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 reads from garage ownership data but doesn't modify the garage system. Vehicles still spawn through your existing garage script. The key system layers on top, when you spawn a vehicle from the garage, a key item is generated in your inventory automatically.

需求

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

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

Agency-Vehiclekeys enables a genuine locksmith profession that doesn't exist on keyless servers. Here's what that character's gameplay looks like in practice:

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

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