QBESXStandalone

Agency-Vehiclekeys V2 Instalação

Chaves universais para veículos no FiveM, compatíveis com QBCore, Qbox, ESX ou totalmente standalone.

v2.0.0Pago5 Páginas

Comprar Voltar ao catálogo

01Instalação

1Coloque Agency-Vehiclekeys na pasta resources
2Adicione ensure Agency-Vehiclekeys a server.cfg, depois do seu framework, oxmysql e do seu inventário
3Pare outros scripts de chaves, como qb-vehiclekeys. Os eventos de chaves deles são reconhecidos, então as garagens e lojas continuam funcionando
4Itens de gazua: a maioria dos servidores QBCore já tem lockpick e advancedlockpick; caso contrário, consulte install/items_qbcore.lua, install/items_ox_inventory.lua ou install/items_esx.sql
5Opcional: adicione add_ace group.admin agency.vehiclekeys.admin allow para as abas Admin e Settings de /keys
6Atualizando da V1: substitua a pasta antiga e use o novo config.lua. As chaves distribuídas na V1 (simple_carkeys_shared) são migradas na primeira inicialização

02Dependências

Não é necessária nenhuma dependência
QBCore, QBox ou ESX (opcional, sem nenhum funciona em modo standalone)
oxmysql (opcional, sem ele, as chaves são salvas no armazenamento de chave-valor do servidor)
Um inventário para gazuas (opcional: ox_inventory, qs-inventory, qb-inventory e seus forks ou ESX)
Um script de despacho (opcional: ps-dispatch, cd_dispatch, qs-dispatch, rcore_dispatch, core_dispatch, tk_dispatch ou lb-tablet)
Agency-Notify (opcional, mensagens no visual clássico da V1)

03Arquivo SQL

Opcional: o recurso cria estas tabelas sozinho ao iniciar. Importe este arquivo só se você preparar o banco de dados manualmente:

-- 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;

+Bom saber

Agency-Vehiclekeys V2 funciona logo após a linha ensure. Vale a pena conferir cinco pontos antes da primeira inicialização: outros scripts de chaves, os itens de gazua, o banco de dados, os administradores e as chaves de emprego, e a migração da V1.

Outros scripts importantes: Pare qb-vehiclekeys, qbx_vehiclekeys e scripts semelhantes, pois dois scripts de chaves entrariam em conflito pelos mesmos veículos. Os eventos de chaves deles são reconhecidos, então garagens e lojas continuam funcionando. Um script que chama exports['qb-vehiclekeys']:HasKeys(plate) apenas no cliente só precisa ter o nome alterado para Agency-Vehiclekeys.
Itens de gazua: Config.Lockpick.items define os nomes dos itens, por padrão advancedlockpick e lockpick. A maioria dos servidores QBCore tem ambos. install/items_qbcore.lua, install/items_ox_inventory.lua e install/items_esx.sql contêm as entradas para os outros inventários. Usar o item no inventário inicia uma tentativa, H faz o mesmo.
Banco de dados: Com oxmysql, as chaves são salvas na tabela agency_vehiclekeys, que o script cria automaticamente. Sem oxmysql, elas são salvas no armazenamento de chave-valor do servidor. install/agency_vehiclekeys.sql só é necessário se o usuário do banco de dados não puder criar tabelas.
Administradores e chaves de emprego: Administradores são jogadores com o ACE agency.vehiclekeys.admin, o grupo admin ou superadmin, ou um grupo definido em Config.AdminGroups. Em servidores standalone, as chaves de emprego vêm das permissões ACE, por exemplo, add_ace group.police agency.vehiclekeys.police allow.
Atualização da V1: Substitua a pasta antiga pela nova e use o novo config.lua, a configuração da V1 não é compatível. As chaves de simple_carkeys_shared são transferidas na primeira inicialização. G continua trancando, o motor foi movido de M para U, e /givekey e /removekey continuam funcionando.

?Perguntas frequentes

Quais inventários são compatíveis com gazuas?

ox_inventory, qs-inventory, qb-inventory e seus forks, além do inventário ESX, detectado por Config.Inventory = 'auto'. Servidores standalone sem inventário podem conectar o próprio inventário com Config.Standalone.itemCount e removeItem, ou permitir que os jogadores tentem sem um item.

Minha garagem usa uma tabela própria para veículos pertencentes aos jogadores. O que devo fazer?

Defina Config.OwnedVehicles como a tabela e as colunas do proprietário e da placa. Por padrão, são usadas player_vehicles com citizenid (QBCore, Qbox) e owned_vehicles com owner (ESX).