Accueil › Documentation › Exports · origen_chat

Exports · origen_chat

origen_chat est entièrement compatible avec l’API d’exports standard de chat de FiveM. Tous les exports fonctionnent aussi bien via exports['origen_chat'] que via l’ancien système d’événements __cfx_export_chat_* (les ressources qui utilisent déjà exports['chat'] continuent donc de fonctionner sans modification).


Exports côté serveur

addMessage(target, message)

Envoie un message à un joueur (ou à tous si target = -1).

lua
exports['origen_chat']:addMessage(-1, {
    color     = { 255, 0, 0 },
    multiline = true,
    args      = { 'Server', 'Hello everyone!' },
})
 
-- Send to a specific player
exports['origen_chat']:addMessage(source, {
    args = { 'A message just for you' }
})

registerMessageHook(hook)

Enregistre un hook qui intercepte chaque message du chat avant son envoi. Le hook reçoit les données du message et peut le modifier ou l’annuler.

lua
exports['origen_chat']:registerMessageHook(function(source, outgoing, cancel)
    -- outgoing: the message object
    -- cancel(): call to prevent the message from being sent
    if string.find(outgoing.args[1], 'badword') then
        cancel()
    end
end)

registerCommand(commands, handler, properties)

Enregistre une commande serveur qui apparaît dans l’autocomplétion du chat.

lua
exports['origen_chat']:registerCommand('mycommand', function(source, args, rawCommand)
    print('Command used by', source)
end, {
    help   = 'My custom command',
    params = {
        { name = 'target', help = 'Player ID' }
    }
})

resetChat(target)

Efface l’historique du chat d’un joueur (ou de tous si target = -1).

lua
exports['origen_chat']:resetChat(-1)

Exports côté client

addMessage(message)

Affiche un message dans le chat du joueur local.

lua
exports['origen_chat']:addMessage({
    color     = { 255, 255, 0 },
    multiline = true,
    args      = { 'System', 'You have received a reward!' },
})

addSuggestion(name, help, params)

Ajoute une suggestion d’autocomplétion de commande à la saisie du chat.

lua
exports['origen_chat']:addSuggestion('/mycommand', 'Does something useful', {
    { name = 'target', help = 'Player ID' }
})

removeSuggestion(name)

Supprime une suggestion d’autocomplétion de commande.

lua
exports['origen_chat']:removeSuggestion('/mycommand')

clearChat()

Efface tous les messages du chat du joueur local.

lua
exports['origen_chat']:clearChat()