Configuración
Configuration
La configuración de BUPA Chat está dividida en shared/config/*.lua. Todos estos archivos se encuentran en escrow_ignore, por lo que se pueden editar después de la compra. Esta página detalla la configuración general, de visualización, emojis, emotes y mensajes. Las categorías y Discord tienen sus propias páginas.
General — general.lua
Teclas, sonidos, valores predeterminados y el sistema de máscaras.
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 openLos mensajes de conexión / desconexión siguen los convars estándar:
config.showJoinMessages = GetConvarInt('chat_showJoins', 1) == 0
config.showQuitMessages = GetConvarInt('chat_showQuits', 1) == 0Origen del nombre de chat de administración
La categoría admin puede mostrar una fuente de nombres diferente a la del nombre del personaje:
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
},
}Nombres con detección de máscaras — config.noneMask
config.noneMask enumera los elementos visuales de máscaras (por modelo de ped, colección e índice) que no deben ocultar el nombre de un jugador en el chat. Cuando está activo, el nombre de un jugador con máscara se muestra como Unknown (Desconocido) a menos que la categoría establezca showWearingMask = true, o que la máscara que lleva puesta esté en esta lista blanca.
Visualización — display.lua
Mensajes privados — config.pm
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 ]] },
}El remitente y el destinatario tienen estilos independientes (etiquetas, color, showPlayerName, showPlayerId, showPlayerJob, discordTag, showHour).
Texto sobre la cabeza y visualización de ID de jugador
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" },
}La template admite los marcadores de posición {serverId}, {name}, {steamId}, {discordId}, {fivemId}, saltos de línea \n y HTML/CSS en línea.
Emojis — emojis.lua
El selector de emojis está completamente basado en datos. Cada categoría es { tab = "<icon emoji>", label = "<HEADER>", list = { ... } } y cada emoji es { emoji, name, code }.
config.emojis = {
{
tab = "😀", label = "SMILEYS",
list = {
{ emoji = "😀", name = "Grinning", code = ":grinning:" },
{ emoji = "😂", name = "Joy", code = ":joy:" },
-- ...
},
},
-- GESTURES (👍), SYMBOLS (❤️), OBJECTS (🚗)
}Incluye cuatro grupos de serie: Smileys, Gestures, Symbols y Objects. Añade, elimina o reordena libremente; code es el shortcode searchable que se muestra debajo de la vista previa.
Emotes — emotes.lua
Indicador de escritura — config.chatOpenEmote
Puntos animados sobre la cabeza de un jugador mientras escribe:
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 playerComandos de emotes — config.emoteCommands
Incluye de serie /me, /do, /dice (/zar) y /rps (/tkm). Cada emote puede reproducir una animación, mostrar texto sobre la cabeza y opcionalmente reflejarse en el chat:
{
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 adicionales: anim (dict, clip, flag, duration), headText (hueso/desplazamiento/escala), params (argumentos personalizados escritos con teclas de ayuda) y msgCb(args) para resultados calculados (utilizado por /dice y /rps).
Mensajes — messages.lua
Difusiones automáticas, mensajes de bienvenida y diseño de eventos de txAdmin, todo desactivado por defecto.
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,