Skip to Content
Mizu InterfaceIntegrations

Integrations & Replacements

🔌
One change, zero rewrites
Override your framework’s core notification function once — every script on your server immediately routes through Mizu Interface automatically.
⚠️
Warning

These edits modify framework core files. Always back up before making changes. The modifications are minimal, safe, and fully reversible.

Framework Integrations

QBCore
QBCore — qb-core

Client-side

File: qb-core/client/functions.lua
Search for: function QBCore.Functions.Notify(text, texttype, length, icon)

Replace the entire function with:

function QBCore.Functions.Notify(text, texttype, length)
    if type(text) == "table" then
        exports['mizu_interface']:Notify({
            title = text.caption or 'SYSTEM',
            message = text.text or 'Placeholder',
            type = texttype or 'info',
            duration = length or 5000
        })
    else
        exports['mizu_interface']:Notify({
            message = text,
            type = texttype or 'info',
            duration = length or 5000
        })
    end
end

Server-side

File: qb-core/server/functions.lua
Search for: function QBCore.Functions.Notify(source, text, type, length)

Replace with:

function QBCore.Functions.Notify(source, text, type, length)
    TriggerClientEvent('mizu_interface:client:Notify', source, {
        message = text,
        type = type or 'info',
        duration = length or 5000
    })
end

Progress Bar Integration

Instead of globally replacing the progress bar across your framework, we recommend replacing it directly in scripts that use it — this ensures maximum stability and protects items from cancel-exploit duplication.

Example: Drinking Water (qb-smallresources)

RegisterNetEvent('consumables:client:Drink', function(itemName)
    exports.mizu_interface:ProgressBar({
        duration = 5000,
        label = Lang:t('consumables.drink_progress'),
        icon = 'bottle-water',
        canCancel = true,
        disable = {
            movement = false,
            car = false,
            mouse = false,
            combat = true,
            inventory = true
        },
        animation = {
            animDict = 'mp_player_intdrink',
            anim = 'loop_bottle',
            flags = 49
        },
        prop = {
            model = 'vw_prop_casino_water_bottle_01a',
            bone = 60309,
            coords = vec3(0.0, 0.0, -0.05),
            rotation = vec3(0.0, 0.0, -40.0)
        },
        onFinish = function(isCanceled)
            if not isCanceled then
                TriggerEvent('qb-inventory:client:ItemBox', QBCore.Shared.Items[itemName], 'remove')
                TriggerServerEvent('consumables:server:addThirst', ...)
            else
                QBCore.Functions.Notify(Lang:t('consumables.canceled'), 'error')
                TriggerServerEvent('QBCore:Server:AddItem', itemName, 1)
            end
        end
    })
end)
Last updated on
EventsPreview