Início › Documentação › Configuração · origen_chat

Configuração · origen_chat

A configuração está repartida por vários ficheiros dentro de config/.

config/_main.lua

Variável Por omissão Descrição
Config.Language 'en' Idioma da interface — 'en' | 'es' | 'fr' | 'it'
Config.CustomNotify false Usa Custom.Notify em vez das notificações do ox_lib
Config.CommandName 'toggleChat' Comando para mostrar ou ocultar a interface do chat
Config.ShowEmojisOption true Mostra o seletor de emojis na interface do chat
Config.DefaultColor '#850e49f2' Cor de fundo do chat por omissão (hex RGBA)
Config.ShowServerPrints false Mostra no chat a saída de print() do servidor
Config.Debug false Ativa os logs de depuração

Permitir a personalização pelo jogador

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 os comandos do chat. Cada comando suporta um tipo de mensagem diferente.

Tipos de mensagem

Tipo Descrição
proximity Enviada aos jogadores a menos de distance metros
global Enviada a todos os jogadores do servidor
player-to-player Enviada de um jogador específico para outro
global-announcement Enviada a todos os jogadores, com formato de anúncio
job-to-job Enviada a todos os jogadores que partilham o mesmo trabalho
job-to-global Enviada por um membro de um trabalho a todos os jogadores

Campos de um comando

Campo Descrição
enabled Ativa ou desativa o comando
color Cor da mensagem (hex)
icon Nome do ícone do Lucide (p. ex. 'lucide:user')
command Texto do comando de chat (p. ex. 'me')
distance Raio em metros para o tipo proximity. false = global
preventCollisions Se for true, as paredes e portas bloqueiam a mensagem
showNameInsteadOfId Mostra o nome do jogador em vez do ID do servidor
showGradeAndJob Mostra o trabalho e o grau no prefixo da mensagem
permissions Array de grupos necessários para usar o comando
groups Tabela de job_name = min_grade necessária para usar o comando
type Tipo de mensagem (ver a tabela acima)
params Definições de parâmetros adicionais do comando

Comandos por omissão

Comando Tipo Descrição
/me proximity (15m) Ação de roleplay
/do proximity (10m) Descrição da cena
/ooc global Mensagem global fora de personagem
/msg player-to-player Mensagem privada para um jogador específico
/announcement global-announcement Anúncio para todo o servidor (apenas admin)
/lspd job-to-job Chat interno da polícia (desativado por omissão)
/ems job-to-job Chat interno do EMS (desativado por omissão)
/announce-lspd job-to-global Comunicado da polícia para todos (desativado por omissão)
/announce-ems job-to-global Comunicado do EMS para todos (desativado por omissão)

Adicionar um 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

Prefixos de comandos que não aparecem como sugestões de preenchimento automático:

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

config/custom_core.lua

Usa este ficheiro para fornecer um objeto core próprio se não usares um framework standard:

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