KLB UI

KLB · UI

The official UI Core for every KLB script. Clean. Fast. Modern. Reusable.

KLB-UI gives you a unified, KLB-style interface for:

• 🔔 Notifications

• 📊 Progress Bar

• 🎮 5+ Minigames (hacking, skill checks, timing, etc.)

Install this resource once, and it becomes the shared UI backend for all existing and future KLB scripts --- and you can also use it in your own scripts.

---

⭐ Features Overview

🔔 KLB Notify

• Sleek, modern UI\

• Stacking notifications\

• Optional progress indicator\

• Automatically formats common QBCore notifications\

• Export usable from any script

---

📊 KLB Progress Bar

• Smooth, clean animation\

• Cancel support\

• Uses NUI focus only when needed\

• Fully compatible with QBCore overrides\

• Automatic fallback handling if KLB-UI is missing

---

🎮 KLB Minigames (5+)

All minigames share the same KLB design vibe --- clean, centered, responsive and fast.

Included minigames: - Classic Hack - Timing Circle - Skill Click - Rapid Code - Key Sequence - + More coming soon

Each minigame: - Has success/fail callback\

• Accepts difficulty & custom options\

• Opens smoothly and closes cleanly\

• Can be used anywhere (robberies, crafting, delivery jobs, police checks, etc.)

---

📥 Installation

1. Drag klb-ui into your resources folder.

2. Add this to your server.cfg:

<!-- -->

ensure klb-ui

3. Remove any old progressbar:

<!-- -->

[standalone]/progressbar

4. (Optional for QBCore) Replace Notify & Progressbar functions.

---

🧩 Exports

🔔 Notify

exports['klb-ui']:Notify("Hello world!", "info", 5000)

---

📊 Progress Bar

exports['klb-ui']:Progress({
    label = "Searching...",
    duration = 6000,
    canCancel = true,
}, function(cancelled)
    if cancelled then print("Cancelled") else print("Finished") end
end)

---

🎮 Minigames

Classic Hack

exports['klb-ui']:StartClassicHack(function(success)
    print("Hack:", success)
end)

Hacking Sequence

exports['klb-ui']:StartHacking(function(success)
    print("Sequence:", success)
end, { difficulty = 2 })

---

🔧 QBCore Replacements

Notify (line 169)

function QBCore.Functions.Notify(text, textype, length)
    local ttype   = textype or 'info'
    local tlength = length or 8500

    if type(text) == "table" then
        local ttext = text.text or 'Placeholder'
        exports['klb-ui']:Notify(ttext, ttype, tlength)
    else
        exports['klb-ui']:Notify(text or 'Placeholder', ttype, tlength)
    end
end

Progressbar (line 184)

function QBCore.Functions.Progressbar(name, label, duration, useWhileDead, canCancel, disableControls, animation, prop, propTwo, onFinish, onCancel)
    if GetResourceState('klb-ui') == 'started' then
        return exports['klb-ui']:QBProgress({
            name = name,
            label = label,
            duration = duration,
            useWhileDead = useWhileDead,
            canCancel = canCancel,
            controlDisables = disableControls,
            animation = animation,
            prop = prop,
            propTwo = propTwo,
        }, function(cancelled)
            if cancelled then if onCancel then onCancel() end
            else if onFinish then onFinish() end end
        end)
    end

    if GetResourceState('progressbar') == 'started' then
        return exports['progressbar']:Progress({
            name = (name or 'progress'):lower(),
            duration = duration,
            label = label,
            useWhileDead = useWhileDead,
            canCancel = canCancel,
            controlDisables = disableControls,
            animation = animation,
            prop = prop,
            propTwo = propTwo,
        }, function(cancelled)
            if cancelled then if onCancel then onCancel() end
            else if onFinish then onFinish() end end
        end)
    end

    local start = GetGameTimer()
    local ends  = start + (duration or 0)
    CreateThread(function()
        while GetGameTimer() < ends do Wait(0) end
        if onFinish then onFinish() end
    end)
end

---

🧹 Remove Old Files

[standalone]/progressbar

---

🛠️ Troubleshooting

• Notify not showing? Ensure klb-ui is started before other scripts.

• Minigame not closing? Don't modify NUI callbacks.

---

🤝 Support

You can get support on the Discord in the support channel. Don't DM a developer --- use the support channel so staff can help you.

---

📦 License

Free to use. Reselling or redistributing is not allowed.