Exports & API Reference

-- These are equivalent:
exports['oxide-chat']:addMessage(...)
exports['chat']:addMessage(...)

exports['oxide-chat']:addMessage(message)

-- Simple message
exports['oxide-chat']:addMessage('Hello world!')

-- With author
exports['oxide-chat']:addMessage({
    args = { 'System', 'Welcome to the server!' }
})

-- With color (RGB)
exports['oxide-chat']:addMessage({
    args = { 'Alert', 'Low health!' },
    color = { 255, 0, 0 }
})

-- With color (hex)
exports['oxide-chat']:addMessage({
    args = { 'Success', 'Transaction complete' },
    color = '#00FF00'
})

-- With chat type styling
exports['oxide-chat']:addMessage({
    args = { '', 'Server restarting...' },
    chatType = 'announcement'
})

exports['oxide-chat']:addSuggestion(name, help, params)

exports['oxide-chat']:addSuggestion('/pay', 'Pay a player money', {
    { name = 'id', help = 'Player server ID' },
    { name = 'amount', help = 'Amount to pay' }
})

exports['oxide-chat']:addSuggestions(suggestions)

exports['oxide-chat']:addSuggestions({
    { name = '/job', help = 'Check your current job' },
    { name = '/money', help = 'Check your balance' },
    { name = '/inventory', help = 'Open inventory', params = {} },
})

exports['oxide-chat']:removeSuggestion(name)

exports['oxide-chat']:removeSuggestion('/secretcommand')

exports['oxide-chat']:clearChat()

local enabled = exports['oxide-chat']:isEnabled()

exports['oxide-chat']:setEnabled(enabled)

-- Disable chat during cutscene
exports['oxide-chat']:setEnabled(false)

-- Re-enable after cutscene
exports['oxide-chat']:setEnabled(true)

local suggestions = exports['oxide-chat']:getSuggestions()

exports['oxide-chat']:addMessage(target, message)
-- or
exports['oxide-chat']:addMessage(message)  -- Broadcasts to all

-- Send to specific player
exports['oxide-chat']:addMessage(source, {
    args = { 'Bank', 'You deposited $1,000' },
    color = { 0, 255, 0 }
})

-- Broadcast to all players
exports['oxide-chat']:addMessage({
    args = { 'Server', 'Maintenance in 5 minutes' },
    chatType = 'announcement'
})

-- Using -1 for all
exports['oxide-chat']:addMessage(-1, {
    args = { 'Event', 'Double XP is now active!' }
})

exports['oxide-chat']:addSuggestion(target, name, help, params)

exports['oxide-chat']:removeSuggestion(target, name)

exports['oxide-chat']:clearChat(target)

exports['oxide-chat']:addTemplate(id, template)

local hookId = exports['oxide-chat']:registerMessageHook(callback)

TriggerEvent('chat:addMessage', {
    args = { 'Author', 'Message' },
    color = { 255, 255, 255 }
})

TriggerEvent('chat:addSuggestion', '/command', 'Help text', {
    { name = 'param', help = 'Parameter help' }
})

TriggerEvent('chat:addSuggestions', {
    { name = '/cmd1', help = 'Command 1' },
    { name = '/cmd2', help = 'Command 2' },
})

TriggerEvent('chat:removeSuggestion', '/command')

TriggerEvent('chat:clear')

TriggerEvent('chatMessage', 'Author', { 255, 0, 0 }, 'Message text')

TriggerClientEvent('chat:addMessage', source, {
    args = { 'Server', 'Welcome!' }
})

TriggerClientEvent('chat:addSuggestion', source, '/help', 'Show help')

TriggerClientEvent('chat:addSuggestions', source, suggestions)

TriggerClientEvent('chat:removeSuggestion', source, '/command')

TriggerClientEvent('chat:clear', source)
TriggerClientEvent('chat:clear', -1)  -- All players

-- Two elements: author and message
args = { 'John', 'Hello everyone!' }
-- Output: "John: Hello everyone!"

-- One element: message only
args = { 'System message' }
-- Output: "System message"

-- Empty author
args = { '', 'Pre-formatted message' }
-- Output: "Pre-formatted message"

-- RGB array
color = { 255, 128, 0 }

-- Hex string
color = '#FF8000'

-- Nested array (legacy support)
color = {{ 255, 128, 0 }}

-- Using templateId
{ templateId = 'announcement' }

-- Using chatType
{ chatType = 'police' }

-- Server-side
local hookId = exports['oxide-chat']:registerMessageHook(function(source, author, message)
    -- Return modified message
    return {
        author = author,
        message = message:gsub('badword', '****')
    }
end)

-- Profanity filter
exports['oxide-chat']:registerMessageHook(function(source, author, message)
    local filtered = message:gsub('badword', '****')
    return { message = filtered }
end)

-- Block messages from muted players
local mutedPlayers = {}

exports['oxide-chat']:registerMessageHook(function(source, author, message)
    if mutedPlayers[source] then
        return false  -- Cancel message
    end
end)

-- Add prefix based on player data
exports['oxide-chat']:registerMessageHook(function(source, author, message)
    local Player = QBCore.Functions.GetPlayer(source)
    if Player and Player.PlayerData.metadata.vip then
        return { author = '[VIP] ' .. author }
    end
end)

-- Server-side
RegisterNetEvent('shop:purchase', function(itemName, price)
    local src = source
    exports['oxide-chat']:addMessage(src, {
        args = { 'Shop', 'Purchased ' .. itemName .. ' for $' .. price },
        color = '#00FF00'
    })
end)

-- Server-side
function AnnounceToJob(jobName, message)
    for _, playerId in ipairs(QBCore.Functions.GetPlayers()) do
        local Player = QBCore.Functions.GetPlayer(playerId)
        if Player and Player.PlayerData.job.name == jobName then
            exports['oxide-chat']:addMessage(playerId, {
                args = { '', message },
                chatType = jobName
            })
        end
    end
end

-- Usage
AnnounceToJob('police', '[DISPATCH] 10-90 at Legion Square')

-- Client-side: Update suggestions based on job
RegisterNetEvent('QBCore:Client:OnJobUpdate', function(job)
    -- Remove old job suggestions
    exports['oxide-chat']:removeSuggestion('/oldcommand')

    -- Add new job suggestions
    if job.name == 'police' then
        exports['oxide-chat']:addSuggestion('/cuff', 'Handcuff a player')
        exports['oxide-chat']:addSuggestion('/escort', 'Escort a player')
    end
end)

-- Client-side: Disable during cutscene
function StartCutscene()
    exports['oxide-chat']:setEnabled(false)
    -- ... cutscene code ...
end

function EndCutscene()
    exports['oxide-chat']:setEnabled(true)
end

-- Config addition (config/main.lua)
Config.ChatTypes.gang = {
    prefix = 'GANG',
    color = '#9B59B6'
}

-- Server-side usage
exports['oxide-chat']:addMessage(source, {
    args = { '', gangName .. ' Radio: ' .. message },
    chatType = 'gang'
})