Skip to content

Configuração

Configuração

A configuração do BUPA Chat está dividida entre shared/config/*.lua. Todos esses arquivos estão em escrow_ignore, portanto permanecem editáveis após a compra. Esta página aborda as configurações gerais, de exibição, emojis, emotes e mensagens. Categorias e o Discord possuem suas próprias páginas.

Geral — general.lua

Teclas, sons, padrões e o sistema de máscara.

shared/config/general.lua
config.chatKey = "T"            -- key to open the chat input
config.chatVisibilityKey = ""    -- key to cycle visibility mode ("" = unbound)
config.clearCommand = { "clear", "temizle" } -- commands that clear chat history
config.closeOnOutsideClick = true            -- click outside closes the input
config.typingSound = true                    -- keyboard sound while typing
config.allowNoSlashCommands = true           -- run commands without a leading slash
config.uiUpdateRate = 24                      -- ms update rate for head indicators
config.defaultAddTag = true                   -- first arg becomes a tag when no tags given
config.showPrintsOnChat = false               -- mirror server prints into chat
config.discordTagCacheTime = 60 * 60          -- Discord role cache (seconds)
config.defaultChatCategory = "command"        -- tab focused on open

As mensagens de entrada e saída seguem os convars padrão:

lua
config.showJoinMessages = GetConvarInt('chat_showJoins', 1) == 0
config.showQuitMessages = GetConvarInt('chat_showQuits', 1) == 0

Origem do nome no chat de admin

A categoria admin pode exibir uma fonte de nome diferente do nome do personagem:

shared/config/general.lua
config.adminChatName = {
    mode = "discord",   -- "character" | "steam" | "discord"
    discord = {
        botToken = "",  -- required for "discord" mode
        guildId  = "",
        cacheTime = 600,      -- nick cache seconds
        fallback  = "steam",  -- used when a nick can't be resolved
    },
}

Nomes conscientes de máscaras — config.noneMask

O config.noneMask lista os itens vestíveis de máscara (por modelo de ped, coleção e índice) que não devem ocultar o nome de um jogador no chat. Quando ativo, o nome de um jogador mascarado é exibido como Unknown, a menos que a categoria defina showWearingMask = true ou a máscara usada esteja nesta lista de permissões.

Exibição — display.lua

Mensagens privadas — config.pm

shared/config/display.lua
config.pm = {
    active = true,
    command = { "pm", "dm" },     -- send a private message
    webhookKey = "chatMessage",   -- Discord log key
    maxLength = 300,
    sender   = { --[[ tags/color/name/id/job/discordTag/hour for the sender copy ]] },
    receiver = { --[[ same shape for the receiver copy ]] },
}

O remetente e o destinatário possuem estilos independentes (tags, color, showPlayerName, showPlayerId, showPlayerJob, discordTag, showHour).

Texto na cabeça e exibição do ID do jogador

shared/config/display.lua
config.headTextMaxStack = 4      -- max head texts stacked on one player

config.playerIdDisplay = {
    active = false,              -- show IDs above heads while chat is open
    showOwn = true,             -- include your own ID
    dist = 5.0,                 -- max display distance (m)
    template = "[{serverId}] {discordId}", -- {serverId}{name}{steamId}{discordId}{fivemId}
    headText = { bone = 31086, offset = vector3(0.3, 0.0, 0.0), maxRenderDist = 30.0 },
    cssStyle = { color = "#fff", fontSize = "1.8vh", fontWeight = "600" },
}

O template suporta os marcadores {serverId}, {name}, {steamId}, {discordId}, {fivemId}, quebras de linha \n e HTML/CSS embutido.

Emojis — emojis.lua

O seletor de emojis é totalmente baseado em dados. Cada categoria é { tab = "<icon emoji>", label = "<HEADER>", list = { ... } } e cada emoji é { emoji, name, code }.

shared/config/emojis.lua
config.emojis = {
    {
        tab = "😀", label = "SMILEYS",
        list = {
            { emoji = "😀", name = "Grinning", code = ":grinning:" },
            { emoji = "😂", name = "Joy",      code = ":joy:" },
            -- ...
        },
    },
    -- GESTURES (👍), SYMBOLS (❤️), OBJECTS (🚗)
}

Vem com quatro grupos — Smileys, Gestures, Symbols e Objects. Adicione, remova ou reordene livremente; code é o shortcode pesquisável exibido abaixo da pré-visualização.

Emotes — emotes.lua

Indicador de digitação — config.chatOpenEmote

Pontos animados acima da cabeça de um jogador enquanto ele digita:

shared/config/emotes.lua
config.chatOpenEmote = {
    active = true,
    texts = { { text = "•", time = 500 }, { text = "••", time = 500 }, { text = "•••", time = 500 } },
    cssStyle = { color = "#fff", fontSize = "1.6vh" },
    dist = 8.0,   -- how far others can see it (m)
}
config.emoteOneAtATime = true  -- one active instance of each emote command per player

Comandos de emote — config.emoteCommands

Vem com /me, /do, /dice (/zar) e /rps (/tkm). Cada emote pode reproduzir uma animação, renderizar texto na cabeça e, opcionalmente, espelhar para o chat:

shared/config/emotes.lua
{
    command = "me",
    desc = "EMOTE_ME_COMMAND_DESC",
    webhookKey = "emoteCommand",   -- Discord log (optional)
    dist = 8.0,
    time = 10000,                   -- head text duration (ms)
    template = "{text}",            -- {text} {playerName} {playerCensoredName}
    cssStyle = { color = "#b6a8ff", fontStyle = "italic" },
    sendToChat = { active = true, tags = { { tag = "ME" } }, color = { 182, 168, 255 } },
}

Campos adicionais: anim (dict, clip, flag, duration), headText (osso/offset/escala), params (argumentos digitados personalizados com teclas de ajuda) e msgCb(args) para saída calculada (usado por /dice e /rps).

Mensagens — messages.lua

Transmissões automáticas, mensagens de boas-vindas e estilização de eventos do txAdmin — tudo desativado por padrão.

config.autoMessages = {
    active = false,
    messages = {
        { interval = 3600000, tags = { { tag = "Auto Message" } }, color = { 88, 166, 255 },
          args = { "Test message for auto message (1)" } },
    },
}

config.welcomeMessages = {
    active = false,
    messages = { { tags = { { tag = "Welcome" } }, color = { 255, 255, 255 },
                   args = { "Welcome to the BUPA Test server!" } } },
}

config.txAdmin = {
    announcement     = { active = true, tagBgColor = { 255, 190, 6
PreviousChat CategoriesNext Discord Logging