01概述
适用于 QBCore、Qbox、ESX 或完全独立运行的 FiveM 通用车辆钥匙。按 G 可用手中的钥匙遥控器锁定或解锁你有钥匙的最近车辆，并伴有短促的喇叭声和车灯闪烁，按 U 可启动引擎。按 F5 打开钥匙圈，查看每把钥匙及其车辆距离、车门和引擎状态，还能使用遥控器进行锁车、打开后备箱、启动引擎和触发紧急警报。车主可以将永久或临时钥匙交给附近的玩家，也可以一键收回。警察、EMS 和技工无需钥匙即可驾驶所属职业的车辆。撬锁时需要通过技能判定，警报、车主消息和警方警报让入室盗窃更具真实感。管理员可以发放钥匙、查询任意车牌，并在同一个菜单中更改全服务器设置，菜单可使用全新的 V2 设计或经典的 V1 外观。支持 Agency Garage、Agency Vehicleshop 和 qb-vehiclekeys 的关键事件，并内置 25 种语言。
02功能
03截图
+值得了解
Agency-Vehiclekeys V2 为每位玩家提供一个钥匙圈，每辆车配有一个遥控器。钥匙可以分享，也可以收回；对应职业的玩家可以打开职业车辆；玩家还可以撬锁或热接车辆，但要承担实际后果。该脚本支持 QBCore、Qbox、ESX，也可以在不使用任何框架的情况下运行。所有拥有 V1 的用户都可以免费升级到 V2。
- 游戏世界中的钥匙
- 按 G 可在 25 米范围内锁定或解锁你有钥匙的最近车辆。钥匙遥控器会显示在手中，短促的喇叭声和闪烁的车灯会确认操作，并显示一张简短提示卡，说明操作结果。坐在驾驶座时按 U 可启动或熄灭发动机；你也可以选择下车后让发动机继续运转。
- 钥匙圈
- 按 F5 或输入 /keys，即可打开钥匙列表，并使用搜索和筛选功能。每把钥匙都会显示车辆距离、车门和发动机状态，以及其他持钥匙的人。车辆在遥控范围内时，可通过遥控器锁定、解锁、打开后备箱、启动发动机或触发恐慌警报，还可设置导航点前往车辆。
- 四种钥匙
- QBCore、Qbox 或 ESX 中的玩家自有车辆会自动生成车主钥匙；独立服务器则可通过调用 SetOwner 的车库或商店生成车主钥匙。共享钥匙会保存，重启后仍然有效。临时钥匙会在下次重启时失效，或者在指定小时数后失效。职业钥匙会根据职业等级和执勤状态，为警察、EMS 和技工开放职业车辆。
- 分享钥匙
- 车主可将永久或临时钥匙交给 5 米范围内的玩家，每辆车最多可发放六把钥匙。已发放列表会显示所有持有该车钥匙的人，并可一键收回钥匙。仅持有钥匙的玩家也可以转交钥匙或归还钥匙。
- 撬锁与热接
- 携带撬锁工具时，在上锁车辆旁按 H，即可开始分为三轮的技能检定：在标记区域内按下按键。高级撬锁工具操作更容易，也不容易损坏。车辆需要钥匙才能启动时，坐在驾驶座按 H 可分四轮热接车辆，并获得一把临时钥匙。紧急车辆无法撬锁。
- 警报与警察
- 尝试失败可能触发车辆警报，并通过 ps-dispatch、cd_dispatch、qs-dispatch、rcore_dispatch、core_dispatch、tk_dispatch、lb-tablet 或内置警报向警方发送提示，内置警报会在地图上显示标记。有人闯入车主的车辆时，车主会收到消息。
- 两种外观
- 全新的 V2 设计采用了 Agency Housing 的金色风格。经典的 V1 外观会通过 Agency-Notify、你的框架或 GTA 信息流，将每条消息显示为通知，并使用旧版 Agency 风格的菜单。管理员可在钥匙设置中为整个服务器切换外观。
- 游戏内管理员
- 在独立服务器上，管理员标签页可向任意玩家发放临时钥匙、已保存的钥匙或车主钥匙，查询车牌及车主和持钥匙者，并收回钥匙，还可锁定或解锁你面前的车辆。设置标签页可更改整个服务器的外观、范围、引擎规则、钥匙共享、撬锁规则和调试模式。
?常见问题
V2 是免费更新吗？
是的。所有拥有 Agency-Vehiclekeys 的用户都可以在 Keymaster 中免费获取 V2，价格保持不变。
我需要框架或数据库吗？
不需要。没有框架时，脚本会以独立模式运行；没有 oxmysql 时，钥匙会保存在服务器的键值存储中。使用 QBCore、Qbox 或 ESX 时，框架中的已拥有车辆会自动成为车主钥匙。
它能与我的车库和车辆商店配合使用吗？
Agency Garage 和 Agency Vehicleshop 开箱即用，使用 qb-vehiclekeys 钥匙事件的脚本也一样。车辆必须在玩家附近，或属于该玩家，这样就没人能索要任意车辆的钥匙。
V1 的钥匙会如何处理？
首次启动时，V1 发放的钥匙会从 simple_carkeys_shared 表中转移。旧表不会受到影响。
为什么现在用 U 键启动引擎？
V1 使用 M 键，而 Agency Phone 也会用这个键打开。将 Config.Controls.engine = 'M' 设为旧按键即可。玩家也可以在 GTA 设置的按键绑定、FiveM 中更改所有按键。
我可以更改文本吗？
可以。Config.Locale 可选择 25 种语言之一，Config.Text 则可使用自定义文本覆盖 locales/en.lua 中的任意单条文本。