Inicio › Documentación › Configuración · origen_chat

Configuración · origen_chat

La configuración está repartida en varios ficheros dentro de config/.

config/_main.lua

Variable Por defecto Descripción
Config.Language 'en' Idioma de la interfaz — 'en' | 'es' | 'fr' | 'it'
Config.CustomNotify false Usa Custom.Notify en lugar de las notificaciones de ox_lib
Config.CommandName 'toggleChat' Comando para mostrar u ocultar la interfaz del chat
Config.ShowEmojisOption true Muestra el selector de emojis en la interfaz del chat
Config.DefaultColor '#850e49f2' Color de fondo del chat por defecto (hex RGBA)
Config.ShowServerPrints false Muestra en el chat la salida de print() del servidor
Config.Debug false Activa los logs de depuración

Permitir la personalización por el jugador

lua
Config.AllowEdit = {
    color    = true,   -- player can change chat background color
    position = true,   -- player can reposition the chat box
    size     = true,   -- player can resize the chat box
}

config/commands.lua

Define todos los comandos del chat. Cada comando admite un tipo de mensaje distinto.

Tipos de mensaje

Tipo Descripción
proximity Se envía a los jugadores que estén a menos de distance metros
global Se envía a todos los jugadores del servidor
player-to-player Se envía de un jugador concreto a otro
global-announcement Se envía a todos los jugadores con formato de anuncio
job-to-job Se envía a todos los jugadores que comparten el mismo trabajo
job-to-global Lo envía un miembro de un trabajo a todos los jugadores

Campos de un comando

Campo Descripción
enabled Activa o desactiva el comando
color Color del mensaje (hex)
icon Nombre del icono de Lucide (p. ej. 'lucide:user')
command Cadena del comando de chat (p. ej. 'me')
distance Radio en metros para el tipo proximity. false = global
preventCollisions Si es true, las paredes y puertas bloquean el mensaje
showNameInsteadOfId Muestra el nombre del jugador en lugar del ID del servidor
showGradeAndJob Muestra el trabajo y el rango en el prefijo del mensaje
permissions Array de grupos necesarios para usar el comando
groups Tabla de job_name = min_grade necesaria para usar el comando
type Tipo de mensaje (consulta la tabla anterior)
params Definiciones de parámetros adicionales del comando

Comandos por defecto

Comando Tipo Descripción
/me proximity (15m) Acción de rol
/do proximity (10m) Descripción de la escena
/ooc global Mensaje global fuera de personaje
/msg player-to-player Mensaje privado a un jugador concreto
/announcement global-announcement Anuncio para todo el servidor (solo admin)
/lspd job-to-job Chat interno de la policía (desactivado por defecto)
/ems job-to-job Chat interno de EMS (desactivado por defecto)
/announce-lspd job-to-global Comunicado de la policía a todos (desactivado por defecto)
/announce-ems job-to-global Comunicado de EMS a todos (desactivado por defecto)

Añadir un comando personalizado

lua
Config.Commands['my_command'] = {
    enabled             = true,
    color               = '#ffffff',
    icon                = 'lucide:user',
    preventCollisions   = false,
    distance            = false,
    command             = 'my_command',
    showNameInsteadOfId = true,
    permissions         = { 'group.admin' },
    groups              = { ['police'] = 0 },
    type                = 'global',
}

config/blacklist.lua

Prefijos de comandos que no aparecerán como sugerencias de autocompletado:

lua
Config.BlacklistedPrefixes = {
    ['+'] = true,
    ['-'] = true,
    ['_'] = true,
}

config/custom_core.lua

Usa este fichero para proporcionar un objeto core propio si no usas un framework estándar:

lua
return {
    useCustomCore = false,
    events = {
        load   = 'custom:playerLoaded',
        unload = 'custom:playerLogout',
    },
    GetCustomCoreObject = function()
        return nil -- return your core object here
    end,
}