Inicio › Documentación › Exports · origen_chat

Exports · origen_chat

origen_chat es totalmente compatible con la API de exports estándar de chat de FiveM. Todos los exports funcionan tanto con exports['origen_chat'] como con el sistema de eventos heredado __cfx_export_chat_* (por lo que los recursos que ya usan exports['chat'] seguirán funcionando sin cambios).


Exports del servidor

addMessage(target, message)

Envía un mensaje a un jugador (o a todos 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)

Registra un hook que intercepta cada mensaje del chat antes de enviarlo. El hook recibe los datos del mensaje y puede modificarlo o cancelarlo.

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)

Registra un comando del servidor que aparece en el autocompletado del 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)

Borra el historial del chat de un jugador (o de todos si target = -1).

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

Exports del cliente

addMessage(message)

Muestra un mensaje en el chat del jugador local.

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

addSuggestion(name, help, params)

Añade una sugerencia de autocompletado de comandos a la entrada del chat.

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

removeSuggestion(name)

Elimina una sugerencia de autocompletado de comandos.

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

clearChat()

Borra todos los mensajes del chat del jugador local.

lua
exports['origen_chat']:clearChat()