feat: add dynamic BotChatter system with regional packs (AU/NZ/UK/CA/US)

.gitignore

@@ -165,3 +165,11 @@ cython_debug/
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 #.idea/
+/ext/Client/nppBackup
+/ext/Server/BotChatter/nppBackup
+/ext/Server/BotChatter/Packs/nppBackup
+/ext/Server/nppBackup
+/ext/Shared/Constants/nppBackup
+/ext/Shared/Names/nppBackup
+/ext/Shared/Names/packs/nppBackup
+/ext/Shared/nppBackup

ext/Client/BotChatterClient.lua

@@ -0,0 +1,193 @@
+-- ext/Client/BotChatterClient.lua
+-- Code by: JMDigital (https://github.com/JenkinsTR)
+-- Bot chatter overlay with DebugRenderer (no WebUI, no ChatManager) top-left, left-aligned, newest on top.
+-- Bigger, team-tinted text, colored speaker names, and mention highlights.
+
+local VIS = { Global = 0, Team = 1, Squad = 2 }
+
+-- --------------- State & helpers ---------------
+local messages = {}
+
+local function now() return math.floor(SharedUtils:GetTimeMS()) / 1000.0 end
+
+local function me() return PlayerManager:GetLocalPlayer() end
+
+local function visible_to_me(vis, teamId, squadId)
+    local p = me()
+    if not p then return false end
+    if vis == VIS.Team  then return p.teamId == teamId end
+    if vis == VIS.Squad then return p.teamId == teamId and p.squadId == squadId end
+    return true
+end
+
+-- ASCII sanitizer (curly quotes / dashes / ellipsis -> plain)
+local function sanitize_ascii(s)
+    if not s then return "" end
+    s = tostring(s)
+    s = s:gsub("\226\128\153", "'"):gsub("\226\128\156", "\""):gsub("\226\128\157", "\"")
+         :gsub("\226\128\166", "..."):gsub("\226\128[\145\146\147\148]", "-")
+         :gsub("[^\32-\126]", "")
+    return s
+end
+
+-- Strip leading tags like [AU], (XX), {YY}
+local function strip_tags(name)
+    if not name then return "" end
+    return (name:gsub("^%s*%b[]", "")
+                :gsub("^%s*%b()", "")
+                :gsub("^%s*%b{}", "")):gsub("^%s+", "")
+end
+
+-- Case-insensitive "does text contain player's (tag-stripped) name?"
+local function mentions_me(text)
+    local p = me()
+    if not p or not p.name or not text then return false end
+    local mine = strip_tags(p.name):lower()
+    if mine == "" then return false end
+    return text:lower():find(mine, 1, true) ~= nil
+end
+
+NetEvents:Subscribe('BotChatter:Say', function(botName, text, vis, teamId, squadId)
+    if not visible_to_me(vis, teamId, squadId) then return end
+    local chan = (vis == VIS.Team and "TEAM") or (vis == VIS.Squad and "SQUAD") or "ALL"
+
+    messages[#messages+1] = {
+        name   = sanitize_ascii(botName or "BOT"),
+        text   = sanitize_ascii(text or ""),
+        chan   = chan,
+        vis    = vis,
+        teamId = teamId,
+        squadId= squadId,
+        t      = now(),
+        mention= mentions_me(text)
+    }
+    if #messages > MAX_LINES then table.remove(messages, 1) end
+end)
+
+Events:Subscribe('Level:Loaded',  function() messages = {} end)
+Events:Subscribe('Level:Destroy', function() messages = {} end)
+
+-- --------------- UI tuning ---------------
+local function win() return ClientUtils:GetWindowSize() end
+
+-- Placement (top-left)
+local PAD_LEFT_RATIO = 0.05
+local PAD_TOP_RATIO  = 0.05
+
+-- Base sizing (we'll adapt per frame)
+local LINE_PX_BASE = 18
+local FONT_SCALE_BASE = 1.0
+
+-- Limit & fade
+MAX_LINES        = 10
+local LIFETIME   = 10.0
+local FADE_START = 7.0
+
+-- Colors (RGBA 0..1). BF3-ish: Team1 ~ blue, Team2 ~ orange.
+local COLOR_TAG_ALL    = Vec4(0.61, 0.82, 1.00, 0.95)
+local COLOR_TAG_TEAM   = Vec4(0.49, 1.00, 0.61, 0.95)
+local COLOR_TAG_SQUAD  = Vec4(1.00, 0.87, 0.48, 0.95)
+
+local NAME_TEAM1       = Vec4(0.75, 0.85, 1.00, 0.98)
+local NAME_TEAM2       = Vec4(1.00, 0.80, 0.55, 0.98)
+local NAME_NEUTRAL     = Vec4(1.00, 1.00, 1.00, 0.98)
+
+local TEXT_TEAM1       = Vec4(0.82, 0.90, 1.00, 0.96)
+local TEXT_TEAM2       = Vec4(1.00, 0.88, 0.70, 0.96)
+local TEXT_GLOBAL      = Vec4(0.90, 0.90, 0.90, 0.96)
+local TEXT_SQUAD       = Vec4(0.85, 1.00, 0.78, 0.96)
+
+local MENTION_HILITE   = Vec4(1.00, 0.95, 0.40, 1.00) -- bright yellow for mentions
+local SHADOW           = Vec4(0, 0, 0, 0.85)
+
+-- Char width estimate (pixels at scale=1). Keep integer math for crispness.
+local CHAR_PX = 8
+
+-- --------------- Drawing ---------------
+Events:Subscribe('UI:DrawHud', function()
+    if #messages == 0 then return end
+
+    local res   = win()
+
+    -- Adaptive scale: proportionally bigger on high res, clamp for legibility
+    local scale = FONT_SCALE_BASE * math.min(1.5, math.max(0.95, (res.y / 1080.0) * 1.05))
+    local step  = math.floor(LINE_PX_BASE * scale + 0.5)
+    local baseX = math.floor(res.x * PAD_LEFT_RATIO + 0.5)
+    local baseY = math.floor(res.y * PAD_TOP_RATIO  + 0.5)
+    local tnow  = now()
+
+    local function apply_a(v, a) return Vec4(v.x, v.y, v.z, v.w * a) end
+
+    local y = baseY
+    for i = #messages, 1, -1 do
+        local m   = messages[i]
+        local age = tnow - m.t
+        if age > LIFETIME then
+            table.remove(messages, i)
+        else
+            -- fade
+            local fade = 1.0
+            if age > FADE_START then
+                local k = math.min(1.0, (age - FADE_START) / (LIFETIME - FADE_START))
+                fade = 1.0 - 0.75 * k
+            end
+
+            local tagStr  = "[" .. m.chan .. "] "
+            local nameStr = m.name .. ": "
+            local textStr = m.text
+
+            -- Choose colors
+            local tagColor =
+                (m.chan == "TEAM"  and COLOR_TAG_TEAM)  or
+                (m.chan == "SQUAD" and COLOR_TAG_SQUAD) or
+                COLOR_TAG_ALL
+
+            local nameColor =
+                (m.teamId == TeamId.Team1 and NAME_TEAM1) or
+                (m.teamId == TeamId.Team2 and NAME_TEAM2) or
+                NAME_NEUTRAL
+
+            local baseText =
+                (m.vis == VIS.Squad and TEXT_SQUAD) or
+                (m.teamId == TeamId.Team1 and TEXT_TEAM1) or
+                (m.teamId == TeamId.Team2 and TEXT_TEAM2) or
+                TEXT_GLOBAL
+
+            -- Mention highlight gets priority
+            local textColor = m.mention and MENTION_HILITE or baseText
+
+            -- Apply fade
+            local tagC = apply_a(tagColor,  fade)
+            local nmC  = apply_a(nameColor, fade)
+            local txC  = apply_a(textColor, fade)
+            local shC  = apply_a(SHADOW,    fade)
+
+            -- Left-aligned segments with integer spacing
+            local char_px_scaled = math.floor(CHAR_PX * scale + 0.5)
+            local x_tag  = baseX
+            local x_name = x_tag  + (#tagStr  * char_px_scaled)
+            local x_text = x_name + (#nameStr * char_px_scaled)
+
+            -- Subtle speaker cue arrow for SQUAD or MENTION
+            local prefix = (m.mention and "▶ ") or (m.vis == VIS.Squad and "› " or "")
+            if prefix ~= "" then
+                tagStr = prefix .. tagStr
+                x_name = x_name + (#prefix * char_px_scaled)
+                x_text = x_text + (#prefix * char_px_scaled)
+            end
+
+            -- shadow (+1 px)
+            DebugRenderer:DrawText2D(x_tag  + 1, y + 1, tagStr,  shC, scale)
+            DebugRenderer:DrawText2D(x_name + 1, y + 1, nameStr, shC, scale)
+            DebugRenderer:DrawText2D(x_text + 1, y + 1, textStr, shC, scale)
+
+            -- main
+            DebugRenderer:DrawText2D(x_tag,  y, tagStr,  tagC, scale)
+            DebugRenderer:DrawText2D(x_name, y, nameStr, nmC,  scale)
+            DebugRenderer:DrawText2D(x_text, y, textStr, txC,  scale)
+
+            y = y + step
+            if ((y - baseY) / step) >= MAX_LINES then break end
+        end
+    end
+end)

ext/Client/__init__.lua

@@ -27,6 +27,10 @@ require('__shared/WeaponList')
 require('__shared/EbxEditUtils')
 require('__shared/Utils/Logger')
 
+-- load the chat hooks
+require('BotChatterClient')
+-- require('BotChatterUI')   -- deprecated
+
 ---@type Logger
 local m_Logger = Logger("FunBotClient", Debug.Client.INFO)