Скрипт ключей от транспортных средств FiveM: руководство Agency-Vehiclekeys 2026

Проблема с доступом к транспортным средствам по умолчанию в FiveM

Из коробки GTA V и FiveM позволяют любому игроку садиться и водить любое транспортное средство без ограничений. Нет ключей, нет механики владения, нет последствий за угон чужой машины и уезд. Для казуальных серверов это почти не важно, но для серьёзного ролевого сообщества такое поведение ломает погружение. Каждая машина становится общим такси. Кража автомобиля теряет смысл. Оставить машину у банка во время выполнения задания , это риск, что другие игроки её заберут.

Скрипт ключей от транспортных средств FiveM решает эту проблему на уровне фреймворка. Он привязывает владение и физические ключи к каждому транспортному средству, появившемуся или купленному на сервере, требуя от игроков иметь правильный ключ в инвентаре для разблокировки, запуска и управления автомобилем. Автомобили без ключа заблокированы, игроку, пытающемуся войти, просто отказывают. Чтобы управлять чужой машиной, нужно либо одолжить ключ, использовать механику взлома замка или подобрать замок. Эти три механики вместе превращают взаимодействие с транспортом из пустого действия в значимый элемент ролевого взаимодействия.

В 2026 году Agency-Vehiclekeys , лучший выбор для серверов, которые хотят чистую реализацию системы с глубокой интеграцией QBCore и ESX, увлекательной мини-игрой взлома и единовременной низкой ценой. Это руководство охватывает всё, что нужно знать.

What Agency-Vehiclekeys Delivers

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. Система отмычек

Система отмычек отдельно покрывает этап открытия двери от угона с помощью перебивки проводки. Игрок с предметом lockpick в инвентаре может попытаться вскрыть замок двери автомобиля. Это обязательное условие для входа в транспорт при угоне: сначала вскрываете дверь, затем перебиваете проводку, чтобы завести машину. Взлом замка , это мини-игра с настраиваемым шансом успеха и вероятностью расхода предмета. Неудачные попытки могут сломать отмычку (настраивается) и опционально отправить уведомление игрокам поблизости или полиции. Этот двухэтапный процесс , вскрытие замка, затем перебивка проводки , делает угон автомобиля действительно рискованным и времязатратным, как и должно быть в серьёзном 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 включает несколько механик для удобства:

• Анимации блокировки/разблокировки: Персонаж выполняет реалистичную анимацию вытягивания руки при запирании или отпирании транспортного средства с слышимым щелчком.
• Блокировка по близости: Блокировка и разблокировка с настраиваемого расстояния с помощью клавиши или опции радиального меню, не нужно стоять прямо у двери.
• Сигнализация автомобиля: Опционально активировать сигнализацию автомобиля при попытке взлома замка или подключения проводов. Сигнализация привлекает внимание nearby игроков и может уведомлять владельца через телефон (если установлен 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, добавьте определение ключевого предмета в файл shared items. Точное определение предмета приведено в документации на 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 items с метаданными, совместимы со всеми функциями ox_inventory
• ESX + ESX inventory: Полная интеграция, ключи в системе инвентаря ESX, владение синхронизировано с таблицей транспортных средств ESX

Если вы используете другую систему инвентаря, экспортный API и открытый Lua-код делают добавление кастомного моста простым. Документация включает шаблон моста.

Документация

Полная документация, все опции конфигурации, определения предметов инвентаря, справочник API экспортов, настройка исключений для работ и FAQ доступны по адресу 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:

• Серверы Serious RP которые хотят, чтобы владение транспортом имело реальное значение, больше никакого прыжка в любой увиденный автомобиль
• Сообщества криминального RP которые хотят аутентичные механики взлома и отмычек, делающие угон автомобиля умелым и рискованным занятием
• Серверы с автосалонами , бесшовная интеграция означает, что генерация ключей происходит автоматически в момент продажи.
• RP-серверы полиции , тревожные сигналы и уведомления полиции при попытках взлома замка/зажигания создают реалистичные сценарии реагирования
• Серверы QBCore и ESX ищете готовое, хорошо поддерживаемое решение для ключей, которое уважает существующие конвенции фреймворка

Резюме

Ключи от автомобиля , базовый механизм для любого сервера, который серьёзно относится к ролевой игре. Agency-Vehiclekeys предлагает полный пакет: физические ключи, возможность делиться ключами, мини-игру на взлом зажигания, двухэтапную систему отмычек, сигнализации и глубокую интеграцию с фреймворками за единовременную цену €7.99. Это объективно одна из самых выгодных покупок для вашего FiveM сервера. Посетите магазин, приобретите и измените работу транспорта на вашем сервере уже сегодня.