izzy HUD v5

Izzy HUD v5 ist ein konfigurierbares Spieler- und Fahrzeug-HUD für FiveM mit eigenen Benachrichtigungen und einem Fortschrittsbalken. Das Manifest hängt nur ab von baseevents; die beiliegende README zeigt, wie du es mit QBCore verbindest. Bei anderen Frameworks musst du deine Benachrichtigungs- und Fortschrittsfunktionen selbst anpassen.

Funktionen

• Spielerstatus HUD und Fahrzeug HUD mit klassischen und modernen Tacho-Stilen
• Quadratische und kreisförmige Minimap-Texturen
• Gurt-, Radio- und Stress-Module
• Waffensymbole im HUD
• Benachrichtigungs- und Fortschrittsleisten-Exporte (addNotification und Progress)
• Einstellungen in shared/cfg.lua; Gurt, Fortschritt, Stress und geteilte Dateien sind zur Bearbeitung offen

QBCore-Integrationsbeispiele

Der mitgelieferte Client-Code stellt Progress(action, finish) und addNotification(type, title, message, duration). bereit. Das folgende Beispiel ist aus der beiliegenden README angepasst: Benachrichtigungsaufrufe übergeben den normalisierten texttype Wert- und Sektionslabels verwenden Lua-Kommentare. Integriere diese Funktionen in deine QBCore-Client-Funktionen, anstatt sie als separate Ressource auszuführen.

-- Progress bar

function QBCore.Functions.Progressbar(name, label, duration, useWhileDead, canCancel, disableControls, animation, prop, propTwo, onFinish, onCancel)
    exports['izzy-hudv5']:Progress({
        name = name:lower(),
        duration = duration,
        label = label,
        useWhileDead = useWhileDead,
        canCancel = canCancel,
        controlDisables = disableControls,
        animation = animation,
        prop = prop,
        propTwo = propTwo,
    }, function(cancelled)
        if not cancelled then
            if onFinish then
                onFinish()
            end
        else
            if onCancel then
                onCancel()
            end
        end
    end)
end

-- Notification

function QBCore.Functions.Notify(text, texttype, length)
    texttype = texttype == "success" and "success" or texttype == "error" and "error" or "inform"
    length = length or 5000
    if type(text) == 'table' then
        local ttext = text.text or 'Placeholder'
        local caption = text.caption or 'Placeholder'
        exports['izzy-hudv5']:addNotification(texttype, ttext, caption, length)
    else
        exports['izzy-hudv5']:addNotification(texttype, texttype == 'error' and 'Error' or texttype == 'success' and 'Success' or 'Notify', text, length)
    end
end

-- Stress Events (client side)

TriggerEvent("izzy-hudv5:client:gainStress", math.random(1, 3))
TriggerEvent("izzy-hudv5:client:relieveStress", math.random(1, 3))

Konfiguration und Anforderungen

Die Manifestdatei erklärt baseevents und basiert auf dem FiveM Asset-Escrow-System (/assetpacks), daher muss dein Server für die Ressource berechtigt sein. Bearbeite shared/cfg.lua für HUD-Aktualisierungsintervalle, Kompass-/Standortsichtbarkeit, Gurtwarnungen, Tastenbelegungen, Sprachreichweiten und Stresseinstellungen. Die Stress-Aufrufe im Beispiel sind Client-Events; sie dienen als Beispiele für die Integration in die entsprechenden Gameplay-Skripte.