Agency-Vehiclekeys V2 Установка
Универсальные ключи для автомобилей FiveM на QBCore, Qbox, ESX или полностью в standalone-режиме.

01Установка
- 1Поместите Agency-Vehiclekeys в папку resources
- 2Добавьте ensure Agency-Vehiclekeys в server.cfg после вашего фреймворка, oxmysql и инвентаря
- 3Остановите другие скрипты ключей, например qb-vehiclekeys. Их события ключей распознаются, поэтому гаражи и магазины продолжат работать
- 4Предметы-отмычки: в большинстве серверов QBCore уже есть lockpick и advancedlockpick, в противном случае см. install/items_qbcore.lua, install/items_ox_inventory.lua или install/items_esx.sql
- 5Необязательно: добавьте add_ace group.admin agency.vehiclekeys.admin allow для вкладок Admin и Settings в /keys
- 6Обновление с V1: замените старую папку и используйте новый config.lua. Ключи, выданные в V1 (simple_carkeys_shared), будут перенесены при первом запуске
02Зависимости
Зависимости не требуютсяQBCore, QBox или ESX (необязательно, без фреймворка работает в режиме standalone)oxmysql (необязательно, без него ключи сохраняются в хранилище ключей сервера)Инвентарь для отмычек (необязательно: ox_inventory, qs-inventory, qb-inventory и его форки или ESX)Скрипт диспетчерской (необязательно: ps-dispatch, cd_dispatch, qs-dispatch, rcore_dispatch, core_dispatch, tk_dispatch или lb-tablet)Agency-Notify (необязательно, сообщения в классическом стиле V1)
03SQL файл
Необязательно: ресурс сам создаёт эти таблицы при запуске. Импортируйте файл, только если настраиваете базу данных вручную:
-- Agency Vehiclekeys V2
-- Optional: the script creates this table by itself on the first start when
-- oxmysql runs. Run it by hand only if your database user may not create tables.
CREATE TABLE IF NOT EXISTS `agency_vehiclekeys` (
`plate` VARCHAR(16) NOT NULL,
`identifier` VARCHAR(96) NOT NULL,
`kind` VARCHAR(12) NOT NULL DEFAULT 'shared',
`holder` VARCHAR(64) NULL DEFAULT NULL,
`granted_by` VARCHAR(96) NULL DEFAULT NULL,
`model` VARCHAR(32) NULL DEFAULT NULL,
`created` INT UNSIGNED NOT NULL DEFAULT 0,
PRIMARY KEY (`plate`, `identifier`),
KEY `identifier` (`identifier`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+Полезно знать
Agency-Vehiclekeys V2 работает сразу после строки ensure. Перед первым запуском стоит проверить пять моментов: другие скрипты ключей, предметы для взлома замков, базу данных, администраторов и ключи для работ, а также переход с V1.
- Другие важные скрипты
- Остановите qb-vehiclekeys, qbx_vehiclekeys и похожие скрипты: два скрипта управления ключами будут конфликтовать из-за одних и тех же машин. Их события ключей распознаются, поэтому гаражи и магазины продолжат работать. В скрипте, который на клиенте вызывает exports['qb-vehiclekeys']:HasKeys(plate), достаточно заменить имя на Agency-Vehiclekeys.
- Отмычки
- В Config.Lockpick.items указаны названия предметов, по умолчанию advancedlockpick и lockpick. На большинстве серверов QBCore есть оба предмета. В файлах install/items_qbcore.lua, install/items_ox_inventory.lua и install/items_esx.sql есть записи для других инвентарей. Использование предмета в инвентаре начинает попытку взлома, клавиша H делает то же самое.
- База данных
- При использовании oxmysql ключи сохраняются в таблице agency_vehiclekeys, которую скрипт создаёт самостоятельно. Без oxmysql они сохраняются в хранилище ключей сервера. Файл install/agency_vehiclekeys.sql нужен только в том случае, если пользователь базы данных не может создавать таблицы.
- Права администраторов и ключи для работ
- Администраторы , это игроки с ACE agency.vehiclekeys.admin, группой group.admin или group.superadmin либо группой, указанной в Config.AdminGroups. На серверах Standalone ключи для работ выдаются через разрешения ACE, например add_ace group.police agency.vehiclekeys.police allow.
- Обновление с V1
- Замените старую папку новой и используйте новый config.lua, конфигурация V1 не подходит. Ключи из simple_carkeys_shared переносятся при первом запуске. Клавиша G по-прежнему запирает машину, запуск двигателя перенесён с M на U, а команды /givekey и /removekey по-прежнему работают.
?Частые вопросы
Какие инвентари поддерживают отмычки?
ox_inventory, qs-inventory, qb-inventory и его форки, а также инвентарь ESX, определяемый с помощью Config.Inventory = 'auto'. На серверах Standalone без инвентаря можно подключить собственный, используя Config.Standalone.itemCount и removeItem, или разрешить игрокам взламывать замки без предмета.
Мой гараж использует собственную таблицу для принадлежащих игрокам машин. Что делать?
Укажите таблицу и столбцы владельца и номера машины в Config.OwnedVehicles. По умолчанию используются player_vehicles со столбцом citizenid (QBCore, Qbox) и owned_vehicles со столбцом owner (ESX).