Konfiguration

Alle Einstellungen stehen in config.lua, die offen bleibt (nicht verschlüsselt). Standardmäßig steht jede Erkennung auf 'auto': Sie müssen sie nur ändern, wenn die automatische Erkennung auf Ihrem Server nicht funktioniert.

Framework

HZBridge.Framework = 'auto'

Inventar

HZBridge.Inventory = 'auto'

• qb-inventory kommt zuletzt, weil es mit QBCore ausgeliefert wird: Ein Server, der daneben ein anderes Inventar betreibt, nutzt dieses.
• GetDetectedInventory() meldet hz\_inventory als ox_inventory, da es denselben Adapter nutzt.
• Auf QBox und Ox Core nutzt hz_lib ox_inventory, auch bevor es gestartet ist.
• Bei 'auto' wird ein Inventar, das nach hz_lib startet, bei seinem Start erkannt. Ein erzwungener Wert schaltet das ab.

Benachrichtigungen

HZBridge.Notifications = 'auto'

Target / Interaktion

HZBridge.Target = 'auto'

Menü / UI

HZBridge.Menu = 'auto'

Dispatch

HZBridge.Dispatch = 'auto'

Bank (Firmenkonten)

HZBridge.Banking = 'auto'

Das Firmenkonto (Chefkonto eines Jobs oder einer Gang), auf das HZ-Scripts einzahlen und von dem sie abbuchen, zum Beispiel die Einnahmen eines Geschäfts.

• Die Bank wird nur einmal erkannt, beim Start von hz_lib. Eine Bank, die nach hz_lib startet, wird nicht gesehen: Erzwingen Sie sie hier.
• Ausnahme: Bei 'auto' übernimmt HZ-Banking, wenn es nach hz_lib startet, und gibt beim Stoppen an die vorherige Bank zurück.
• Manche Banken erlauben nur das Einzahlen. Scripts prüfen das mit dem Export GetBankingSupports.

Callbacks

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

Dispatch-Weiterleitung

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

Grenzen, die der Server auf Dispatch-Alarme anwendet, die Spieler über hz_lib senden.

Sprache

HZBridge.Locale = 'en'

Sprache des Admin-Panels, der eigenen Meldungen von hz_lib und der Tastenhinweise im NPC-Dialog. Mitgeliefert: 'en' und 'fr'. Sie können locales/<sprache>.lua für die Meldungen von hz_lib hinzufügen; das Panel selbst gibt es nur auf Englisch und Französisch, bei jeder anderen Sprache erscheint es auf Englisch.

Admin-Panel

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

Zugriffskontrolle

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

Staff-Rollen mit Zugriff pro Modul. Eine Rolle ist eine ACE-Gruppe (group.admin, group.mod…) oder eine Staff-Gruppe des Frameworks. Pro Modul erhält eine Rolle eines oder mehrere dieser drei Rechte:

• view: die Einstellungen des Moduls lesen
• config: seine gespeicherten Einstellungen ändern
• manage: seine Live-Aktionen nutzen (zum Beispiel das Wetter sofort ändern)

• Beim ersten Start erhält die Gruppe hinter AcePermission (standardmäßig group.admin) vollen Zugriff und das Recht, Zugriffe zu bearbeiten, damit niemand ausgesperrt wird. Admin-Gruppen des Frameworks (admin, god, superadmin, owner), die dabei gefunden werden, erhalten vollen Zugriff auf die Module, aber nicht das Recht, Zugriffe zu bearbeiten.
• Ein Spieler, dessen Gruppen zu keiner Rolle passen, behält vollen Zugriff, wenn er AcePermission (oder das ACE command) hat. Ein Spieler, der zu einer Rolle passt, behält die Grenzen dieser Rolle.
• Ausgesperrt? Führen Sie hzaccess_recover <gruppe> in der Serverkonsole aus (zum Beispiel hzaccess_recover admin): Diese Gruppe erhält wieder vollen Zugriff und das Recht, Zugriffe zu bearbeiten.

Abhängige Ressourcen neu starten

HZBridge.AutoRestartDependents = false

Wird hz_lib gestoppt, stoppen auch alle Ressourcen, die davon abhängen. Mit true werden diese Ressourcen wieder gestartet, sobald hz_lib zurück ist. Standardmäßig aus: Es würde auch Ressourcen starten, die Sie absichtlich gestoppt lassen.

Debug

HZBridge.Debug = false

Auf true setzen, um ausführliche Logs mit dem Präfix [HZ Bridge] in der Konsole zu aktivieren. Nützlich, um Erkennungsprobleme zu untersuchen.

Vollständiges Beispiel

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