Skip to content

Konfiguration

Konfiguration

BUPA Chat-konfigurationen är uppdelad i shared/config/*.lua. Alla dessa filer finns i escrow_ignore, så de förblir redigerbara efter köp. Denna sida går igenom inställningarna för allmänt, visning, emoji, emote och meddelanden. Kategorier och Discord har sina egna sidor.

Allmänt — general.lua

Nycklar, ljud, standardvärden och masksystemet.

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

Anslutnings- / lämnandemeddelanden följer standard-convars:

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

Namnkälla för admin-chatt

Kategorin admin kan visa en annan namnkälla än karaktärsnamn:

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

Maskmedvetna namn — config.noneMask

config.noneMask listar mask-drawables (efter ped-modell, samling och index) som inte ska dölja en spelares namn i chatten. När den är aktiv visas en maskerad spelares namn som Okänd om inte kategorin sätter showWearingMask = true, eller om den burna masken finns med i denna tillåtelista.

Visning — display.lua

Privata meddelanden — 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 ]] },
}

Avsändare och mottagare har var för sig oberoende styling (taggar, color, showPlayerName, showPlayerId, showPlayerJob, discordTag, showHour).

Huvudtext & visning av spelar-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 har stöd för platshållarna {serverId}, {name}, {steamId}, {discordId}, {fivemId}, \n radbrytningar samt inline-HTML/CSS.

Emojis — emojis.lua

Emojivaljaren är helt datadriven. Varje kategori är { tab = "<icon emoji>", label = "<HEADER>", list = { ... } } och varje emoji är { 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 (🚗)
}

Levereras med fyra grupper — Smileys, Gestures, Symbols och Objects. Lägg till, ta bort eller ändra ordning fritt; code är den sökbara kortkoden som visas under förhandsvisningen.

Emotes — emotes.lua

Skrivindikator — config.chatOpenEmote

Animerade punkter ovanför en spelares huvud medan de skriver:

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

Emote-kommandon — config.emoteCommands

Levereras med /me, /do, /dice (/zar) och /rps (/tkm). Varje emote kan spela upp en animation, rendera huvudtext och valfritt spegla till chatten:

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

Ytterligare fält: anim (dict, clip, flag, duration), headText (ben/offset/skala), params (anpassade inmatade argument med hjälptangenter) och msgCb(args) för beräknad utdata (används av /dice och /rps).

Meddelanden — messages.lua

Automatiska utskick, välkomstmeddelanden och txAdmin-händelsestyling — allt avstängt som standard.

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