FiveM 车辆钥匙脚本：Agency-Vehiclekeys 指南 2026

FiveM中默认车辆访问的问题

开箱即用，GTA V和FiveM允许任何玩家进入并驾驶任何车辆，无限制。无钥匙、无所有权机制，跳上陌生人车辆开走无后果。对休闲服务器影响不大，但对严肃角色扮演社区来说，这种默认行为严重破坏沉浸感。每辆车都成了公共出租车。车辆盗窃失去意义。将车停在银行附近执行任务时，面临其他玩家随意使用的风险。

FiveM 车辆钥匙脚本在框架层面解决了车辆钥匙问题。它为服务器上生成或购买的每辆车附加所有权和实体钥匙，要求玩家拥有正确的钥匙物品才能解锁、启动和驾驶车辆。无钥匙车辆被锁定，试图进入的玩家会被拒绝。驾驶非自有车辆需借用钥匙、使用热接线机制或撬锁。这三种机制共同将车辆交互从无意义事件转变为有意义的角色扮演摩擦层。

到2026年，Agency-Vehiclekeys是服务器实现该系统的首选，具备深度QBCore和ESX集成、引人入胜的热接线小游戏，以及一次性低价。本指南涵盖你需要了解的所有内容。

Agency-Vehiclekeys 提供的功能

Agency-Vehiclekeys is built around five core feature pillars that together make vehicle ownership feel real:

1. 物理关键物品

当玩家生成或购买车辆时，唯一钥匙物品会放入其库存。该物品是解锁和启动该特定车辆的唯一方式，绑定车辆网络 ID 或车牌。钥匙可物理交给他人、丢弃、存储于储藏处或遗失。若丢失钥匙，无法启动车辆，除非使用热接线或呼叫锁匠（可配置的机械师职业）。此设计决策将钥匙变为真实库存物品，创造出默认 FiveM 无法支持的真实角色扮演场景。

2. 密钥共享

钥匙共享系统允许车辆所有者创建一把副本钥匙并交给其他玩家。这对于共有人车辆、家庭用车、需要移动车辆的修理店以及共享逃逸车的犯罪团伙至关重要。共享通过简单的游戏内交互完成，瞄准玩家，选择“Give Vehicle Key”，副本钥匙即出现在他们的库存中。所有者保留他们的钥匙；接收者获得一把功能完全相同的副本钥匙。所有者还可以随时撤销所有共享钥匙，锁定之前有访问权限的任何人。

3. 热线小游戏

当玩家尝试进入无钥匙的锁定车辆时，提供热接线选项。Agency-Vehiclekeys 包含精致的 NUI 热接线小游戏，是一项计时的线缆匹配挑战，需玩家技巧而非简单掷骰。成功完成小游戏启动汽车，但触发服务器端事件，供其他脚本挂钩：警告车主、通知警察调度、记录事件至 MDT。小游戏难度和时间限制可完全配置，且可根据车辆类别设定不同难度等级（经济车较易，超级跑车较难）。

4. 开锁系统

开锁系统单独涵盖车辆门锁解锁步骤，与热接线分开。拥有开锁工具的玩家可尝试撬开车辆车门锁。这是热接线启动前的前提步骤，先撬门锁，再热接线启动。开锁有独立小游戏及可配置的成功率和工具消耗概率。失败可能导致开锁工具损坏（可配置），并可选择向附近玩家或警察发送通知。此两步流程（撬锁再热接线）使车辆盗窃具有实际风险和耗时，符合严肃RP的要求。

5. 深度 QBCore 和 ESX 集成

Agency-Vehiclekeys integrates directly with QBCore inventory (ox_inventory compatible) and ESX inventory out of the box. Key items appear as proper inventory objects with icons and metadata. Vehicle ownership ties into QBCore's vehicle ownership database (player_vehicles)和 ESX 的等效功能。当玩家从经销商或扣押场取回车辆时，钥匙会自动生成并放入其库存。所有通知、锁定/解锁确认、热接警报、撬锁尝试，请使用您框架的原生通知系统，以匹配服务器其余 UI。

额外功能

超越五大核心支柱，Agency-Vehiclekeys包含若干质量提升机制：

• 锁定/解锁动画： 角色在锁定或解锁车辆时播放逼真的伸手动画，并伴有可听见的点击声。
• 接近锁定： 使用按键绑定或环形菜单选项从可配置距离锁定和解锁，无需站在门旁边。
• 车辆报警： 当尝试使用开锁器或热接线时，可选择触发汽车警报。警报会吸引附近玩家注意，并可通过电话通知车主（如果安装了Agency Phone）。
• 免工作车辆： 定义一组免于钥匙系统限制的工作车辆（警车、救护车、拖车），警员可自由进入工作车辆，无需钥匙物品。
• 扣押集成： 当车辆被扣押时，相关钥匙自动失效。车辆从扣押场取回时，会生成新钥匙。
• 导出 API: 清晰的导出 API 允许其他脚本检查钥匙所有权、程序生成钥匙或撤销钥匙，适用于机械师脚本、经销商脚本和自定义职业集成。

安装：逐步指南

步骤 1：购买 Agency-Vehiclekeys

前往 shop.agencyg.de/en/products/vehiclekeys 并完成一次性购买 €7.99. 结账后，你将通过Agency Scripts商店门户获得下载权限。无订阅，无续费，永久拥有。

步骤 2：放置资源

