Skip to content

Configuration

Конфигурация

Конфигурация BUPA Chat разделена на файлы в shared/config/*.lua. Все эти файлы находятся в escrow_ignore, поэтому они остаются доступными для редактирования после покупки. На этой странице рассмотрены настройки общего характера, отображения, эмодзи, эмоций и сообщений. Категории и Discord вынесены на собственные страницы.

Общие — general.lua

Клавиши, звуки, значения по умолчанию и система масок.

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

Сообщения о входе/выходе подчиняются стандартным convar-переменным:

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

Источник имени в чате администратора

В категории admin в качестве источника имени может отображаться не имя персонажа:

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
    },
}

Имена с учетом масок — config.noneMask

В config.noneMask перечисляются элементы масок (по модели педа, коллекции и индексу), которые не должны скрывать имя игрока в чате. Когда эта функция активна, имя игрока в маске отображается как Неизвестно, если только в категории не задано showWearingMask = true или если надетáя маска не находится в этом белом списке.

Отображение — display.lua

Личные сообщения — 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 ]] },
}

Отправитель и получатель имеют независимое оформление (теги, color, showPlayerName, showPlayerId, showPlayerJob, discordTag, showHour).

Надписи над головой и отображение ID игроков

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" },
}

Шаблон (template) поддерживает плейсхолдеры {serverId}, {name}, {steamId}, {discordId}, {fivemId}, переносы строк \n и встроенный HTML/CSS.

Эмодзи — emojis.lua

Выбор эмодзи полностью основан на данных. Каждая категория имеет вид { tab = "<icon emoji>", label = "<HEADER>", list = { ... } }, а каждый эмодзи задается как { 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 (🚗)
}

Поставляется с четырьмя группами — Смайлики, Жесты, Символы и Предметы. Добавляйте, удаляйте или меняйте местами по своему усмотрению; code — это шорткод для поиска, отображаемый под превью.

Эмоции — emotes.lua

Индикатор набора текста — config.chatOpenEmote

Анимированные точки над головой игрока во время ввода текста:

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

Команды эмоций — config.emoteCommands

Поставляется с командами /me, /do, /dice (/zar) и /rps (/tkm). Каждая эмоция может воспроизводить анимацию, отображать текст над головой и при желании дублировать сообщение в чат:

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 } },
}

Дополнительные поля: anim (dict, clip, flag, duration), headText (кость/смещение/масштаб), params (кастомные аргументы с подсказками) и msgCb(args) для вычисляемого вывода (используется в /dice и /rps).

Сообщения — messages.lua

Автоматические рассылки, приветственные сообщения и стилизация событий txAdmin — все отключено по умолчанию.

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,
PreviousChat CategoriesNext Discord Logging