Configuração

Todas as configurações ficam no config.lua, que permanece aberto (não criptografado). Por padrão, cada detecção está em 'auto': você só precisa alterá-las se a detecção automática não funcionar no seu servidor.

Framework

HZBridge.Framework = 'auto'

Inventário

HZBridge.Inventory = 'auto'

• qb-inventory fica por último porque vem com o QBCore: um servidor que roda outro inventário ao lado dele usa esse outro.
• GetDetectedInventory() informa o hz\_inventory como ox_inventory, já que ele usa o mesmo adaptador.
• No QBox e no Ox Core, o hz_lib usa ox_inventory mesmo antes de ele iniciar.
• Em 'auto', um inventário que inicia depois do hz_lib é detectado assim que inicia. Um valor forçado desativa isso.

Notificações

HZBridge.Notifications = 'auto'

Target / Interação

HZBridge.Target = 'auto'

Menu / UI

HZBridge.Menu = 'auto'

Dispatch

HZBridge.Dispatch = 'auto'

Banco (contas de sociedade)

HZBridge.Banking = 'auto'

A conta de sociedade (a conta do chefe de um emprego ou de uma gangue) na qual os scripts HZ depositam e da qual retiram dinheiro, por exemplo a receita de um negócio.

• O banco é detectado uma única vez, quando o hz_lib inicia. Um banco que inicia depois do hz_lib não é visto: force-o aqui.
• Exceção: em 'auto', o HZ-Banking assume quando inicia depois do hz_lib, e devolve o controle ao banco anterior quando para.
• Alguns bancos só permitem adicionar dinheiro. Os scripts verificam isso com o export GetBankingSupports.

Callbacks

HZBridge.Callback = {
    Timeout   = 15000,  -- ms before timeout (default 15s)
    RateLimit = 50,     -- max requests/second per player (0 = disabled)
}

Relé do dispatch

HZBridge.DispatchRelay = {
    RateLimit         = 5,
    RateLimitWindowMs = 10000,
    MaxTextLength     = 200,
    MaxJobs           = 20,
}

Limites que o servidor aplica aos alertas de dispatch que os jogadores enviam pelo hz_lib.

Idioma

HZBridge.Locale = 'en'

Idioma do painel de administração, das mensagens do próprio hz_lib e das teclas mostradas no diálogo com NPC. Vem com 'en' e 'fr'. Você pode adicionar locales/<idioma>.lua para as mensagens do hz_lib; o painel em si só existe em inglês e francês, e aparece em inglês para qualquer outro idioma.

Painel de administração

HZBridge.Panel = {
    AcePermission      = 'admin',
    DevAllowAll        = false,
    RateLimitWrites    = 10,
    RateLimitWindowMs  = 5000,
    SessionTokenTtlMs  = 5 * 60 * 1000,
    AuditRetentionDays = 90,
}

Controle de acesso

HZBridge.Panel.AccessControl = {
    Enabled               = true,
    Resolution            = 'union',
    CapsMemoTtlMs         = 1000,
    ScrapePermissionsCfg  = true,
    PermissionsCfgPath    = 'config/permissions.cfg',
    RestartRequiresManage = false,
    CuratedGroups         = {
        'god', 'owner', 'superadmin', 'admin', 'headadmin', 'sradmin',
        'dev', 'developer', 'mod', 'moderator', 'trialmod', 'support', 'helper',
    },
    RescanCooldownMs      = 30000,
}

Cargos da staff com acesso por módulo. Um cargo é um grupo ACE (group.admin, group.mod…) ou um grupo de staff do framework. Em cada módulo, um cargo recebe um ou mais destes três direitos:

• view: ler as configurações do módulo
• config: alterar as configurações salvas dele
• manage: usar as ações ao vivo dele (por exemplo, mudar o clima agora)

• Na primeira inicialização, o grupo por trás de AcePermission (group.admin por padrão) recebe acesso total e o direito de editar os acessos, para que ninguém fique trancado do lado de fora. Os grupos admin do framework (admin, god, superadmin, owner) encontrados nesse momento recebem acesso total aos módulos, mas não o direito de editar os acessos.
• Um jogador cujos grupos não correspondem a nenhum cargo mantém o acesso total se tiver AcePermission (ou o ACE command). Um jogador que corresponde a um cargo mantém os limites desse cargo.
• Ficou sem acesso? Execute hzaccess_recover <grupo> no console do servidor (por exemplo hzaccess_recover admin): esse grupo recupera o acesso total e o direito de editar os acessos.

Reiniciar os dependentes

HZBridge.AutoRestartDependents = false

Parar o hz_lib também para todos os recursos que dependem dele. Com true, esses recursos são iniciados de novo assim que o hz_lib volta. Desativado por padrão: isso também iniciaria os recursos que você mantém parados de propósito.

Debug

HZBridge.Debug = false

Coloque true para ativar os logs detalhados com o prefixo [HZ Bridge] no console. Útil para diagnosticar problemas de detecção.

Exemplo completo

HZBridge = {}

HZBridge.Framework     = 'auto'
HZBridge.Inventory     = 'auto'
HZBridge.Notifications = 'auto'
HZBridge.Dispatch      = 'auto'
HZBridge.Target        = 'auto'
HZBridge.Menu          = 'auto'
HZBridge.Banking       = 'auto'

HZBridge.Callback = {
    Timeout   = 15000,
    RateLimit = 50,
}

HZBridge.DispatchRelay = {
    RateLimit         = 5,
    RateLimitWindowMs = 10000,
    MaxTextLength     = 200,
    MaxJobs           = 20,
}

HZBridge.Locale = 'en'

HZBridge.Panel = {
    AcePermission      = 'admin',
    DevAllowAll        = false,
    RateLimitWrites    = 10,
    RateLimitWindowMs  = 5000,
    SessionTokenTtlMs  = 5 * 60 * 1000,
    AuditRetentionDays = 90,
}

HZBridge.Panel.AccessControl = {
    Enabled               = true,
    Resolution            = 'union',
    CapsMemoTtlMs         = 1000,
    ScrapePermissionsCfg  = true,
    PermissionsCfgPath    = 'config/permissions.cfg',
    RestartRequiresManage = false,
    CuratedGroups         = {
        'god', 'owner', 'superadmin', 'admin', 'headadmin', 'sradmin',
        'dev', 'developer', 'mod', 'moderator', 'trialmod', 'support', 'helper',
    },
    RescanCooldownMs      = 30000,
}

HZBridge.AutoRestartDependents = false

HZBridge.Debug = false