解压下载的压缩包并放置 agency-vehiclekeys 服务器的文件夹内 resources 目录（或子文件夹如 resources/[scripts]/).

步骤 3：添加到 server.cfg

打开你的 server.cfg 并在您的框架和库存资源之后添加ensure行：

ensure agency-vehiclekeys

步骤 4：配置 Config.lua

打开 agency-vehiclekeys/config/Config.lua 并设置您的框架、库存系统和功能偏好。请参见下面的示例以获取代表性配置。

步骤 5：将钥匙物品添加到您的库存

如果您使用QBCore或ESX，请将关键物品定义添加到共享物品文件。具体物品定义见文档 docs.agencyg.de/vehiclekeys. 对于 ox_inventory 用户，请将物品添加到你的 items.lua 文件中。

步骤 6：重启并测试

重启你的服务器。生成一辆车辆，检查你的物品栏是否有钥匙物品，锁车，离开，返回，尝试无钥匙进入。然后测试将钥匙交给其他玩家、开锁交互和热接小游戏。

Config.lua 示例

以下是Agency-Vehiclekeys中最重要选项的代表性配置：

-- Agency-Vehiclekeys: Config.lua

Config = {}

-- Framework: "qbcore" or "esx"
Config.Framework = "qbcore"

-- Inventory system: "qb-inventory", "ox_inventory", or "esx"
Config.Inventory = "ox_inventory"

-- Item name for vehicle keys in your inventory
Config.KeyItem = "vehicle_key"

-- Item name for lockpicks
Config.LockpickItem = "lockpick"

-- Distance (metres) from which player can lock/unlock their vehicle
Config.LockDistance = 8.0

-- Enable vehicle alarm on hotwire/lockpick attempt
Config.EnableAlarm = true
Config.AlarmDuration = 30  -- seconds

-- Hotwire mini-game settings
Config.Hotwire = {
    enabled    = true,
    timeLimit  = 20,         -- seconds to complete mini-game
    difficulty = "medium",   -- "easy", "medium", "hard"
    -- Per-class overrides (GTA vehicle class numbers)
    classOverrides = {
        [6]  = "easy",   -- off-road: easier
        [7]  = "hard",   -- supercars: harder
        [14] = "hard",   -- military: very difficult
    },
}

-- Lockpick settings
Config.Lockpick = {
    enabled          = true,
    breakChance      = 0.25, -- 25% chance lockpick breaks on failure
    alertPolice      = true, -- send notification to online police on attempt
    alertRadius      = 30.0, -- metres within which police are notified
}

-- Job-exempt vehicles (these jobs can enter any vehicle without a key)
Config.ExemptJobs = { "police", "ambulance", "mechanic", "tow" }

-- Notification system: "qb", "esx", "okok", "ox"
Config.NotifySystem = "qb"

-- Enable export API for other scripts to interact with the key system
Config.EnableExports = true

框架与库存兼容性

Agency-Vehiclekeys supports the following combinations out of the box:

• QBCore + qb-inventory: 完整集成，钥匙显示在 QBCore 库存界面，车辆所有权与同步 player_vehicles
• QBCore + ox_inventory: 完整集成，钥匙以 ox 物品形式渲染并带有元数据，兼容所有 ox_inventory 功能
• ESX + ESX inventory: 完整集成，钥匙显示在 ESX 库存系统，所有权与 ESX 车辆表同步

如果您运行不同的库存系统，导出 API 和开放的 Lua 代码库使添加自定义桥接变得简单。文档中包含桥接模板。

文档

完整文档、所有配置选项、库存物品定义、导出 API 参考、免工作设置和常见问题解答，均可在 docs.agencyg.de/vehiclekeys. 文档随每次发布更新，包含 QBCore、ESX 和 ox_inventory 的可复制粘贴物品定义。

定价：€5.99 一次性

Agency-Vehiclekeys costs €7.99 通过Agency Scripts商店一次性支付。无订阅，无续费，无每服务器费用。一次支付，永久拥有，当前主版本的所有未来更新均免费包含。价格不到六欧元，是市场上性价比最高的高级FiveM脚本之一。其他开发者的订阅模式车辆钥匙系统单月费用即达此价；Agency-Vehiclekeys以一次性价格提供相同或更优质的服务，相当于大多数服务器拥有者一周的咖啡花费。

谁应该使用 Agency-Vehiclekeys？

Agency-Vehiclekeys is the right choice for:

• 严肃RP服务器 想要车辆所有权具有实际意义，不再随意跳入任何车辆的用户
• 犯罪 RP 社区 想要真实的热线和开锁机制，使车辆盗窃成为一项技术性且有风险的活动的用户
• 拥有汽车经销商的服务器，无缝集成意味着销售点自动生成密钥。
• 警察RP服务器，锁匠/热接尝试时的警报和警察通知，营造真实响应场景
• QBCore 和 ESX 服务器 寻找一个即插即用、维护良好且尊重现有框架约定的钥匙解决方案

摘要

车辆钥匙是任何认真对待角色扮演的服务器的基础机制。Agency-Vehiclekeys提供完整套件，包括实体钥匙物品、钥匙共享、基于技能的热接游戏、两阶段开锁系统、车辆报警和深度框架集成，售价一次性€7.99。它客观上是您为FiveM服务器购买的最高性价比产品之一。访问商店，购买它，今天就改变您服务器上的车辆运作方式。