Configuración

Todos los ajustes están en config.lua, que queda abierto (sin cifrar). Por defecto, cada detección está en 'auto': solo tienes que cambiarlas si la detección automática no funciona con tu servidor.

Framework

HZBridge.Framework = 'auto'

Inventario

HZBridge.Inventory = 'auto'

• qb-inventory va el último porque viene con QBCore: un servidor que usa otro inventario a su lado usa ese otro.
• GetDetectedInventory() devuelve ox_inventory para hz\_inventory, ya que usa el mismo adaptador.
• En QBox y Ox Core, hz_lib usa ox_inventory incluso antes de que arranque.
• En 'auto', un inventario que arranca después de hz_lib se detecta en cuanto arranca. Un valor forzado desactiva esto.

Notificaciones

HZBridge.Notifications = 'auto'

Target / Interacción

HZBridge.Target = 'auto'

Menú / UI

HZBridge.Menu = 'auto'

Dispatch

HZBridge.Dispatch = 'auto'

Banca (cuentas de sociedad)

HZBridge.Banking = 'auto'

La cuenta de sociedad (la cuenta del jefe de un trabajo o de una banda) en la que los scripts HZ ingresan y de la que retiran dinero, por ejemplo los ingresos de un negocio.

• El banco se detecta una sola vez, cuando arranca hz_lib. Un banco que arranca después de hz_lib no se ve: fuérzalo aquí.
• Excepción: en 'auto', HZ-Banking toma el control cuando arranca después de hz_lib, y lo devuelve al banco anterior cuando se detiene.
• Algunos bancos solo permiten añadir dinero. Los scripts lo comprueban con el export GetBankingSupports.

Callbacks

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

Relé del dispatch

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

Límites que el servidor aplica a las alertas de dispatch que los jugadores envían a través de hz_lib.

Idioma

HZBridge.Locale = 'en'

Idioma del panel de administración, de los mensajes propios de hz_lib y de las teclas que muestra el diálogo con NPC. Incluye 'en' y 'fr'. Puedes añadir locales/<idioma>.lua para los mensajes de hz_lib; el panel en sí solo existe en inglés y en francés, y se muestra en inglés para cualquier otro idioma.

Panel de administración

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

Control de acceso

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,
}

Roles del staff con acceso por módulo. Un rol es un grupo ACE (group.admin, group.mod…) o un grupo de staff del framework. En cada módulo, un rol recibe uno o varios de estos tres derechos:

• view: leer los ajustes del módulo
• config: cambiar sus ajustes guardados
• manage: usar sus acciones en directo (por ejemplo, cambiar el clima ahora)

• En el primer arranque, el grupo detrás de AcePermission (group.admin por defecto) recibe acceso completo y el derecho de editar los accesos, para que nadie se quede fuera. Los grupos admin del framework (admin, god, superadmin, owner) encontrados en ese momento reciben acceso completo a los módulos, pero no el derecho de editar los accesos.
• Un jugador cuyos grupos no coinciden con ningún rol conserva el acceso completo si tiene AcePermission (o el ACE command). Un jugador que coincide con un rol conserva los límites de ese rol.
• ¿Te has quedado fuera? Ejecuta hzaccess_recover <grupo> en la consola del servidor (por ejemplo hzaccess_recover admin): ese grupo recupera el acceso completo y el derecho de editar los accesos.

Reinicio de las dependencias

HZBridge.AutoRestartDependents = false

Detener hz_lib también detiene todos los recursos que dependen de él. Con true, esos recursos se vuelven a iniciar en cuanto hz_lib vuelve. Desactivado por defecto: también iniciaría los recursos que mantienes detenidos a propósito.

Debug

HZBridge.Debug = false

Ponlo en true para activar los logs detallados con el prefijo [HZ Bridge] en la consola. Útil para diagnosticar problemas de detección.

Ejemplo 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