Files9 files / 3.5 MB

main.luau137.4 KB
README.md8.8 KB
rebind.toml608 B
weapon_catalog.luau51.8 KB
weapon_images_1.luau820.9 KB
weapon_images_2.luau811.1 KB
weapon_images_3.luau811.4 KB
weapon_images_4.luau812.6 KB
weapon_images.luau808 B
Browse files
An in-game CoD meta panel for Rebind. It reads CODMunity's public meta pages, each weapon's public loadout page, and the public weapon database, then shows the live ranked list without taking focus away from the game.
Version 1.3.6 is the "power pack" build: saved builds, setup tools, history, themes, live HUD controls, and a full compare workflow.
Core

Games: Warzone (MW4-inclusive live ranking), MW4 multiplayer, Warzone Ranked, and BO7 from the Game selector.
Full build picker (F6): every build on the page, with playstyle, rating, code, and slot-labelled attachments. Builds show PIN, FAV, and ! markers for pinned, favorited, and validation-flagged builds.
Search palette (F2): fuzzy search over the 451-entry CODMunity weapon database. Results are prioritised for the current game; Search scope can restrict them to the selected game. Weapons outside the current ranked list load on demand.
Favorites and recent: favorite weapons with F5; the View option switches between meta, favorites, and recent.
Filter and sort: filter by AR, SMG, sniper, LMG, shotgun, or pistol; sort by meta rank, pick rate, or name.
Copy: build code with F9, full loadout with F10, or use the copy-format menu for code-only, short, Discord, and CSV output. Copied text omits the source credit; attribution stays here.
Cache age: the menu subtitle and detail footer show the last update time.
Weekly changes: new entries, drops, rank moves, tier moves, and pick-rate moves.
Weekly history: the last eight weekly snapshots are kept; Extras > Meta history shows the top three for each week, and the detail panel shows a rank-history line.
Watchlist alerts: on refresh, favorite weapons that drop or change tier produce a watchlist toast.
Compare

F4 opens an opponent picker for the last selected weapon.
F6 opens compare actions:
- copy A or B full loadout
- copy A or B build code
- switch A or B build
- copy an A+B summary
- change opponent
- close
F9 copies A's full loadout; F10 copies B's full loadout while a comparison is open.
Esc closes the comparison; F8 returns to the meta menu.
Build duel (Extras) compares two builds of the same weapon.
Top 3 compare (Extras) shows a compact A/B/C code-and-TTK overview.
Saved setup and extras

Press F11 for the Extras hub:
Help / hotkeys
Meta history
Build duel
Loadout plan (primary / secondary / backup, copy all three codes)
Clipboard history (last six copies)
Favorite builds
Pin current build / clear pin
Favorite current build
Tags (Meta, Tested, Ranked, Fun, Laser, Off-meta)
Why this build? (metadata-derived rating, validation, history, alternatives)
Random meta pick
Copy formats
Export setup / Import setup
Top 3 compare
Pinned builds become the default for that weapon. Favorite builds, tags, plans, pins, favorites, recents, and clipboard history are stored in user_state.json. Export/import writes meta_overlay_setup.json.
Detail panel

Shows the current build, pinned marker, tags, slot-labelled attachments, build code, TTK, rank history, alternatives, and a warning if the build has fewer than five attachments, duplicate slots, or no code.
Hotkeys

Key	Action
F1	Help / hotkeys
F2	Search the weapon database
F3	Toggle the top-3 HUD
F4	Pick or change the comparison opponent
F5	Add or remove the selected weapon from favorites
F6	Build picker; during compare, compare actions
F7	Force a refresh
F8	Open or close the meta menu
Ctrl+Alt+Shift+F8	Fallback open shortcut when a game consumes F8
F9	Copy the selected build code; during compare, copy A full loadout
F10	Copy the full loadout; during compare, copy B full loadout
F11	Extras menu
Up / Down	Move through a menu or search results
Enter / 1-9	Select an item
Escape	Close the current menu, search, help, or comparison
Hotkeys are global in this build; per-game key profiles are not included yet. All hotkeys can be changed in Options.
Options

Game, View, Category, Sort
Theme: default, contrast, mono
HUD style: full, compact, codes, off
HUD position: any corner
HUD size: small, normal, large
Search scope: all weapons or current game
Games and data coverage

Warzone: the 20-weapon MW4-inclusive live ranking from codmunity.gg/warzone; Menu view = all covers the 37 MW4 database weapons.
MW4: the 10-weapon Modern Warfare 4 multiplayer weekly report; all covers the same 37 MW4 database weapons.
Warzone Ranked / BO7: the mode-specific top 10 and correct build codes/attachments are shown. CODMunity's weapon FAQ still labels its tier and pick-rate answers as Warzone, so those modes show rank, build, and rating instead of a misleading mode tier.
Warzone and MW4 ship with prebuilt caches. Warzone Ranked and BO7 build their cache on the first switch. Attachment slot labels come from the page; older caches with only names infer the slot from the name so comparison does not fall back to repeated ATT labels.
First run and data flow

A Warzone refresh makes one request for /warzone plus one for each of its 20 ranked weapon pages. An MW4 refresh makes one request for the weekly index, one for the report, plus one for each of its 10 ranked weapon pages. When the search index is stale, one request for the public weapon database follows. A successful refresh writes the appropriate cache file next to main.luau. Refreshes use the public pages, not codmunity.gg/api/, which their robots.txt disallows.
Files:
meta_cache.json - Warzone
meta_cache_mw4.json - MW4
meta_cache_wz_ranked.json - Warzone Ranked (created on first switch)
meta_cache_bo7.json - BO7 (created on first switch)
weapon_index.json - searchable weapon database
weapon_catalog.luau - bundled fallback catalogue for the live weapon roster
user_state.json - favorites, recents, pins, tags, plan, HUD preference, clipboard history, search history
meta_overlay_setup.json - optional export/import file
Limits

Borderless or windowed fullscreen is required. Exclusive fullscreen hides Rebind overlays.
The overlay is keyboard-driven and click-through. It cannot render weapon images or HTML.
Build codes are copied as text; they are not pasted into the game.
There is no game auto-detection, loadout-screen scanning, AI image recognition, OBS/HTML overlay, or phone/remote view in this build.
Free-text build notes are not included; tags cover quick labeling.
Hotkeys are global; per-game hotkey profiles are not included.
Patch notes

1.3.6

Warzone now maps to the live /warzone MW4-inclusive ranking (20 weapons) instead of the older BO7 weekly report.
MW4 remains the Modern Warfare 4 multiplayer weekly report.
Warzone's database scope is now MW4-only: all shows 37 MW4 weapons, not 300 mixed BO7/MW2/MW3/MW2019 entries.
Added the missing MW4 roster entries, including Mosin-Nagant, SANG 9mm, WZ.55 Striga, Axion, Warlord, Astaroth .57, APOC-338, and Mojave .357.
The weapon index now reads CODMunity's embedded roster, stores categories, and carries 451 current entries plus a 451-entry weapon_catalog.luau fallback.
Long menus paginate at 24 rows, fixing the Warzone all overlay height crash.
HUD position, size, and style now apply live; size scales the full panel.
1.3.3

Attachments now come from the rendered build panels, so every build matches the weapon page exactly: correct slots, unlock levels, and the site's own buff/nerf stat lines with proper colors.
Build labels are bound via aria-controls; Multiplayer and DMZ builds no longer get mixed together.
DMZ/Warzone builds are excluded for MW4 per the game's build-group config.
Cache version 3: old cached data is auto-refreshed, and favorites refetch fresh instead of showing saved snapshots.
Fixed a crash in the attachment-stat parser (missing second return value) and raised the build extraction cap from 12 to 40.
Data and attribution

Meta data and build codes come from CODMunity. This is an unofficial companion and is not affiliated with CODMunity or Call of Duty. Keep refreshes reasonable, credit the source, and ask CODMunity before redistributing their data in a public listing.
Requirements

Rebind 3.9.0 or newer
Network permission for codmunity.gg
Clipboard write permission
The script does not read game memory, inject into the game, or modify game files.
Version
main.luau137.4 KB
--[[
  rebind: min_sdk=3.14.0
  rebind: permission=net:codmunity.gg
  rebind: permission=clipboard:write
  rebind: permission_reason="net: Downloads public weekly CoD meta, loadout, and weapon database pages from CODMunity"
  rebind: memory_limit_mb=64
  rebind: tick_rate=60
]]

-- CODMunity publishes the weekly top 10 and each weapon's FAQ as JSON-LD.
-- This script reads those public pages, keeps a local fallback cache, and
-- never writes anything to the site.

local SOURCE = "CODMunity"
local CACHE_VERSION = 3
local USER_FILE = "user_state.json"
local INDEX_FILE = "weapon_index.json"
local GAME_ORDER = { "warzone", "mw4", "wz_ranked", "bo7" }
local GAMES = {
  warzone = {
    key = "warzone",
    label = "Warzone",
    title = "WARZONE META",
    path = "warzone",
    index = "https://codmunity.gg/warzone",
    direct_meta = true,
    cache = "meta_cache.json",
    faq_name = "Warzone",
    loadout_meta = "wz",
    loadout_metas = { "wz", "resurgence-wz" },
    app_games = { "wz" },
    build_groups = { "Warzone", "Resurgence" },
    stat_game = "warzone-2",
    prefixes = { "mw4" },
  },
  mw4 = {
    key = "mw4",
    label = "MW4",
    title = "MW4 META",
    path = "modern-warfare-4",
    index = "https://codmunity.gg/weekly-meta/modern-warfare-4",
    cache = "meta_cache_mw4.json",
    faq_name = "Modern Warfare 4",
    loadout_meta = "mw4-mp",
    loadout_metas = { "mw4-mp", "mw4-specific" },
    app_games = { "mw4" },
    build_groups = { "Multiplayer" },
    stat_game = "mw4",
    prefixes = { "mw4" },
  },
  wz_ranked = {
    key = "wz_ranked",
    label = "Warzone Ranked",
    title = "WZ RANKED META",
    path = "warzone-ranked",
    index = "https://codmunity.gg/weekly-meta/warzone-ranked",
    cache = "meta_cache_wz_ranked.json",
    faq_name = nil,
    loadout_meta = "Warzone Ranked",
    app_games = { "wz" },
    build_groups = { "Ranked Play" },
    stat_game = "warzone-2",
    prefixes = { "bo7", "mw4" },
  },
  bo7 = {
    key = "bo7",
    label = "BO7",
    title = "BO7 META",
    path = "black-ops-7",
    index = "https://codmunity.gg/weekly-meta/black-ops-7",
    cache = "meta_cache_bo7.json",
    faq_name = nil,
    loadout_meta = "wz",
    loadout_metas = { "bo7-mp", "bo7-zombies" },
    app_games = { "bo7" },
    build_groups = { "Multiplayer", "Ranked", "Zombies" },
    stat_game = "bo7",
    prefixes = { "bo7" },
  },
}
local MIN_REFRESH_SECONDS = 60
local AUTO_REFRESH_SECONDS = 6 * 60 * 60
local HTTP_TIMEOUT_MS = 40000
local USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36 RebindMetaOverlay/1.0"

-- Weapon images scraped from CODMunity and bundled as base64. Loaded lazily so
-- an install without the module still runs; decoded to @data/img on first use
-- and drawn with the overlay image op (needs min_sdk 3.14.0).
local ok_images, WEAPON_IMAGES = pcall(require, "./weapon_images.luau")
if not ok_images then
  rb.log.warn("CODMunity weapon images module failed to load: " .. tostring(WEAPON_IMAGES))
  WEAPON_IMAGES = {}
end
local img_ready = {}
local fetching_weapon = false

local THEME = {
  surface = "#0d1210f2",
  border = "#a5e63c55",
  text = "#f2f7ee",
  dim = "#929c96",
  faint = "#5f6b65",
  accent = "#a5e63c",
  positive = "#75c017",
  warning = "#ffb020",
  danger = "#eb5757",
}

local THEME_PALETTES = {
  default = {
    surface = "#0d1210f2",
    border = "#a5e63c55",
    text = "#f2f7ee",
    dim = "#929c96",
    faint = "#5f6b65",
    accent = "#a5e63c",
    positive = "#75c017",
    warning = "#ffb020",
    danger = "#eb5757",
  },
  contrast = {
    surface = "#000000f2",
    border = "#ffffffff",
    text = "#ffffff",
    dim = "#dddddd",
    faint = "#a8a8a8",
    accent = "#ffff00",
    positive = "#00ff66",
    warning = "#ffb000",
    danger = "#ff5555",
  },
  mono = {
    surface = "#111111f2",
    border = "#666666ff",
    text = "#f4f4f4",
    dim = "#c0c0c0",
    faint = "#8a8a8a",
    accent = "#ffffff",
    positive = "#d8d8d8",
    warning = "#b0b0b0",
    danger = "#e8e8e8",
  },
}

local cfg = rb.ui.schema({
  game = rb.ui.select("warzone", GAME_ORDER, { label = "Game" }),
  view = rb.ui.select("meta", { "meta", "favorites", "recent", "all" }, { label = "Menu view" }),
  category = rb.ui.select("all", { "all", "ar", "smg", "sniper", "lmg", "shotgun", "pistol" }, { label = "Category filter" }),
  sort = rb.ui.select("rank", { "rank", "pick", "name" }, { label = "Sort by" }),
  theme = rb.ui.select("default", { "default", "contrast", "mono" }, { label = "Theme" }),
  hud_mode = rb.ui.select("full", { "full", "compact", "codes", "off" }, { label = "HUD style" }),
  hud_position = rb.ui.select("top-left", { "top-left", "top-right", "bottom-left", "bottom-right" }, { label = "HUD position" }),
  hud_scale = rb.ui.select("normal", { "small", "normal", "large" }, { label = "HUD size" }),
  search_scope = rb.ui.select("all", { "all", "game" }, { label = "Search scope" }),
  open_key = rb.ui.keybind("F8", { label = "Open meta overlay" }),
  help_key = rb.ui.keybind("F1", { label = "Help / hotkeys" }),
  search_key = rb.ui.keybind("F2", { label = "Search weapons" }),
  hud_key = rb.ui.keybind("F3", { label = "Toggle top-3 HUD" }),
  compare_key = rb.ui.keybind("F4", { label = "Compare with another weapon" }),
  favorite_key = rb.ui.keybind("F5", { label = "Toggle favorite" }),
  build_key = rb.ui.keybind("F6", { label = "Choose another build" }),
  refresh_key = rb.ui.keybind("F7", { label = "Refresh meta data" }),
  copy_key = rb.ui.keybind("F9", { label = "Copy last build code" }),
  full_copy_key = rb.ui.keybind("F10", { label = "Copy full loadout" }),
  extras_key = rb.ui.keybind("F11", { label = "Extras menu" }),
  copy_on_select = rb.ui.toggle(true, { label = "Copy build code on select" }),
  capturable = rb.ui.toggle(true, { label = "Show in screenshots and recordings", tooltip = "Off: Snipping Tool, OBS and Discord skip the overlay" }),
})

local function apply_theme()
  local palette = THEME_PALETTES[tostring(cfg.theme or "default")] or THEME_PALETTES.default
  for key, value in pairs(palette) do
    THEME[key] = value
  end
end

local state = {
  game_key = nil,
  game = GAMES.warzone,
  items = {},
  week = "",
  report_url = "",
  updated_at = 0,
  previous_week = "",
  previous_items = {},
  history = {},
  refreshing = false,
  menu = nil,
  menu_map = nil,
  detail = nil,
  compare_surface = nil,
  compare_handler = nil,
  compare_a = nil,
  compare_b = nil,
  compare_a_build = nil,
  compare_b_build = nil,
  changes_surface = nil,
  hud_surface = nil,
  help_surface = nil,
  help_handler = nil,
  status = nil,
  last = nil,
  last_build = nil,
  last_copied_code = nil,
  user = {
    favorites = {},
    recent = {},
    hud = {},
    pins = {},
    favorite_builds = {},
    tags = {},
    plan = {},
    clipboard_history = {},
    search_recent = {},
  },
  dynamic = {},
  index = {},
  index_updated_at = 0,
  index_refreshing = false,
  search = nil,
}

local sync_game
local notify
local close_search
local build_issues
local rank_history_text
local compare_summary_text

local function selected_game()
  local key = tostring(cfg.game or "warzone")
  return GAMES[key] or GAMES.warzone
end

local function trim(value)
  return (tostring(value or ""):gsub("^%s+", ""):gsub("%s+$", ""))
end

local function fit(value, max_chars)
  local text = tostring(value or "")
  if #text <= max_chars then
    return text
  end
  if max_chars <= 2 then
    return text:sub(1, max_chars)
  end
  return text:sub(1, max_chars - 2) .. ".."
end

local function parse_jsonld(html)
  local blocks = {}
  for raw in tostring(html or ""):gmatch('<script[^>]*application/ld%+json[^>]*>(.-)</script>') do
    local ok, value = pcall(rb.json.parse, raw)
    if ok and type(value) == "table" then
      blocks[#blocks + 1] = value
    end
  end
  return blocks
end

local function best_guns_list(blocks)
  for _, block in ipairs(blocks) do
    if block["@type"] == "ItemList" and type(block.itemListElement) == "table" then
      local name = tostring(block.name or "")
      if #block.itemListElement >= 10 and name:find("Best", 1, true) then
        return block
      end
    end
  end

  for _, block in ipairs(blocks) do
    if block["@type"] == "ItemList" and type(block.itemListElement) == "table" then
      local first = block.itemListElement[1]
      if type(first) == "table" and type(first.url) == "string" and first.url:find("/weapon/", 1, true) then
        return block
      end
    end
  end
  return nil
end

local function latest_report_url(blocks)
  for _, block in ipairs(blocks) do
    if block["@type"] == "ItemList" and type(block.itemListElement) == "table" then
      local name = tostring(block.name or "")
      if name:find("Weekly Meta Report", 1, true) then
        local first = block.itemListElement[1]
        if type(first) == "table" and type(first.url) == "string" then
          return first.url
        end
      end
    end
  end
  return nil
end

local function meta_description(html)
  local desc = tostring(html or ""):match('<meta name="description" content="([^"]*)"')
  if not desc then
    desc = tostring(html or ""):match('<meta property="og:description" content="([^"]*)"')
  end
  return desc or ""
end

local ATTACHMENT_SUFFIXES = {
  "Rear Grip",
  "Fire Mods",
  "Underbarrel",
  "Magazine",
  "Barrel",
  "Muzzle",
  "Optic",
  "Stock",
  "Laser",
  "Bolt",
  "Comb",
  "Apex",
  "Grip",
}

local DOUBLE_STRIP_SUFFIXES = {
  ["Rear Grip"] = true,
  ["Fire Mods"] = true,
  ["Underbarrel"] = true,
  ["Magazine"] = true,
  ["Barrel"] = true,
  ["Muzzle"] = true,
  ["Optic"] = true,
  ["Stock"] = true,
  ["Laser"] = true,
  ["Grip"] = true,
}

local function strip_attachment_suffix(text)
  for _, suffix in ipairs(ATTACHMENT_SUFFIXES) do
    local tail = " " .. suffix
    if #text - #tail >= 6 and text:sub(-#tail) == tail then
      return text:sub(1, #text - #tail), suffix
    end
  end
  return text, nil
end

local function clean_attachment(value)
  local text = trim(value):gsub("%.$", "")
  local suffix
  text, suffix = strip_attachment_suffix(text)
  if suffix and DOUBLE_STRIP_SUFFIXES[suffix] then
    text = strip_attachment_suffix(text)
  end
  return trim(text)
end

local function split_attachments(raw)
  local attachments = {}
  local text = trim(raw)
  if text == "" then
    return attachments
  end
  for part in (text .. ","):gmatch("(.-),%s*") do
    local cleaned = clean_attachment(part)
    if cleaned ~= "" then
      attachments[#attachments + 1] = cleaned
    end
  end
  return attachments
end

local BUILD_SLOTS = {
  "Optic",
  "Muzzle",
  "Barrel",
  "Underbarrel",
  "Magazine",
  "Stock",
  "Laser",
  "Rear Grip",
  "Fire Mods",
  "Conversion Kit",
  "Apex",
  "Bolt",
  "Comb",
  "Guard",
  "Sling",
  "Rail",
  "Stock Pad",
  "Trigger Action",
  "Ammunition",
  "Lever",
  "Shard",
  "Cylinder",
}

local SLOT_ABBR = {
  Optic = "OPT",
  Muzzle = "MZL",
  Barrel = "BRL",
  Underbarrel = "UND",
  Magazine = "MAG",
  Stock = "STK",
  Laser = "LSR",
  ["Rear Grip"] = "GRP",
  ["Fire Mods"] = "MOD",
  ["Conversion Kit"] = "KIT",
  Apex = "APX",
  Bolt = "BLT",
  Comb = "CMB",
  Guard = "GRD",
  Sling = "SLG",
  Rail = "RAI",
  ["Stock Pad"] = "PAD",
  ["Trigger Action"] = "TRG",
  Ammunition = "AMM",
  Lever = "LEV",
  Shard = "SHD",
  Cylinder = "CYL",
}

local function infer_slot(name)
  local text = tostring(name or ""):lower()
  if text:find("rear grip", 1, true) then
    return "Rear Grip"
  end
  if text:find("foregrip", 1, true) or text:find("underbarrel", 1, true) then
    return "Underbarrel"
  end
  if text:find("suppressor", 1, true) or text:find("muzzle", 1, true) then
    return "Muzzle"
  end
  if text:find("barrel", 1, true) then
    return "Barrel"
  end
  if text:find("optic", 1, true) or text:find("scope", 1, true)
    or text:find("red dot", 1, true) or text:find("holo", 1, true) then
    return "Optic"
  end
  if text:find("magazine", 1, true) or text:find(" mag", 1, true) or text:find("drum", 1, true) then
    return "Magazine"
  end
  if text:find("stock", 1, true) or text:find("control pad", 1, true) then
    return "Stock"
  end
  if text:find("laser", 1, true) then
    return "Laser"
  end
  if text:find("fire mod", 1, true) or text:find("burst mod", 1, true) then
    return "Fire Mods"
  end
  if text:find("conversion", 1, true) then
    return "Conversion Kit"
  end
  if text:find("apex", 1, true) then
    return "Apex"
  end
  if text:find("bolt", 1, true) then
    return "Bolt"
  end
  if text:find("comb", 1, true) then
    return "Comb"
  end
  if text:find("guard", 1, true) then
    return "Guard"
  end
  if text:find("sling", 1, true) then
    return "Sling"
  end
  if text:find("rail", 1, true) then
    return "Rail"
  end
  if text:find("lever", 1, true) then
    return "Lever"
  end
  if text:find("shard", 1, true) then
    return "Shard"
  end
  if text:find("cylinder", 1, true) then
    return "Cylinder"
  end
  if text:find("ammunition", 1, true) or text:find("ammo", 1, true) then
    return "Ammunition"
  end
  if text:find("grip", 1, true) then
    return "Rear Grip"
  end
  if text:find("pad", 1, true) then
    return "Stock"
  end
  return nil
end

local function attachment_slot(attachment)
  if type(attachment) ~= "table" then
    return "Attachment"
  end
  local slot = attachment.slot
  if not slot or slot == "Attachment" then
    slot = infer_slot(attachment.name)
  end
  return slot or "Attachment"
end

local function attachment_abbr(attachment)
  return SLOT_ABBR[attachment_slot(attachment)] or "ATT"
end

local function read_js_string(segment, quote_at)
  local out = {}
  local index = quote_at + 1
  while index <= #segment do
    local char = segment:sub(index, index)
    if char == '"' then
      return table.concat(out)
    end
    if char == "\\" then
      local next_char = segment:sub(index + 1, index + 1)
      if next_char == "n" then
        out[#out + 1] = "\n"
      elseif next_char == "t" then
        out[#out + 1] = "\t"
      else
        out[#out + 1] = next_char
      end
      index = index + 2
    else
      out[#out + 1] = char
      index = index + 1
    end
  end
  return nil
end

local function object_field(segment, name)
  local patterns = {
    '"' .. name .. '":"',
    name .. ':"',
  }
  for _, pattern in ipairs(patterns) do
    local found = segment:find(pattern, 1, true)
    if found then
      local value = read_js_string(segment, found + #pattern - 1)
      if value ~= nil then
        return value
      end
    end
  end
  return nil
end

local function number_field(segment, name)
  return tonumber(segment:match(name .. ":([%d%.]+)"))
end

local function extract_builds(html)
  -- The site now serialises every loadout inline as an object that starts with
  -- LoadoutCode:"..." (one per build, any game mode). Each object also carries
  -- meta:"wz" / meta:"mw4-mp" / meta:"DMZ" ... so the per-game mode filter can
  -- survive the new layout. If no build matches this game's modes (site drift),
  -- fall back to every build found so the menu is never empty.
  local loadouts_at = tostring(html or ""):find("loadouts:", 1, true)
  if not loadouts_at then
    return {}
  end

  local section = tostring(html):sub(loadouts_at)
  local positions = {}
  local cursor = 1
  while true do
    local found = section:find('LoadoutCode:"', cursor, true)
    if not found then
      break
    end
    positions[#positions + 1] = found
    cursor = found + 1
  end

  local builds = {}
  for index, start in ipairs(positions) do
    local finish = positions[index + 1] and (positions[index + 1] - 1) or math.min(#section, start + 9000)
    local segment = section:sub(start, finish)
    local code = segment:match('LoadoutCode:"([%w%-]+)"')
    if code then
      local attachments = {}
      for _, slot in ipairs(BUILD_SLOTS) do
        local name = object_field(segment, slot)
        if (not name or name == "") and slot == "Apex" and segment:find("Apex:", 1, true) then
          name = "Apex Attachment"
        end
        if not name or name == "" then
          local ref = segment:find(slot .. ":%$R%[", 1, true)
          if not ref then
            ref = segment:find("\"" .. slot .. "\":%$R%[", 1, true)
          end
          if ref then
            name = slot .. " Attachment"
          end
        end
        if name and name ~= "" then
          local level = segment:match(slot .. ":%$R%[%d+%]={.-levelText:\"([^\"]*)\"")
          if not level then
            level = segment:match("\"" .. slot .. "\":%$R%[%d+%]={.-levelText:\"([^\"]*)\"")
          end
          attachments[#attachments + 1] = {
            slot = slot,
            name = name,
            level = level or "",
          }
        end
      end
      builds[#builds + 1] = {
        playstyle = object_field(segment, "Playstyle") or "Build",
        code = code,
        category = object_field(segment, "Category") or "",
        rating = number_field(segment, "Rating") or 0,
        attachments = attachments,
        meta = segment:match('meta:"([^"]+)"') or "",
        app_game = segment:match('appGame:"([^"]+)"') or "",
      }
    end
    if #builds >= 40 then
      break
    end
  end

  -- Each build appears twice on the page: with the Apex attachment and without
  -- (the site's "Apex / Without Apex" toggle). Keep the Apex variant and drop
  -- its twin so the list matches what the website shows by default. Twins share
  -- the same mode + playstyle; a build that only exists without Apex stays.
  local function build_has_apex(b)
    for _, attachment in ipairs(b.attachments or {}) do
      if attachment.slot == "Apex" then
        return true
      end
    end
    return false
  end
  local apexes, plains = {}, {}
  for _, b in ipairs(builds) do
    if build_has_apex(b) then
      apexes[#apexes + 1] = b
    else
      plains[#plains + 1] = b
    end
  end
  local seen = {}
  local deduped = {}
  for _, b in ipairs(apexes) do
    local key = b.meta .. "|" .. b.playstyle
    if not seen[key] then
      seen[key] = true
      deduped[#deduped + 1] = b
    end
  end
  for _, b in ipairs(plains) do
    local key = b.meta .. "|" .. b.playstyle
    if not seen[key] then
      seen[key] = true
      deduped[#deduped + 1] = b
    end
  end
  builds = deduped

  return builds
end

local function attachment_names(build)
  local names = {}
  for _, attachment in ipairs(build and build.attachments or {}) do
    names[#names + 1] = attachment.name
  end
  return names
end

local function split_simple_list(raw)
  local out = {}
  local text = trim(raw):gsub("%.$", "")
  if text == "" then
    return out
  end
  for part in (text .. ","):gmatch("(.-),%s*") do
    part = trim(part)
    if part ~= "" then
      out[#out + 1] = part
    end
  end
  return out
end

-- The payload's Playstyle and meta fields disagree with what the site actually
-- renders (its tabs relabel and regroup builds). Each rendered tab carries its
-- group (Multiplayer / DMZ / Warzone / ...) and its panel holds the build code,
-- so this returns two maps: code -> label and code -> group. Panels are matched
-- by their own id and bounded by the next panel.
local function parse_rendered_labels(html)
  local out = {}
  local srcs = {}
  local orders = {}
  local text = tostring(html or "")
  local tab_index = 0
  for panel_id, src, label in text:gmatch('aria%-controls="(wx%-_R_[%w_%-]+)"[^>]*>.-<small class="wx%-pick%-src">([^<]-)</small><b>([^<]-)</b>') do
    tab_index = tab_index + 1
    out[panel_id] = label
    srcs[panel_id] = src
    orders[panel_id] = tab_index
  end
  local starts = {}
  local cursor = 1
  while true do
    local s, e, panel_id = text:find('id="(wx%-_R_[%w_%-]+)" role="tabpanel"', cursor)
    if not s then
      break
    end
    starts[#starts + 1] = { at = s, id = panel_id }
    cursor = e + 1
  end
  for i, panel in ipairs(starts) do
    local finish = starts[i + 1] and (starts[i + 1].at - 1) or math.min(#text, panel.at + 25000)
    local seg = text:sub(panel.at, finish)
    local code = seg:match('<span class="wx%-code%-label">Build code</span><code>([%w%-]+)</code>')
    if code and out[panel.id] then
      out[code] = out[panel.id]
      srcs[code] = srcs[panel.id]
      orders[code] = orders[panel.id]
    end
  end
  return out, srcs, orders
end

-- The rendered panels are the site's ground truth: each panel holds its build
-- code plus the complete attachment list with unlock level and the site's own
-- buff/nerf effect lines. Parse them directly so the overlay matches the page
-- exactly (the payload's inline fields can disagree with what is rendered).
local function parse_rendered_builds(html)
  local out = {}
  local text = tostring(html or "")
  local starts = {}
  local cursor = 1
  while true do
    local s, e, panel_id = text:find('id="(wx%-_R_[%w_%-]+)" role="tabpanel"', cursor)
    if not s then
      break
    end
    starts[#starts + 1] = { at = s, id = panel_id }
    cursor = e + 1
  end
  for i, panel in ipairs(starts) do
    local finish = starts[i + 1] and (starts[i + 1].at - 1) or math.min(#text, panel.at + 25000)
    local seg = text:sub(panel.at, finish)
    local code = seg:match('<span class="wx%-code%-label">Build code</span><code>([%w%-]+)</code>')
    if code then
      local atts = {}
      local pos = {}
      local c2 = 1
      while true do
        -- Pattern mode: %- is a literal dash, so this finds the real "wx-att-name"
        -- markup. Plain mode would search for a literal percent sign and match nothing.
        local a = seg:find('wx%-att%-name"', c2)
        if not a then
          break
        end
        pos[#pos + 1] = a
        c2 = a + 1
      end
      for k, a in ipairs(pos) do
        local aend = pos[k + 1] and (pos[k + 1] - 1) or math.min(#seg, a + 900)
        local head = seg:sub(a, math.min(aend, a + 600))
        local name = head:match('<strong>([^<]-)</strong>')
        if name and name ~= "" then
          local slot = head:match('<small>([^<]+)<')
          local level = head:match('Level (%d+)')
          local as = seg:sub(a, aend)
          local stats = {}
          for cls, value, label in as:gmatch('class="(%a+)"[^>]-title="[^"]-"[^>]->([^<]-)<!%-%- %-%-> <!%-%- %-%->([^<]-)</span>') do
            if cls == "up" or cls == "down" then
              stats[#stats + 1] = {
                buff = cls == "up",
                text = value .. " " .. label,
              }
            end
          end
          atts[#atts + 1] = {
            slot = slot or "",
            level = level and ("Level " .. level) or "",
            name = name,
            stats = stats,
          }
        end
      end
      if #atts > 0 then
        out[code] = atts
      end
    end
  end
  return out
end

local MOD_LABELS = {
  horiz_recoil_mod = "Horizontal Recoil",
  vert_recoil_mod = "Vertical Recoil",
  horiz_gun_kick_mod = "Horizontal Gun Kick",
  vert_gun_kick_mod = "Vertical Gun Kick",
  ads_mod = "ADS Speed",
  ads_out_mod = "ADS Out Speed",
  ads_gun_bob_mod = "ADS Gun Bob",
  ads_idle_sway_mod = "ADS Idle Sway",
  ads_movement_mod = "ADS Movement",
  bv_mod = "Bullet Velocity",
  range_mod = "Range",
  movement_mod = "Movement",
  crouch_movement_mod = "Crouch Movement",
  firing_movement_mod = "Firing Move Speed",
  strafe_movement_mod = "Strafe Speed",
  sprint_mod = "Sprint",
  sprint_to_fire_mod = "Sprint To Fire",
  reload_mod = "Reload Speed",
  fire_rate_mod = "Fire Rate",
  damage_mod = "Damage",
  mag_size_mod = "Magazine Size",
  hip_idle_sway_mod = "Hip Idle Sway",
  hip_gun_bob_mod = "Hip Gun Bob",
  zoom_mod = "Zoom Level",
}

-- Each weapon page embeds an attachmentStats array: one object per attachment
-- with slot and *_mod multipliers (0.97 = -3%). Parse it once per page so the
-- detail view can show the same stat lines the website renders.
local function parse_attachment_stats(html, game)
  local text_full = tostring(html or "")
  local target = (game and game.stat_game) or (game and game.key) or ""
  local stats_at = text_full:find("attachmentStats:", 1, true)
  if not stats_at then
    return {}, {}
  end

  -- The site's stat schema tags each stat POSITIVE (higher is better) or
  -- NEGATIVE (lower is better), which decides the buff/nerf colour.
  local schema = {}
  for ttype, col in text_full:gmatch('type:"([PN][A-Z]+)",[^}]-weaponStatsColumn:"([a-z_]+)"') do
    schema[col] = ttype
  end

  local section = text_full:sub(stats_at)
  local starts = {}
  local cursor = 1
  while true do
    local found = section:find('attachment:"', cursor, true)
    if not found then
      break
    end
    starts[#starts + 1] = found
    cursor = found + 1
  end

  local out = {}
  local out_game = {}
  local slot_names = {}
  local slot_games = {}
  for index, pos in ipairs(starts) do
    local finish = starts[index + 1] and (starts[index + 1] - 1) or math.min(#section, pos + 2500)
    local seg = section:sub(pos, finish)
    local name = seg:match('attachment:"([^"]*)"')
    local slot = seg:match('slot:"([^"]*)"')
    local entry_game = seg:match('game:"([^"]*)"') or ""
    local mods = {}
    for key, val in seg:gmatch("([%w_]+_mod):([-]?%d+%.?%d*)") do
      local label = MOD_LABELS[key]
      if label then
        local col = key:match("^(.-)_mod$")
        mods[#mods + 1] = {
          label = label,
          pct = (tonumber(val) - 1) * 100,
          kind = col and schema[col] or nil,
        }
      end
    end
    if name and name ~= "" and #mods > 0 then
      local key = name .. "|" .. tostring(slot or "")
      if (not out[key]) or (entry_game == target and out_game[key] ~= target) then
        out[key] = mods
        out_game[key] = entry_game
      end
      if not out[name] then
        out[name] = mods
        out_game[name] = entry_game
      end
    end
    if name and name ~= "" and slot and slot ~= "" then
      if (not slot_names[slot]) or (entry_game == target and slot_games[slot] ~= target) then
        slot_names[slot] = name
        slot_games[slot] = entry_game
      end
    end
  end
  return out, slot_names
end

local function extract_weapon(entry, html, game)
  local blocks = parse_jsonld(html)
  local faq = nil
  for _, block in ipairs(blocks) do
    if block["@type"] == "FAQPage" and type(block.mainEntity) == "table" then
      faq = block
      break
    end
  end
  if not faq then
    error("no FAQ data")
  end

  local tier = ""
  local pick_rate = ""
  local faq_build = ""
  local faq_ttk = ""
  local faq_attachments = {}
  local alternatives = {}

  for _, question in ipairs(faq.mainEntity) do
    local name = tostring(question.name or "")
    local answer = ""
    if type(question.acceptedAnswer) == "table" then
      answer = tostring(question.acceptedAnswer.text or "")
    end

    if game.faq_name and name:find("meta in " .. game.faq_name, 1, true) then
      tier = answer:match("ranked as (.-) in " .. game.faq_name .. "%.") or tier
      pick_rate = answer:match("pick rate is ([%d%.]+%%)") or pick_rate
    elseif game.faq_name and name:find("best", 1, true) and name:find("Loadout", 1, true) then
      faq_build = answer:match("Loadout is the (.-) build%.") or faq_build
      local raw_attachments = answer:match("For the attachment you want to use: (.*)") or ""
      faq_attachments = split_attachments(raw_attachments)
    elseif game.faq_name and (name:find("TTK", 1, true) or name:find("Time To Kill", 1, true)) then
      local parts = {}
      for value in answer:gmatch("(%d+ms)") do
        parts[#parts + 1] = value
      end
      faq_ttk = table.concat(parts, " / ")
    elseif game.faq_name and name:find("alternatives", 1, true) then
      local raw_alternatives = answer:match("best alternatives to .- are (.+)%.")
      if raw_alternatives then
        alternatives = split_simple_list(raw_alternatives)
      end
    end
  end

  local description = meta_description(html)
  local faq_code = description:match("Build code ([%w%-]+)")
  local builds = extract_builds(html)
  local att_stats, slot_names = parse_attachment_stats(html, game)
  for _, b in ipairs(builds) do
    for _, attachment in ipairs(b.attachments or {}) do
      if (attachment.name == "Apex Attachment" or attachment.name == attachment.slot .. " Attachment") and slot_names[attachment.slot] then
        attachment.name = slot_names[attachment.slot]
      end
      attachment.stats = att_stats[attachment.name .. "|" .. attachment.slot] or att_stats[attachment.name]
    end
  end
  local rendered, rendered_src, rendered_order = parse_rendered_labels(html)
  local groups = game.build_groups or { "Multiplayer" }
  local kept = {}
  for _, b in ipairs(builds) do
    local src = rendered_src[b.code] or ""
    for _, g in ipairs(groups) do
      if src == g then
        kept[#kept + 1] = b
        break
      end
    end
  end
  if #kept > 0 then
    table.sort(kept, function(a, b)
      return (rendered_order[a.code] or 999) < (rendered_order[b.code] or 999)
    end)
    builds = kept
  end
  local has_rendered = false
  for _ in pairs(rendered) do
    has_rendered = true
    break
  end
  for _, b in ipairs(builds) do
    local label = rendered[b.code]
    if label and label ~= "" then
      b.playstyle = label
    elseif has_rendered then
      b.playstyle = "Best Loadout"
    end
  end
  local rendered_builds = parse_rendered_builds(html)
  local panel_count = 0
  for _ in pairs(rendered_builds) do
    panel_count = panel_count + 1
  end
  rb.log.info(tostring(entry.name or "Unknown") .. ": rendered panels " .. panel_count .. ", kept " .. #builds)
  for _, b in ipairs(builds) do
    local r_att = rendered_builds[b.code]
    if r_att and #r_att > 0 then
      for _, a in ipairs(r_att) do
        if #(a.stats or {}) == 0 then
          a.stats = att_stats[a.name .. "|" .. a.slot] or att_stats[a.name]
        end
      end
      b.attachments = r_att
    end
  end
  local primary = nil
  if faq_code then
    for _, candidate in ipairs(builds) do
      if candidate.code == faq_code then
        primary = candidate
        break
      end
    end
  end
  if not primary and #builds > 0 then
    primary = builds[1]
  end

  if not primary then
    if not game.faq_name then
      error("no " .. game.label .. " loadout object")
    end
    primary = {
      playstyle = faq_build ~= "" and faq_build or "Build",
      code = faq_code or "",
      category = "",
      rating = 0,
      attachments = {},
    }
    for _, name in ipairs(faq_attachments) do
      primary.attachments[#primary.attachments + 1] = {
        slot = infer_slot(name) or "Attachment",
        name = name,
      }
    end
    builds = { primary }
  elseif #primary.attachments == 0 and #faq_attachments > 0 then
    for _, name in ipairs(faq_attachments) do
      primary.attachments[#primary.attachments + 1] = {
        slot = infer_slot(name) or "Attachment",
        name = name,
      }
    end
  end

  local weapon_category = trim(primary.category)
  if weapon_category == "" then
    local known = {
      ["Assault Rifle"] = true, ["Submachine Gun"] = true, ["SMG"] = true,
      ["Sniper Rifle"] = true, ["Sniper"] = true, ["Light Machine Gun"] = true,
      ["LMG"] = true, ["Shotgun"] = true, ["Pistol"] = true,
      ["Battle Rifle"] = true, ["Marksman Rifle"] = true, ["Launcher"] = true,
    }
    for value in tostring(html or ""):gmatch('category:"([^"]+)"') do
      if known[value] then
        weapon_category = value
        break
      end
    end
  end

  return {
    game = game.key,
    game_label = game.label,
    rank = tonumber(entry.position) or 0,
    name = tostring(entry.name or "Unknown"),
    url = tostring(entry.url or ""),
    tier = trim(tier),
    pick_rate = trim(pick_rate),
    build = trim(primary.playstyle),
    attachments = attachment_names(primary),
    code = tostring(primary.code or ""),
    ttk = trim(faq_ttk),
    category = weapon_category,
    rating = tonumber(primary.rating) or 0,
    alternatives = alternatives,
    builds = builds,
  }
end

local function http_get(url)
  if type(url) ~= "string" or url == "" then
    error("empty URL")
  end
  local response = rb.net.get(url, {
    headers = {
      ["User-Agent"] = USER_AGENT,
      ["Accept"] = "text/html,application/xhtml+xml",
      ["Accept-Language"] = "en-GB,en;q=0.9",
    },
    timeout = HTTP_TIMEOUT_MS,
  })
  if type(response) ~= "table" or tonumber(response.status) ~= 200 then
    error("HTTP " .. tostring(response and response.status or "?") .. " for " .. url)
  end
  return tostring(response.body or "")
end

local function load_cache(game)
  if not rb.file.exists(game.cache) then
    return false
  end
  local ok, data = pcall(rb.file.read_json, game.cache)
  if not ok or type(data) ~= "table" or type(data.items) ~= "table" then
    return false
  end
  if tonumber(data.version) ~= CACHE_VERSION then
    return false
  end

  local items = {}
  for _, item in ipairs(data.items) do
    if type(item) == "table" and type(item.name) == "string" and type(item.code) == "string" then
      if type(item.attachments) ~= "table" then
        item.attachments = {}
      end
      if type(item.alternatives) ~= "table" then
        item.alternatives = {}
      end
      if type(item.builds) ~= "table" or #item.builds == 0 then
        local fallback = {
          playstyle = tostring(item.build or "Build"),
          code = tostring(item.code or ""),
          category = tostring(item.category or ""),
          rating = tonumber(item.rating) or 0,
          attachments = {},
        }
        for _, name in ipairs(item.attachments) do
          fallback.attachments[#fallback.attachments + 1] = {
            slot = infer_slot(name) or "Attachment",
            name = tostring(name),
          }
        end
        item.builds = { fallback }
      end
      items[#items + 1] = item
    end
  end
  if #items == 0 then
    return false
  end

  table.sort(items, function(a, b)
    return (tonumber(a.rank) or 99) < (tonumber(b.rank) or 99)
  end)
  state.items = items
  state.week = tostring(data.week or "")
  state.report_url = tostring(data.report_url or "")
  state.updated_at = tonumber(data.updated_at) or 0
  state.previous_week = tostring(data.previous_week or "")
  state.previous_items = type(data.previous_items) == "table" and data.previous_items or {}
  state.history = type(data.history) == "table" and data.history or {}
  state.last_build = nil
  return true
end

local function compact_snapshot(items)
  local out = {}
  for _, weapon in ipairs(items or {}) do
    out[#out + 1] = {
      name = weapon.name,
      url = weapon.url,
      rank = weapon.rank,
      tier = weapon.tier,
      pick_rate = weapon.pick_rate,
      build = weapon.build,
      code = weapon.code,
    }
  end
  return out
end

local function save_cache(game, items, week, report_url)
  local previous_week = ""
  local previous_items = {}
  local history = {}

  if rb.file.exists(game.cache) then
    local ok, old = pcall(rb.file.read_json, game.cache)
    if ok and type(old) == "table" and type(old.items) == "table" then
      previous_week = tostring(old.week or "")
      previous_items = compact_snapshot(old.items)
      if type(old.history) == "table" then
        history = old.history
      end
      if previous_week == week then
        previous_week = tostring(old.previous_week or "")
        previous_items = type(old.previous_items) == "table" and old.previous_items or {}
      elseif previous_week ~= "" then
        local already = false
        for _, snapshot in ipairs(history) do
          if snapshot.week == previous_week then
            already = true
            break
          end
        end
        if not already then
          table.insert(history, 1, {
            week = previous_week,
            items = compact_snapshot(old.items),
          })
        end
        while #history > 8 do
          table.remove(history)
        end
      end
    end
  end

  local payload = {
    version = CACHE_VERSION,
    game = game.key,
    game_label = game.label,
    source = SOURCE,
    report_url = report_url,
    week = week,
    updated_at = os.time(),
    previous_week = previous_week,
    previous_items = previous_items,
    history = history,
    items = items,
  }
  local ok, err = pcall(rb.file.write_json, game.cache, payload)
  if not ok then
    rb.log.warn("CODMunity meta cache write failed: " .. tostring(err))
  end
  return previous_week, previous_items, history
end

local function load_user_state()
  if not rb.file.exists(USER_FILE) then
    return
  end
  local ok, data = pcall(rb.file.read_json, USER_FILE)
  if not ok or type(data) ~= "table" then
    return
  end
  local fields = {
    "favorites",
    "recent",
    "hud",
    "pins",
    "favorite_builds",
    "tags",
    "plan",
    "clipboard_history",
    "search_recent",
  }
  for _, key in ipairs(fields) do
    if type(data[key]) == "table" then
      state.user[key] = data[key]
    end
  end
end

local function save_user_state()
  local ok, err = pcall(rb.file.write_json, USER_FILE, state.user)
  if not ok then
    rb.log.warn("CODMunity user state write failed: " .. tostring(err))
  end
end

local function user_list(container, game_key)
  local list = container[game_key]
  if type(list) ~= "table" then
    list = {}
    container[game_key] = list
  end
  return list
end

local function favorite_list(game_key)
  return user_list(state.user.favorites, game_key)
end

local function recent_list(game_key)
  return user_list(state.user.recent, game_key)
end

local function find_weapon_index(list, url)
  for index, weapon in ipairs(list) do
    if weapon.url == url then
      return index
    end
  end
  return nil
end

local function is_favorite(weapon)
  if not weapon then
    return false
  end
  return find_weapon_index(favorite_list(state.game_key), weapon.url) ~= nil
end

local function toggle_favorite(weapon)
  if not weapon then
    notify("Select a weapon first", { title = "Favorite", duration = 2500 })
    return
  end
  local list = favorite_list(state.game_key)
  local index = find_weapon_index(list, weapon.url)
  if index then
    table.remove(list, index)
    notify("Removed from favorites", { title = weapon.name, duration = 2500 })
  else
    table.insert(list, 1, weapon)
    notify("Added to favorites", { title = weapon.name, duration = 2500 })
  end
  save_user_state()
end

local function add_recent(weapon)
  if not weapon then
    return
  end
  local list = recent_list(state.game_key)
  local index = find_weapon_index(list, weapon.url)
  if index then
    table.remove(list, index)
  end
  table.insert(list, 1, weapon)
  while #list > 8 do
    table.remove(list)
  end
  save_user_state()
end

local function hud_enabled(game_key)
  return state.user.hud[game_key] == true
end

local function set_hud_enabled(game_key, enabled)
  state.user.hud[game_key] = enabled and true or false
  save_user_state()
end

local function ui_text(value, fallback)
  if type(value) == "function" then
    rb.log.warn("CODMunity UI received a function where text was expected; suppressing it")
    return fallback or ""
  end
  local text = tostring(value or "")
  if text:find("function: 0x", 1, true) or text:find("table: 0x", 1, true) then
    rb.log.warn("CODMunity UI suppressed a raw function/table value: " .. text)
    return fallback or ""
  end
  return text
end

notify = function(text, options)
  if type(text) == "function" then
    rb.log.warn("CODMunity toast received a function; suppressing")
    return
  end
  text = ui_text(text, "")
  if text == "" then
    return
  end
  if type(options) ~= "table" then
    options = {}
  end
  options.anchor = options.anchor or "bottom-right"
  options.offset_x = options.offset_x or 24
  options.offset_y = options.offset_y or 24
  if options.title ~= nil then
    options.title = ui_text(options.title, SOURCE)
  end
  rb.overlay.toast(text, options)
end

local native_menu = rb.overlay.menu

local function open_overlay_menu(items, options)
  local clean_items = {}
  for _, item in ipairs(items or {}) do
    if type(item) == "table" then
      local clean = table.clone(item)
      clean.label = ui_text(item.label, "Unavailable")
      clean.hint = ui_text(item.hint, "")
      clean_items[#clean_items + 1] = clean
    end
  end
  local clean_options = {}
  if type(options) == "table" then
    for key, value in pairs(options) do
      clean_options[key] = value
    end
  end
  if clean_options.title ~= nil then
    clean_options.title = ui_text(clean_options.title, SOURCE)
  end
  if clean_options.subtitle ~= nil then
    clean_options.subtitle = ui_text(clean_options.subtitle, "")
  end
  return native_menu(clean_items, clean_options)
end

local function set_status(text)
  local flat = text
  if type(text) == "table" then
    local parts = {}
    for _, seg in ipairs(text) do
      local value = seg
      if type(seg) == "table" then
        value = seg[1]
      end
      if type(value) ~= "string" then
        value = ""
      end
      parts[#parts + 1] = value
    end
    flat = table.concat(parts, " ")
  elseif type(text) ~= "string" then
    flat = ""
  end
  if state.status then
    state.status:set(flat)
  else
    state.status = rb.overlay.status(flat, {
      anchor = "bottom-left",
      offset_x = 24,
      offset_y = 24,
    })
  end
end

local function clear_status()
  if state.status then
    pcall(function()
      state.status:remove()
    end)
    state.status = nil
  end
end

local function pin_map(game_key)
  local map = state.user.pins[game_key]
  if type(map) ~= "table" then
    map = {}
    state.user.pins[game_key] = map
  end
  return map
end

local function pinned_build(weapon)
  if not weapon then
    return nil
  end
  local code = pin_map(state.game_key)[weapon.url]
  if not code or code == "" then
    return nil
  end
  for _, build in ipairs(weapon.builds or {}) do
    if build.code == code then
      return build
    end
  end
  return nil
end

local function set_pinned_build(weapon, build)
  if not weapon or not build or not build.code or build.code == "" then
    return
  end
  pin_map(state.game_key)[weapon.url] = build.code
  save_user_state()
end

local function clear_pinned_build(weapon)
  if not weapon then
    return
  end
  pin_map(state.game_key)[weapon.url] = nil
  save_user_state()
end

local function favorite_builds_list(game_key)
  local list = state.user.favorite_builds[game_key]
  if type(list) ~= "table" then
    list = {}
    state.user.favorite_builds[game_key] = list
  end
  return list
end

local function find_favorite_build(weapon, build)
  if not weapon or not build then
    return nil
  end
  local list = favorite_builds_list(state.game_key)
  for index, entry in ipairs(list) do
    if entry.weapon and entry.build
      and entry.weapon.url == weapon.url
      and entry.build.code == build.code then
      return index
    end
  end
  return nil
end

local function toggle_favorite_build(weapon, build)
  if not weapon or not build then
    return false
  end
  local list = favorite_builds_list(state.game_key)
  local index = find_favorite_build(weapon, build)
  if index then
    table.remove(list, index)
    save_user_state()
    return false
  end
  table.insert(list, 1, { weapon = weapon, build = build })
  save_user_state()
  return true
end

local function tag_map(game_key)
  local map = state.user.tags[game_key]
  if type(map) ~= "table" then
    map = {}
    state.user.tags[game_key] = map
  end
  return map
end

local function tag_list(weapon)
  if not weapon then
    return {}
  end
  local list = tag_map(state.game_key)[weapon.url]
  if type(list) ~= "table" then
    list = {}
    tag_map(state.game_key)[weapon.url] = list
  end
  return list
end

local function has_tag(weapon, tag)
  for _, value in ipairs(tag_list(weapon)) do
    if value == tag then
      return true
    end
  end
  return false
end

local function toggle_tag(weapon, tag)
  if not weapon then
    return false
  end
  local list = tag_list(weapon)
  for index, value in ipairs(list) do
    if value == tag then
      table.remove(list, index)
      save_user_state()
      return false
    end
  end
  list[#list + 1] = tag
  save_user_state()
  return true
end

local function plan_table(game_key)
  local plan = state.user.plan[game_key]
  if type(plan) ~= "table" then
    plan = {}
    state.user.plan[game_key] = plan
  end
  return plan
end

local function set_plan_slot(slot, weapon, build)
  if not weapon or not build then
    return
  end
  plan_table(state.game_key)[slot] = {
    weapon = weapon,
    build = build,
  }
  save_user_state()
end

local function clear_plan()
  state.user.plan[state.game_key] = {}
  save_user_state()
end

local function record_clipboard(text, label)
  if not text or text == "" then
    return
  end
  local list = state.user.clipboard_history
  for index = #list, 1, -1 do
    if list[index].text == text then
      table.remove(list, index)
    end
  end
  table.insert(list, 1, {
    text = text,
    label = label or "Copied",
    at = os.time(),
  })
  while #list > 6 do
    table.remove(list)
  end
  save_user_state()
end

local function search_recent_list()
  local list = state.user.search_recent
  if type(list) ~= "table" then
    list = {}
    state.user.search_recent = list
  end
  return list
end

local function add_search_recent(query)
  query = trim(query)
  if query == "" then
    return
  end
  local list = search_recent_list()
  for index = #list, 1, -1 do
    if list[index] == query then
      table.remove(list, index)
    end
  end
  table.insert(list, 1, query)
  while #list > 6 do
    table.remove(list)
  end
  save_user_state()
end

local CATEGORY_KEYS = {
  ar = { "Assault Rifle" },
  smg = { "Submachine Gun", "SMG" },
  sniper = { "Sniper Rifle", "Sniper" },
  lmg = { "Light Machine Gun", "LMG" },
  shotgun = { "Shotgun" },
  pistol = { "Pistol" },
}

local function primary_build(weapon)
  if not weapon then
    return nil
  end
  local builds = weapon.builds or {}
  for _, build in ipairs(builds) do
    if build.code == weapon.code then
      return build
    end
  end
  return builds[1]
end

local function current_build(weapon)
  if not weapon then
    return nil
  end
  if state.last_build then
    for _, build in ipairs(weapon.builds or {}) do
      if build.code == state.last_build.code then
        return build
      end
    end
  end
  local pinned = pinned_build(weapon)
  if pinned then
    return pinned
  end
  return primary_build(weapon)
end

local function pick_value(weapon)
  local text = tostring(weapon and weapon.pick_rate or ""):gsub("%%", "")
  return tonumber(text) or 0
end

local function category_matches(weapon)
  local filter = tostring(cfg.category or "all")
  if filter == "all" then
    return true
  end
  local category = tostring(weapon and weapon.category or ""):lower()
  for _, name in ipairs(CATEGORY_KEYS[filter] or {}) do
    if category:find(name:lower(), 1, true) then
      return true
    end
  end
  return false
end

local index_cache = nil
local function all_weapon_items()
  if not index_cache then
    index_cache = state.index or {}
  end
  local prefixes = selected_game().prefixes or {}
  local allowed = {}
  for _, p in ipairs(prefixes) do
    allowed[p] = true
  end
  local out = {}
  for _, entry in ipairs(index_cache) do
    if type(entry) == "table" and type(entry.name) == "string" and allowed[tostring(entry.prefix or "")] then
      out[#out + 1] = {
        name = entry.name,
        url = tostring(entry.url or ""),
        rank = 0,
        tier = "",
        pick_rate = "",
        category = tostring(entry.category or ""),
        builds = {},
        attachments = {},
        from_index = true,
      }
    end
  end
  table.sort(out, function(a, b)
    return tostring(a.name) < tostring(b.name)
  end)
  return out
end

local function get_view_items()
  local view = tostring(cfg.view or "meta")
  local base
  if view == "favorites" then
    base = favorite_list(state.game_key)
  elseif view == "recent" then
    base = recent_list(state.game_key)
  elseif view == "all" then
    base = all_weapon_items()
  else
    base = state.items
  end

  -- Favorites and recents hold saved snapshots; force a fresh weapon fetch for
  -- both so the detail view never shows stale attachments from an old cache.
  if view == "favorites" or view == "recent" then
    for _, w in ipairs(base) do
      if type(w) == "table" then
        w.from_recent = true
      end
    end
  end

  local items = {}
  for _, weapon in ipairs(base) do
    if type(weapon) == "table" and category_matches(weapon) then
      items[#items + 1] = weapon
    end
  end

  local sort = tostring(cfg.sort or "rank")
  if sort == "pick" then
    table.sort(items, function(a, b)
      return pick_value(a) > pick_value(b)
    end)
  elseif sort == "name" then
    table.sort(items, function(a, b)
      return tostring(a.name or "") < tostring(b.name or "")
    end)
  else
    table.sort(items, function(a, b)
      return (tonumber(a.rank) or 99) < (tonumber(b.rank) or 99)
    end)
  end
  return items
end

local function updated_label()
  if state.updated_at <= 0 then
    return "not updated"
  end
  return os.date("%d %b %H:%M", state.updated_at)
end

local function weapon_hint(weapon)
  local parts = {}
  if weapon.tier and weapon.tier ~= "" then
    parts[#parts + 1] = weapon.tier
  end
  if weapon.pick_rate and weapon.pick_rate ~= "" then
    parts[#parts + 1] = weapon.pick_rate
  end
  if #parts == 0 then
    local build = primary_build(weapon)
    if build then
      parts[#parts + 1] = tostring(build.playstyle or "Build")
    end
    if tonumber(weapon.rating or 0) > 0 then
      parts[#parts + 1] = string.format("%.2f", weapon.rating)
    end
  end
  return table.concat(parts, "  ")
end

local function remove_surface(handle)
  if handle then
    pcall(function()
      handle:remove()
    end)
  end
end

local function copy_code(weapon, build)
  build = build or current_build(weapon)
  local code = build and build.code or (weapon and weapon.code)
  if not weapon or not code or code == "" then
    notify("No build code on this page", {
      title = weapon and weapon.name or "CODMunity",
      duration = 3500,
    })
    return false
  end

  local ok, err = pcall(rb.clipboard.set, code)
  if not ok then
    rb.log.warn("CODMunity code copy failed: " .. tostring(err))
    notify("Clipboard write failed", { title = "Copy failed", duration = 4000 })
    return false
  end

  state.last = weapon
  state.last_build = build
  state.last_copied_code = code
  add_recent(weapon)
  record_clipboard(code, "Build code")
  notify(code, {
    title = "Copied " .. weapon.name,
    duration = 2500,
  })
  return true
end

local function show_detail(weapon)
  apply_theme()
  remove_surface(state.detail)
  state.detail = nil
  if state.compare_handler then
    pcall(function()
      state.compare_handler:stop()
    end)
    state.compare_handler = nil
  end
  remove_surface(state.compare_surface)
  state.compare_surface = nil
  remove_surface(state.changes_surface)
  state.changes_surface = nil
  if not weapon then
    return
  end

  local build = current_build(weapon) or primary_build(weapon)
  local width = 470
  local pad = 16
  local y = 14
  local ops = {
    { kind = "rect", x = 0, y = 0, w = width, h = 400, fill = THEME.surface,
      border = THEME.border, border_width = 1, radius = 10, shadow = 0.45 },
  }

  local weapon_img = WEAPON_IMAGES and WEAPON_IMAGES[weapon.name]
  if weapon_img then
    local img_path = "@data/img/" .. tostring(weapon.name):gsub("%s+", "-") .. ".png"
    if not img_ready[img_path] then
      img_ready[img_path] = true
      pcall(rb.file.mkdir, "@data/img")
      local okw, werr = pcall(rb.file.write, img_path, rb.codec.base64_decode(weapon_img))
      if not okw then
        rb.log.warn("CODMunity weapon image write failed: " .. tostring(werr))
        img_ready[img_path] = nil
      end
    end
    if rb.file.exists(img_path) then
      local okr, png = pcall(rb.file.read_bytes, img_path)
      if okr and png and #png > 0 then
        local ih = math.floor((width - pad * 2) * 165 / 440 + 0.5)
        ops[#ops + 1] = { kind = "image", x = pad, y = y, w = width - pad * 2, h = ih, png = png }
        y = y + ih + 8
      else
        rb.log.warn("CODMunity weapon image read failed for " .. tostring(weapon.name))
      end
    end
  end

  local function add_text(size, text, color, bold)
    ops[#ops + 1] = {
      kind = "text",
      x = pad,
      y = y,
      size = size,
      text = tostring(text or ""),
      color = color,
      bold = bold or false,
    }
    y = y + math.max(size + 5, 18)
  end

  local favorite_mark = is_favorite(weapon) and " *" or ""
  local rank = tonumber(weapon.rank) or 0
  local rank_text = rank > 0 and ("#" .. rank) or "#--"
  add_text(20, string.format("%s  %s%s", rank_text, fit(weapon.name, 30), favorite_mark), THEME.accent, true)

  local summary = {}
  if weapon.tier and weapon.tier ~= "" then
    summary[#summary + 1] = weapon.tier
  end
  if weapon.pick_rate and weapon.pick_rate ~= "" then
    summary[#summary + 1] = weapon.pick_rate
  end
  if weapon.category and weapon.category ~= "" then
    summary[#summary + 1] = weapon.category
  end
  add_text(12, table.concat(summary, "  |  "), THEME.dim, false)

  local build_label = tostring((build and build.playstyle) or weapon.build or "Build") .. " build"
  if tonumber((build and build.rating) or weapon.rating or 0) > 0 then
    build_label = build_label .. string.format("  |  %.2f", tonumber((build and build.rating) or weapon.rating))
  end
  add_text(14, build_label, THEME.text, true)
  local pinned = pinned_build(weapon)
  if pinned and build and pinned.code == build.code then
    add_text(10, "PINNED BUILD", THEME.positive, true)
  end
  local tags = tag_list(weapon)
  if #tags > 0 then
    add_text(10, "Tags: " .. table.concat(tags, ", "), THEME.dim, false)
  end

  ops[#ops + 1] = { kind = "rect", x = pad, y = y, w = width - pad * 2, h = 1, fill = THEME.border }
  y = y + 12

  local attachments = build and build.attachments or nil
  if type(attachments) ~= "table" or #attachments == 0 then
    attachments = {}
    for _, name in ipairs(weapon.attachments or {}) do
      attachments[#attachments + 1] = { slot = infer_slot(name) or "Attachment", name = tostring(name) }
    end
  end
  for _, attachment in ipairs(attachments) do
    local head = "[" .. attachment_abbr(attachment) .. "] " .. attachment.slot
    if attachment.level and attachment.level ~= "" then
      head = head .. " \194\183 " .. attachment.level
    end
    add_text(13, head, THEME.faint, false)
    add_text(13, fit(attachment.name, 44), THEME.text, false)
    local shown = 0
    for _, stat in ipairs(attachment.stats or {}) do
      shown = shown + 1
      if shown > 4 then
        break
      end
      if stat.text then
        local color = stat.buff and THEME.positive or THEME.danger
        add_text(11, "      " .. stat.text, color, false)
      else
        local sign = stat.pct > 0 and "+" or ""
        local buff
        if stat.kind == "POSITIVE" then
          buff = stat.pct > 0
        else
          buff = stat.pct < 0
        end
        local color = buff and THEME.positive or THEME.danger
        add_text(11, string.format("      %s%.1f%% %s", sign, stat.pct, stat.label), color, false)
      end
    end
  end
  ops[1].h = math.max(400, y + 30)
  local issues = build_issues(build)
  if #issues > 0 then
    add_text(10, "Check: " .. fit(table.concat(issues, ", "), 54), THEME.warning, false)
  end

  y = y + 6
  local code = build and build.code or weapon.code or ""
  add_text(10, "BUILD CODE", THEME.faint, false)
  add_text(17, code ~= "" and code or "not listed", THEME.accent, true)

  if state.last_copied_code and state.last_copied_code == code then
    add_text(11, "Copied to clipboard", THEME.positive, false)
  end
  if weapon.ttk and weapon.ttk ~= "" then
    add_text(11, "TTK  " .. weapon.ttk, THEME.dim, false)
  end
  local history = rank_history_text(weapon)
  if history ~= "" then
    add_text(11, "Rank: " .. history, THEME.dim, false)
  end
  if type(weapon.alternatives) == "table" and #weapon.alternatives > 0 then
    add_text(11, "Alt: " .. fit(table.concat(weapon.alternatives, ", "), 58), THEME.dim, false)
  end

  local game_label = weapon.game_label or state.game.label
  add_text(10, "F6 builds  |  F4 compare  |  F5 favorite  |  F11 extras", THEME.faint, false)
  add_text(10, "F9 copy  |  F10 full  |  F8 close  |  " .. game_label .. " / " .. SOURCE .. " / " .. updated_label(), THEME.faint, false)

  local height = y + pad
  ops[1].h = height

  local ok, err = pcall(function()
    state.detail = rb.overlay.surface({
      capturable = cfg.capturable,
      anchor = "top-right",
      width = width,
      height = height,
      offset_x = 24,
      offset_y = 24,
      opacity = 0.98,
      ops = ops,
    })
  end)
  if not ok then
    rb.log.warn("CODMunity detail surface failed: " .. tostring(err))
  end
end

local function select_weapon(weapon, build)
  if not weapon then
    return
  end
  state.last = weapon
  state.last_build = build or current_build(weapon) or primary_build(weapon)
  if cfg.copy_on_select then
    copy_code(weapon, state.last_build)
  else
    add_recent(weapon)
  end
  show_detail(weapon)
end

local function open_build_menu()
  if sync_game then
    sync_game(false)
  end
  if state.search then
    close_search()
  end
  if state.menu then
    pcall(function()
      state.menu:close()
    end)
    state.menu = nil
  end

  local weapon = state.last or state.items[1]
  if not weapon then
    notify("Open the meta menu first", { title = "Builds", duration = 3000 })
    return
  end
  local builds = weapon.builds or {}
  if #builds <= 1 then
    notify("This weapon has one build in the current cache", { title = weapon.name, duration = 3000 })
    return
  end

  local items = {}
  local mapping = {}
  local pin = pinned_build(weapon)
  for _, build in ipairs(builds) do
    local hint_parts = {}
    if build.code and build.code ~= "" then
      hint_parts[#hint_parts + 1] = build.code
    end
    if tonumber(build.rating or 0) > 0 then
      hint_parts[#hint_parts + 1] = string.format("%.2f", build.rating)
    end
    local marks = {}
    if pin and pin.code == build.code then
      marks[#marks + 1] = "PIN"
    end
    if find_favorite_build(weapon, build) then
      marks[#marks + 1] = "FAV"
    end
    if #build_issues(build) > 0 then
      marks[#marks + 1] = "!"
    end
    local prefix = #marks > 0 and ("[" .. table.concat(marks, "/") .. "] ") or ""
    items[#items + 1] = {
      label = prefix .. fit(build.playstyle or "Build", 20),
      hint = table.concat(hint_parts, "  "),
    }
    mapping[#mapping + 1] = build
  end

  local menu, why = open_overlay_menu(items, {
    title = weapon.name .. " builds",
    subtitle = "Enter copies code and shows attachments",
    width = 620,
    theme = "tokyo-night",
    on_select = function(index)
      local build = mapping[index]
      if build then
        state.last = weapon
        state.last_build = build
        if cfg.copy_on_select then
          copy_code(weapon, build)
        else
          add_recent(weapon)
        end
        show_detail(weapon)
      end
    end,
    on_close = function()
      state.menu = nil
    end,
  })
  if menu then
    state.menu = menu
  else
    rb.log.warn("CODMunity build menu: " .. tostring(why))
    notify("Could not open builds: " .. tostring(why), { title = "Builds", duration = 3500 })
  end
end

local function full_loadout_text(weapon, build_override)
  local build = build_override or current_build(weapon) or primary_build(weapon)
  local lines = {}
  lines[#lines + 1] = string.format("%s - %s #%d", weapon.name or "Weapon", state.game.label, tonumber(weapon.rank) or 0)
  local summary = {}
  if weapon.tier and weapon.tier ~= "" then
    summary[#summary + 1] = weapon.tier
  end
  if weapon.pick_rate and weapon.pick_rate ~= "" then
    summary[#summary + 1] = weapon.pick_rate
  end
  if weapon.category and weapon.category ~= "" then
    summary[#summary + 1] = weapon.category
  end
  if #summary > 0 then
    lines[#lines + 1] = table.concat(summary, " | ")
  end
  lines[#lines + 1] = tostring((build and build.playstyle) or weapon.build or "Build") .. " build"
  local attachments = build and build.attachments or {}
  if #attachments == 0 then
    for _, name in ipairs(weapon.attachments or {}) do
      attachments[#attachments + 1] = { slot = infer_slot(name) or "Attachment", name = tostring(name) }
    end
  end
  for _, attachment in ipairs(attachments) do
    lines[#lines + 1] = string.format("%s: %s", attachment_slot(attachment), attachment.name or "")
  end
  local code = build and build.code or weapon.code or ""
  lines[#lines + 1] = "Code: " .. (code ~= "" and code or "not listed")
  lines[#lines + 1] = "Week of " .. (state.week ~= "" and state.week or "current")
  return table.concat(lines, "\n")
end

local function copy_text_async(text, title, message)
  rb.run(function()
    local ok, err = pcall(rb.clipboard.set, text)
    if not ok then
      rb.sleep(120)
      ok, err = pcall(rb.clipboard.set, text)
    end
    if not ok then
      rb.log.warn("CODMunity clipboard copy failed: " .. tostring(err))
      notify("Clipboard write failed", { title = "Copy failed", duration = 4000 })
      return
    end
    record_clipboard(text, title or "Copied")
    notify(message or "Copied", { title = title or SOURCE, duration = 2500 })
  end)
end

local function copy_full_loadout()
  if sync_game then
    sync_game(false)
  end
  if state.search then
    close_search()
  end
  local weapon = state.last or state.items[1]
  if not weapon then
    notify("Open the meta menu first", { title = "Full loadout", duration = 3000 })
    return
  end
  local text = full_loadout_text(weapon)
  add_recent(weapon)
  copy_text_async(text, weapon.name, "Full loadout copied")
end

local function parse_ttk(weapon)
  local values = {}
  for value in tostring(weapon and weapon.ttk or ""):gmatch("(%d+)ms") do
    values[#values + 1] = tonumber(value)
  end
  return values
end

local function remove_compare()
  if state.compare_handler then
    pcall(function()
      state.compare_handler:stop()
    end)
    state.compare_handler = nil
  end
  remove_surface(state.compare_surface)
  state.compare_surface = nil
  state.compare_a = nil
  state.compare_b = nil
  state.compare_a_build = nil
  state.compare_b_build = nil
end

local function install_compare_handler()
  if not state.compare_surface or state.compare_handler then
    return
  end
  state.compare_handler = rb.on("down", function(key)
    if key == "Escape" then
      rb.after(0, remove_compare)
      return false
    end
    return true
  end)
end

local function show_compare(a, b, build_a, build_b)
  apply_theme()
  remove_compare()
  if not a or not b then
    notify("Need two weapons to compare", { title = "Compare", duration = 3000 })
    return
  end
  build_a = build_a or current_build(a) or primary_build(a)
  build_b = build_b or current_build(b) or primary_build(b)
  state.compare_a = a
  state.compare_b = b
  state.compare_a_build = build_a
  state.compare_b_build = build_b

  local width = 780
  local pad = 18
  local colw = 356
  local gap = 24
  local ops = {
    { kind = "rect", x = 0, y = 0, w = width, h = 470, fill = THEME.surface,
      border = THEME.border, border_width = 1, radius = 10, shadow = 0.45 },
  }
  local y = 14

  local function add_text(x, yy, size, text, color, bold)
    ops[#ops + 1] = {
      kind = "text",
      x = x,
      y = yy,
      size = size,
      text = tostring(text or ""),
      color = color,
      bold = bold or false,
    }
  end

  add_text(pad, y, 18, "COMPARE", THEME.accent, true)
  y = y + 24
  add_text(pad, y, 10, state.game.label .. "  |  Week of " .. (state.week ~= "" and state.week or "current") .. "  |  " .. updated_label(), THEME.faint, false)
  y = y + 24

  local function draw_column(x, weapon, build, marker)
    local yy = y
    local rank = tonumber(weapon.rank) or 0
    local rank_text = rank > 0 and ("#" .. rank) or "#--"
    add_text(x, yy, 17, marker .. "  " .. rank_text .. "  " .. fit(weapon.name, 24), THEME.accent, true)
    yy = yy + 24
    local summary = {}
    if weapon.tier and weapon.tier ~= "" then
      summary[#summary + 1] = weapon.tier
    end
    if weapon.pick_rate and weapon.pick_rate ~= "" then
      summary[#summary + 1] = weapon.pick_rate
    end
    if #summary == 0 and tonumber(weapon.rating or 0) > 0 then
      summary[#summary + 1] = string.format("Rating %.2f", weapon.rating)
    end
    add_text(x, yy, 11, table.concat(summary, "  |  "), THEME.dim, false)
    yy = yy + 18
    add_text(x, yy, 12, tostring((build and build.playstyle) or weapon.build or "Build") .. " build", THEME.text, true)
    yy = yy + 18
    local code = build and build.code or weapon.code or ""
    add_text(x, yy, 10, "Code  " .. (code ~= "" and code or "not listed"), THEME.accent, false)
    yy = yy + 18
    local attachments = build and build.attachments or {}
    for index = 1, math.min(6, #attachments) do
      local attachment = attachments[index]
      add_text(x, yy, 10, string.format("%s  %s", attachment_abbr(attachment), fit(attachment.name, 38)), THEME.dim, false)
      yy = yy + 14
    end
    return yy
  end

  local left_bottom = draw_column(pad, a, build_a, "A")
  local right_bottom = draw_column(pad + colw + gap, b, build_b, "B")
  y = math.max(left_bottom, right_bottom) + 8
  ops[#ops + 1] = { kind = "rect", x = pad, y = y, w = width - pad * 2, h = 1, fill = THEME.border }
  y = y + 14

  add_text(pad, y, 12, "TTK by range", THEME.text, true)
  y = y + 20
  local av = parse_ttk(a)
  local bv = parse_ttk(b)
  local labels = { "10m", "40m", "80m", "120m" }
  local max_value = 0
  for index = 1, 4 do
    max_value = math.max(max_value, av[index] or 0, bv[index] or 0)
  end

  if max_value == 0 then
    add_text(pad, y, 11, "No TTK data for this mode", THEME.dim, false)
    y = y + 22
  else
    local bar_x = pad + 48
    local bar_max = width - pad * 2 - 180
    for index = 1, 4 do
      add_text(pad, y - 2, 10, labels[index], THEME.faint, false)
      local aw = av[index] and math.max(2, av[index] / max_value * bar_max) or 0
      local bw = bv[index] and math.max(2, bv[index] / max_value * bar_max) or 0
      ops[#ops + 1] = { kind = "rect", x = bar_x, y = y, w = aw, h = 8, fill = THEME.accent, radius = 3 }
      add_text(bar_x + bar_max + 8, y - 3, 10, av[index] and (av[index] .. "ms") or "-", THEME.dim, false)
      y = y + 12
      ops[#ops + 1] = { kind = "rect", x = bar_x, y = y, w = bw, h = 8, fill = THEME.positive, radius = 3 }
      add_text(bar_x + bar_max + 8, y - 3, 10, bv[index] and (bv[index] .. "ms") or "-", THEME.dim, false)
      y = y + 18
    end
  end

  add_text(pad, y + 2, 10, "A " .. a.name .. "   |   B " .. b.name, THEME.faint, false)
  add_text(pad, y + 16, 10, "F9 copy A   |   F10 copy B   |   F6 actions / switch builds", THEME.faint, false)
  add_text(pad, y + 30, 10, "F4 change opponent   |   Esc close   |   F8 meta menu", THEME.faint, false)
  y = y + 48
  ops[1].h = y + pad

  local ok, err = pcall(function()
    state.compare_surface = rb.overlay.surface({
      capturable = cfg.capturable,
      anchor = "center",
      width = width,
      height = ops[1].h,
      opacity = 0.98,
      ops = ops,
    })
  end)
  if not ok then
    rb.log.warn("CODMunity compare surface failed: " .. tostring(err))
  else
    install_compare_handler()
  end
end

local function compare_candidates(anchor)
  local seen = {}
  local candidates = {}
  local function add(weapon)
    if not weapon or type(weapon) ~= "table" then
      return
    end
    local key = weapon.url or weapon.name
    if not key or (anchor and key == (anchor.url or anchor.name)) or seen[key] then
      return
    end
    seen[key] = true
    candidates[#candidates + 1] = weapon
  end

  for _, weapon in ipairs(get_view_items()) do
    add(weapon)
  end
  for _, weapon in ipairs(state.items) do
    add(weapon)
  end
  for _, weapon in pairs(state.dynamic) do
    add(weapon)
  end
  for _, weapon in ipairs(recent_list(state.game_key)) do
    add(weapon)
  end
  for _, weapon in ipairs(favorite_list(state.game_key)) do
    add(weapon)
  end
  while #candidates > 24 do
    table.remove(candidates)
  end
  return candidates
end

local function toggle_compare()
  if state.compare_surface then
    remove_compare()
  end
  if sync_game then
    sync_game(false)
  end
  if state.search then
    close_search()
  end
  if state.menu then
    pcall(function()
      state.menu:close()
    end)
    state.menu = nil
  end

  local anchor = state.last or state.items[1]
  if not anchor then
    notify("Open the meta menu first", { title = "Compare", duration = 3000 })
    return
  end
  local candidates = compare_candidates(anchor)
  if #candidates == 0 then
    notify("No other weapons loaded. Search for one first.", { title = "Compare", duration = 3500 })
    return
  end

  remove_surface(state.detail)
  state.detail = nil
  local items = {}
  local mapping = {}
  for _, weapon in ipairs(candidates) do
    local rank = tonumber(weapon.rank) or 0
    local rank_text = rank > 0 and string.format("%2d", rank) or " -"
    items[#items + 1] = {
      label = string.format("%s  %s", rank_text, fit(weapon.name, 26)),
      hint = weapon_hint(weapon),
    }
    mapping[#mapping + 1] = weapon
  end

  local menu, why = open_overlay_menu(items, {
    title = "Compare " .. anchor.name,
    subtitle = "Choose the opponent  |  Enter compares  |  Esc cancels",
    width = 680,
    theme = "tokyo-night",
    on_select = function(index)
      local opponent = mapping[index]
      if opponent then
        show_compare(anchor, opponent)
      end
    end,
    on_close = function()
      state.menu = nil
    end,
  })
  if menu then
    state.menu = menu
  else
    rb.log.warn("CODMunity compare menu: " .. tostring(why))
    notify("Could not open compare picker: " .. tostring(why), { title = "Compare", duration = 3500 })
  end
end

local function compare_side(side)
  if side == "A" then
    return state.compare_a, state.compare_a_build
  end
  return state.compare_b, state.compare_b_build
end

local function copy_compare_side(side, full)
  local weapon, build = compare_side(side)
  if not weapon then
    notify("Comparison is not open", { title = "Copy " .. side, duration = 2500 })
    return
  end
  build = build or primary_build(weapon)
  if full then
    copy_text_async(full_loadout_text(weapon, build), weapon.name, "Full loadout copied")
    return
  end
  local code = build and build.code or weapon.code or ""
  if code == "" then
    notify("No build code on this side", { title = "Copy " .. side, duration = 3000 })
    return
  end
  copy_text_async(code, weapon.name, "Build code copied")
end

local function open_compare_build_menu(side)
  local weapon, active_build = compare_side(side)
  if not weapon then
    notify("Comparison is not open", { title = "Compare builds", duration = 2500 })
    return
  end
  local builds = weapon.builds or {}
  if #builds <= 1 then
    notify(side .. " has only one build", { title = weapon.name, duration = 3000 })
    return
  end
  if state.menu then
    pcall(function()
      state.menu:close()
    end)
    state.menu = nil
  end
  if state.compare_handler then
    pcall(function()
      state.compare_handler:stop()
    end)
    state.compare_handler = nil
  end

  local items = {}
  local mapping = {}
  for _, build in ipairs(builds) do
    local marker = active_build and build.code == active_build.code and "TOP  " or ""
    items[#items + 1] = {
      label = marker .. fit(build.playstyle or "Build", 24),
      hint = string.format("%s  %.2f", build.code or "", tonumber(build.rating or 0) or 0),
    }
    mapping[#mapping + 1] = build
  end

  local menu, why = open_overlay_menu(items, {
    title = side .. " build  |  " .. weapon.name,
    subtitle = "Enter switches this side of the comparison",
    width = 680,
    theme = "tokyo-night",
    on_select = function(index)
      local build = mapping[index]
      if not build then
        return
      end
      if side == "A" then
        state.compare_a_build = build
        if state.last and state.last.url == weapon.url then
          state.last_build = build
        end
      else
        state.compare_b_build = build
      end
      show_compare(state.compare_a, state.compare_b, state.compare_a_build, state.compare_b_build)
    end,
    on_close = function()
      state.menu = nil
      install_compare_handler()
    end,
  })
  if menu then
    state.menu = menu
  else
    rb.log.warn("CODMunity compare build menu: " .. tostring(why))
    notify("Could not open builds: " .. tostring(why), { title = "Compare builds", duration = 3500 })
    install_compare_handler()
  end
end

local function open_compare_actions()
  if not state.compare_surface or not state.compare_a or not state.compare_b then
    notify("Comparison is not open", { title = "Compare actions", duration = 2500 })
    return
  end
  if state.menu then
    pcall(function()
      state.menu:close()
    end)
    state.menu = nil
  end
  if state.compare_handler then
    pcall(function()
      state.compare_handler:stop()
    end)
    state.compare_handler = nil
  end

  local a, b = state.compare_a, state.compare_b
  local build_a, build_b = state.compare_a_build, state.compare_b_build
  local items = {
    { label = "Copy A full loadout", hint = a.name },
    { label = "Copy B full loadout", hint = b.name },
    { label = "Copy A build code", hint = build_a and build_a.playstyle or "" },
    { label = "Copy B build code", hint = build_b and build_b.playstyle or "" },
    { label = "Switch A build", hint = build_a and build_a.playstyle or "choose" },
    { label = "Switch B build", hint = build_b and build_b.playstyle or "choose" },
    { label = "Copy A+B summary", hint = "short comparison text" },
    { label = "Change opponent", hint = "back to weapon picker" },
    { label = "Close comparison", hint = "Esc" },
  }
  local actions = {
    "copy_a_full",
    "copy_b_full",
    "copy_a_code",
    "copy_b_code",
    "switch_a",
    "switch_b",
    "copy_summary",
    "change_opponent",
    "close",
  }

  local menu, why = open_overlay_menu(items, {
    title = "Compare actions",
    subtitle = "Copy either side, switch builds, or go back",
    width = 640,
    theme = "tokyo-night",
    on_select = function(index)
      local action = actions[index]
      if action == "copy_a_full" then
        copy_compare_side("A", true)
      elseif action == "copy_b_full" then
        copy_compare_side("B", true)
      elseif action == "copy_a_code" then
        copy_compare_side("A", false)
      elseif action == "copy_b_code" then
        copy_compare_side("B", false)
      elseif action == "switch_a" then
        rb.after(0, function()
          open_compare_build_menu("A")
        end)
      elseif action == "switch_b" then
        rb.after(0, function()
          open_compare_build_menu("B")
        end)
      elseif action == "copy_summary" then
        local summary = compare_summary_text()
        if summary then
          copy_text_async(summary, "A vs B", "Comparison summary copied")
        end
      elseif action == "change_opponent" then
        rb.after(0, toggle_compare)
      elseif action == "close" then
        rb.after(0, remove_compare)
      end
    end,
    on_close = function()
      state.menu = nil
      install_compare_handler()
    end,
  })
  if menu then
    state.menu = menu
  else
    rb.log.warn("CODMunity compare actions: " .. tostring(why))
    notify("Could not open compare actions: " .. tostring(why), { title = "Compare actions", duration = 3500 })
    install_compare_handler()
  end
end

local function active_weapon()
  return state.last or state.items[1]
end

local function active_build()
  local weapon = active_weapon()
  if not weapon then
    return nil, nil
  end
  return current_build(weapon) or primary_build(weapon), weapon
end

build_issues = function(build)
  local issues = {}
  if not build then
    return { "no build" }
  end
  local attachments = build.attachments or {}
  if #attachments < 5 then
    issues[#issues + 1] = #attachments .. " attachments"
  end
  local seen = {}
  for _, attachment in ipairs(attachments) do
    local slot = attachment_slot(attachment)
    if seen[slot] then
      issues[#issues + 1] = "duplicate " .. (SLOT_ABBR[slot] or slot)
    else
      seen[slot] = true
    end
  end
  if not build.code or build.code == "" then
    issues[#issues + 1] = "no code"
  end
  return issues
end

local function rank_history(weapon)
  local ranks = {}
  if not weapon then
    return ranks
  end
  for index = #state.history, 1, -1 do
    local snapshot = state.history[index]
    for _, item in ipairs(snapshot.items or {}) do
      if item.url == weapon.url and tonumber(item.rank) then
        ranks[#ranks + 1] = tonumber(item.rank)
        break
      end
    end
  end
  local current = tonumber(weapon.rank) or 0
  if current > 0 then
    ranks[#ranks + 1] = current
  end
  return ranks
end

rank_history_text = function(weapon)
  local ranks = rank_history(weapon)
  if #ranks < 2 then
    return ""
  end
  local parts = {}
  for _, rank in ipairs(ranks) do
    parts[#parts + 1] = "#" .. rank
  end
  return table.concat(parts, " > ")
end

local function csv_escape(value)
  local text = tostring(value or "")
  if text:find('[,"\n]') then
    return '"' .. text:gsub('"', '""') .. '"'
  end
  return text
end

local function short_format(weapon, build)
  return string.format("%s - %s - %s",
    weapon.name or "Weapon",
    (build and build.playstyle) or weapon.build or "Build",
    (build and build.code) or weapon.code or "no code")
end

local function discord_format(weapon, build)
  local lines = {
    string.format("**%s** - %s", weapon.name or "Weapon", (build and build.playstyle) or weapon.build or "Build"),
  }
  for _, attachment in ipairs(build and build.attachments or {}) do
    lines[#lines + 1] = string.format("- [%s] %s", attachment_abbr(attachment), attachment.name or "")
  end
  lines[#lines + 1] = "`" .. ((build and build.code) or weapon.code or "no code") .. "`"
  return table.concat(lines, "\n")
end

local function csv_format(weapon, build)
  local names = {}
  for _, attachment in ipairs(build and build.attachments or {}) do
    names[#names + 1] = attachment.name or ""
  end
  return table.concat({
    csv_escape(weapon.name),
    csv_escape((build and build.playstyle) or weapon.build),
    csv_escape((build and build.code) or weapon.code),
    csv_escape(table.concat(names, " | ")),
  }, ",")
end

compare_summary_text = function()
  if not state.compare_a or not state.compare_b then
    return nil
  end
  local a_build = state.compare_a_build or primary_build(state.compare_a)
  local b_build = state.compare_b_build or primary_build(state.compare_b)
  return table.concat({
    "A: " .. short_format(state.compare_a, a_build),
    "B: " .. short_format(state.compare_b, b_build),
  }, "\n")
end

local function show_copy_formats()
  local build, weapon = active_build()
  if not weapon then
    notify("Open the meta menu first", { title = "Copy formats", duration = 2500 })
    return
  end
  local items = {
    { label = "Code only", hint = build and build.code or "no code" },
    { label = "Short line", hint = "Weapon - build - code" },
    { label = "Discord format", hint = "bold name + attachments + code" },
    { label = "CSV row", hint = "spreadsheet-friendly" },
  }
  local menu, why = open_overlay_menu(items, {
    title = "Copy formats  |  " .. weapon.name,
    subtitle = "Choose the clipboard format",
    width = 620,
    theme = "tokyo-night",
    on_select = function(index)
      if index == 1 then
        copy_text_async(build and build.code or weapon.code or "", weapon.name, "Code copied")
      elseif index == 2 then
        copy_text_async(short_format(weapon, build), weapon.name, "Short line copied")
      elseif index == 3 then
        copy_text_async(discord_format(weapon, build), weapon.name, "Discord format copied")
      elseif index == 4 then
        copy_text_async(csv_format(weapon, build), weapon.name, "CSV row copied")
      end
    end,
    on_close = function()
      state.menu = nil
    end,
  })
  if menu then
    state.menu = menu
  else
    notify("Could not open copy formats: " .. tostring(why), { title = "Copy formats", duration = 3000 })
  end
end

local function top_names(items, count)
  local parts = {}
  for index = 1, math.min(count, #items) do
    local item = items[index]
    parts[#parts + 1] = "#" .. (tonumber(item.rank) or index) .. " " .. tostring(item.name or "?")
  end
  return table.concat(parts, "  |  ")
end

local function show_history()
  local items = {}
  if #state.items > 0 then
    items[#items + 1] = {
      label = "Current  |  " .. (state.week ~= "" and state.week or "current"),
      hint = top_names(state.items, 3),
    }
  end
  for _, snapshot in ipairs(state.history) do
    items[#items + 1] = {
      label = tostring(snapshot.week or "previous week"),
      hint = top_names(snapshot.items or {}, 3),
    }
  end
  if #items == 0 then
    notify("No history yet", { title = "Meta history", duration = 2500 })
    return
  end
  local menu, why = open_overlay_menu(items, {
    title = "Meta history",
    subtitle = "Newest first  |  history grows after each new weekly snapshot",
    width = 720,
    theme = "tokyo-night",
    on_select = function()
    end,
    on_close = function()
      state.menu = nil
    end,
  })
  if menu then
    state.menu = menu
  else
    notify("Could not open history: " .. tostring(why), { title = "Meta history", duration = 3000 })
  end
end

local function show_clipboard_history()
  if #state.user.clipboard_history == 0 then
    notify("Nothing copied yet", { title = "Clipboard history", duration = 2500 })
    return
  end
  local items = {}
  local mapping = {}
  for _, entry in ipairs(state.user.clipboard_history) do
    local preview = tostring(entry.text or ""):gsub("\n", " / ")
    items[#items + 1] = {
      label = tostring(entry.label or "Copied"),
      hint = fit(preview, 58),
    }
    mapping[#mapping + 1] = entry
  end
  local menu, why = open_overlay_menu(items, {
    title = "Clipboard history",
    subtitle = "Enter copies the selected entry again",
    width = 720,
    theme = "tokyo-night",
    on_select = function(index)
      local entry = mapping[index]
      if entry then
        copy_text_async(entry.text, entry.label or "Clipboard history", "Copied again")
      end
    end,
    on_close = function()
      state.menu = nil
    end,
  })
  if menu then
    state.menu = menu
  else
    notify("Could not open clipboard history: " .. tostring(why), { title = "Clipboard", duration = 3000 })
  end
end

local function show_favorite_builds()
  local list = favorite_builds_list(state.game_key)
  if #list == 0 then
    notify("No favorite builds yet", { title = "Favorite builds", duration = 2500 })
    return
  end
  local items = {}
  local mapping = {}
  for _, entry in ipairs(list) do
    if entry.weapon and entry.build then
      items[#items + 1] = {
        label = tostring(entry.weapon.name or "Weapon") .. "  |  " .. tostring(entry.build.playstyle or "Build"),
        hint = tostring(entry.build.code or ""),
      }
      mapping[#mapping + 1] = entry
    end
  end
  local menu, why = open_overlay_menu(items, {
    title = "Favorite builds",
    subtitle = "Enter loads this weapon and build",
    width = 720,
    theme = "tokyo-night",
    on_select = function(index)
      local entry = mapping[index]
      if entry then
        state.last = entry.weapon
        state.last_build = entry.build
        add_recent(entry.weapon)
        show_detail(entry.weapon)
      end
    end,
    on_close = function()
      state.menu = nil
    end,
  })
  if menu then
    state.menu = menu
  else
    notify("Could not open favorite builds: " .. tostring(why), { title = "Favorite builds", duration = 3000 })
  end
end

local function show_tags_menu()
  local weapon = active_weapon()
  if not weapon then
    notify("Open the meta menu first", { title = "Tags", duration = 2500 })
    return
  end
  local available = { "Meta", "Tested", "Ranked", "Fun", "Laser", "Off-meta" }
  local items = {}
  for _, tag in ipairs(available) do
    items[#items + 1] = {
      label = (has_tag(weapon, tag) and "[x] " or "[ ] ") .. tag,
      hint = has_tag(weapon, tag) and "on" or "off",
    }
  end
  local menu, why = open_overlay_menu(items, {
    title = "Tags  |  " .. weapon.name,
    subtitle = "Enter toggles a tag for this weapon",
    width = 520,
    theme = "tokyo-night",
    on_select = function(index)
      local tag = available[index]
      if tag then
        local on = toggle_tag(weapon, tag)
        notify(tag .. (on and " added" or " removed"), { title = weapon.name, duration = 2000 })
      end
    end,
    on_close = function()
      state.menu = nil
    end,
  })
  if menu then
    state.menu = menu
  else
    notify("Could not open tags: " .. tostring(why), { title = "Tags", duration = 3000 })
  end
end

local function plan_hint(plan, slot)
  local entry = plan[slot]
  if entry and entry.weapon and entry.build then
    return string.format("%s  |  %s", entry.weapon.name, entry.build.playstyle or "Build")
  end
  return "not set"
end

local function copy_plan_codes()
  local plan = plan_table(state.game_key)
  local lines = {}
  for _, slot in ipairs({ "primary", "secondary", "backup" }) do
    local entry = plan[slot]
    if entry and entry.weapon and entry.build then
      lines[#lines + 1] = string.format("%s: %s - %s - %s",
        string.upper(slot),
        entry.weapon.name or "Weapon",
        entry.build.playstyle or "Build",
        entry.build.code or "no code")
    end
  end
  if #lines == 0 then
    notify("Loadout plan is empty", { title = "Plan", duration = 2500 })
    return
  end
  copy_text_async(table.concat(lines, "\n"), "Loadout plan", "Plan codes copied")
end

local function show_plan_menu()
  local build, weapon = active_build()
  local plan = plan_table(state.game_key)
  local items = {
    { label = "Set primary", hint = plan_hint(plan, "primary") },
    { label = "Set secondary", hint = plan_hint(plan, "secondary") },
    { label = "Set backup", hint = plan_hint(plan, "backup") },
    { label = "Copy plan codes", hint = "primary + secondary + backup" },
    { label = "Clear plan", hint = "remove all three" },
  }
  local menu, why = open_overlay_menu(items, {
    title = "Loadout plan",
    subtitle = weapon and ("Current: " .. weapon.name .. " | " .. tostring(build and build.playstyle or "Build")) or "No current weapon",
    width = 660,
    theme = "tokyo-night",
    on_select = function(index)
      if index <= 3 and weapon and build then
        local slot = ({ "primary", "secondary", "backup" })[index]
        set_plan_slot(slot, weapon, build)
        notify(string.upper(slot) .. " set", { title = weapon.name, duration = 2200 })
      elseif index == 4 then
        copy_plan_codes()
      elseif index == 5 then
        clear_plan()
        notify("Plan cleared", { title = "Loadout plan", duration = 2200 })
      end
    end,
    on_close = function()
      state.menu = nil
    end,
  })
  if menu then
    state.menu = menu
  else
    notify("Could not open loadout plan: " .. tostring(why), { title = "Plan", duration = 3000 })
  end
end

local function show_build_duel()
  local weapon = active_weapon()
  if not weapon then
    notify("Open the meta menu first", { title = "Build duel", duration = 2500 })
    return
  end
  local builds = weapon.builds or {}
  if #builds < 2 then
    notify("This weapon has only one build", { title = weapon.name, duration = 3000 })
    return
  end
  local first = current_build(weapon) or builds[1]
  local second = nil
  for _, build in ipairs(builds) do
    if build.code ~= first.code then
      second = build
      break
    end
  end
  if not second then
    notify("No second build to compare", { title = weapon.name, duration = 3000 })
    return
  end
  state.last = weapon
  state.last_build = first
  show_compare(weapon, weapon, first, second)
end

local function show_top3_compare()
  if #state.items < 2 then
    notify("Need at least two weapons", { title = "Top 3 compare", duration = 2500 })
    return
  end
  local markers = { "A", "B", "C" }
  local items = {}
  for index = 1, math.min(3, #state.items) do
    local weapon = state.items[index]
    local build = current_build(weapon) or primary_build(weapon)
    items[#items + 1] = {
      label = string.format("%s  #%d  %s", markers[index], tonumber(weapon.rank) or index, fit(weapon.name, 26)),
      hint = string.format("%s  |  %s  |  %s",
        (build and build.playstyle) or weapon.build or "Build",
        (build and build.code) or weapon.code or "no code",
        weapon.ttk ~= "" and weapon.ttk or "no TTK data"),
    }
  end
  local menu, why = open_overlay_menu(items, {
    title = "Top 3 compare",
    subtitle = "Compact codes and TTK  |  use F4 for a full two-way comparison",
    width = 820,
    theme = "tokyo-night",
    on_select = function()
    end,
    on_close = function()
      state.menu = nil
    end,
  })
  if menu then
    state.menu = menu
  else
    notify("Could not open top 3: " .. tostring(why), { title = "Top 3 compare", duration = 3000 })
  end
end

local function show_why()
  local build, weapon = active_build()
  if not weapon or not build then
    notify("Open the meta menu first", { title = "Why this build", duration = 2500 })
    return
  end
  local max_rating = 0
  for _, candidate in ipairs(weapon.builds or {}) do
    max_rating = math.max(max_rating, tonumber(candidate.rating or 0) or 0)
  end
  local rating = tonumber(build.rating or 0) or 0
  local rating_hint = string.format("%.2f", rating)
  if rating > 0 and rating >= max_rating then
    rating_hint = rating_hint .. "  |  highest-rated build"
  elseif max_rating > 0 then
    rating_hint = rating_hint .. string.format("  |  %.2f below top", max_rating - rating)
  end
  local issues = build_issues(build)
  local history = rank_history_text(weapon)
  local items = {
    { label = "Selected build", hint = (build.playstyle or "Build") .. "  |  " .. rating_hint },
    { label = "Attachment check", hint = #issues == 0 and "no obvious issues" or table.concat(issues, ", ") },
    { label = "Rank history", hint = history ~= "" and history or "starts after the next weekly snapshot" },
    { label = "Alternatives", hint = type(weapon.alternatives) == "table" and #weapon.alternatives > 0 and table.concat(weapon.alternatives, ", ") or "none listed" },
    { label = "Source note", hint = "derived from CODMunity page metadata, not editorial reasoning" },
  }
  local menu, why = open_overlay_menu(items, {
    title = "Why this build?  |  " .. weapon.name,
    subtitle = "Metadata-derived summary",
    width = 720,
    theme = "tokyo-night",
    on_select = function()
    end,
    on_close = function()
      state.menu = nil
    end,
  })
  if menu then
    state.menu = menu
  else
    notify("Could not open summary: " .. tostring(why), { title = "Why this build", duration = 3000 })
  end
end

local function random_meta_pick()
  if #state.items == 0 then
    notify("No meta data yet", { title = "Random pick", duration = 2500 })
    return
  end
  local weapon = state.items[math.random(1, #state.items)]
  select_weapon(weapon)
  notify("Random pick: " .. weapon.name, { title = state.game.label, duration = 3000 })
end

local function export_setup()
  local payload = {
    version = 1,
    exported_at = os.time(),
    user = state.user,
  }
  local ok, err = pcall(rb.file.write_json, "meta_overlay_setup.json", payload)
  if not ok then
    notify("Export failed: " .. tostring(err), { title = "Setup export", duration = 4000 })
    return
  end
  notify("Saved meta_overlay_setup.json", { title = "Setup exported", duration = 3500 })
end

local function import_setup()
  if not rb.file.exists("meta_overlay_setup.json") then
    notify("meta_overlay_setup.json not found", { title = "Setup import", duration = 3500 })
    return
  end
  local ok, data = pcall(rb.file.read_json, "meta_overlay_setup.json")
  if not ok or type(data) ~= "table" then
    notify("Could not read setup file", { title = "Setup import", duration = 3500 })
    return
  end
  local imported = data.user or data
  if type(imported) ~= "table" then
    notify("Setup file has no user data", { title = "Setup import", duration = 3500 })
    return
  end
  local fields = {
    "favorites", "recent", "hud", "pins", "favorite_builds",
    "tags", "plan", "clipboard_history", "search_recent",
  }
  local count = 0
  for _, key in ipairs(fields) do
    if type(imported[key]) == "table" then
      state.user[key] = imported[key]
      count = count + 1
    end
  end
  save_user_state()
  notify("Imported " .. count .. " setup sections", { title = "Setup imported", duration = 3500 })
end

local function close_help()
  if state.help_handler then
    pcall(function()
      state.help_handler:stop()
    end)
    state.help_handler = nil
  end
  remove_surface(state.help_surface)
  state.help_surface = nil
end

local function show_help()
  apply_theme()
  if state.help_surface then
    close_help()
    return
  end
  remove_compare()
  if state.menu then
    pcall(function()
      state.menu:close()
    end)
    state.menu = nil
  end
  if state.search then
    close_search()
  end

  local width = 780
  local pad = 18
  local ops = {
    { kind = "rect", x = 0, y = 0, w = width, h = 560, fill = THEME.surface,
      border = THEME.border, border_width = 1, radius = 10, shadow = 0.45 },
  }
  local y = 16
  local function add_text(size, text, color, bold)
    ops[#ops + 1] = {
      kind = "text",
      x = pad,
      y = y,
      size = size,
      text = tostring(text or ""),
      color = color,
      bold = bold or false,
    }
    y = y + math.max(size + 6, 20)
  end

  add_text(20, "HELP / HOTKEYS", THEME.accent, true)
  add_text(10, "Keyboard-only overlay. F1 closes this page.", THEME.faint, false)
  add_text(12, "META MENU", THEME.text, true)
  add_text(11, "F8 open/close   |   Up/Down move   |   Enter or 1-9 select   |   Esc close", THEME.dim, false)
  add_text(11, "F7 refresh   |   F5 favorite weapon   |   F11 extras", THEME.dim, false)
  add_text(12, "SEARCH", THEME.text, true)
  add_text(11, "F2 open   |   type to filter   |   Backspace edit   |   Up/Down select   |   Enter load", THEME.dim, false)
  add_text(12, "COMPARE", THEME.text, true)
  add_text(11, "F4 pick/change opponent   |   F6 actions and switch builds", THEME.dim, false)
  add_text(11, "F9 copy A full loadout   |   F10 copy B full loadout   |   Esc close   |   F8 menu", THEME.dim, false)
  add_text(12, "BUILDS / SAVED", THEME.text, true)
  add_text(11, "F6 build picker   |   Extras: pin build, favorite build, tags, plan", THEME.dim, false)
  add_text(11, "Extras: history, build duel, clipboard history, copy formats, export/import", THEME.dim, false)
  add_text(12, "HUD / STYLE", THEME.text, true)
  add_text(11, "F3 toggle HUD   |   Options: theme, HUD style, position, size, search scope", THEME.dim, false)
  add_text(10, "CODMunity data is attribution in the README; copied loadouts stay clean.", THEME.faint, false)

  ops[1].h = y + 16
  local ok, err = pcall(function()
    state.help_surface = rb.overlay.surface({
      capturable = cfg.capturable,
      anchor = "center",
      width = width,
      height = ops[1].h,
      opacity = 0.99,
      ops = ops,
    })
  end)
  if not ok then
    rb.log.warn("CODMunity help surface failed: " .. tostring(err))
    return
  end
  state.help_handler = rb.on("down", function(key)
    if key == "Escape" or key == cfg.help_key then
      rb.after(0, close_help)
      return false
    end
    return true
  end)
end

local function open_extras()
  apply_theme()
  if sync_game then
    sync_game(false)
  end
  if state.search then
    close_search()
  end
  close_help()
  remove_compare()
  if state.menu then
    pcall(function()
      state.menu:close()
    end)
    state.menu = nil
  end

  local build, weapon = active_build()
  local tags = weapon and tag_list(weapon) or {}
  local pin = weapon and pinned_build(weapon) or nil
  local items = {
    { label = "Help / hotkeys", hint = "F1" },
    { label = "Meta history", hint = #state.history .. " previous week(s)" },
    { label = "Build duel", hint = weapon and weapon.name or "select a weapon" },
    { label = "Loadout plan", hint = "primary / secondary / backup" },
    { label = "Clipboard history", hint = #state.user.clipboard_history .. " item(s)" },
    { label = "Favorite builds", hint = #favorite_builds_list(state.game_key) .. " saved" },
    { label = "Pin current build", hint = build and (build.playstyle or "Build") or "no build" },
    { label = "Clear pin", hint = pin and (pin.playstyle or "set") or "none" },
    { label = "Favorite current build", hint = build and (build.code or "") or "no build" },
    { label = "Tags", hint = #tags > 0 and table.concat(tags, ", ") or "none" },
    { label = "Why this build?", hint = weapon and weapon.name or "select a weapon" },
    { label = "Random meta pick", hint = "roll the top 10" },
    { label = "Copy formats", hint = "code / short / Discord / CSV" },
    { label = "Export setup", hint = "meta_overlay_setup.json" },
    { label = "Import setup", hint = "replace saved setup" },
    { label = "Top 3 compare", hint = "compact A/B/C codes and TTK" },
  }
  local menu, why = open_overlay_menu(items, {
    title = "Extras",
    subtitle = weapon and ("Current: " .. weapon.name .. " | " .. tostring(build and build.playstyle or "Build")) or "No current weapon",
    width = 700,
    theme = "tokyo-night",
    on_select = function(index)
      if index == 1 then
        rb.after(0, show_help)
      elseif index == 2 then
        rb.after(0, show_history)
      elseif index == 3 then
        rb.after(0, show_build_duel)
      elseif index == 4 then
        rb.after(0, show_plan_menu)
      elseif index == 5 then
        rb.after(0, show_clipboard_history)
      elseif index == 6 then
        rb.after(0, show_favorite_builds)
      elseif index == 7 then
        if weapon and build then
          set_pinned_build(weapon, build)
          notify("Pinned " .. (build.playstyle or "build"), { title = weapon.name, duration = 2500 })
        else
          notify("Select a weapon first", { title = "Pin build", duration = 2500 })
        end
      elseif index == 8 then
        if weapon then
          clear_pinned_build(weapon)
          notify("Pin cleared", { title = weapon.name, duration = 2500 })
        end
      elseif index == 9 then
        if weapon and build then
          local added = toggle_favorite_build(weapon, build)
          notify(added and "Build favorited" or "Build unfavorited", { title = weapon.name, duration = 2500 })
        else
          notify("Select a weapon first", { title = "Favorite build", duration = 2500 })
        end
      elseif index == 10 then
        rb.after(0, show_tags_menu)
      elseif index == 11 then
        rb.after(0, show_why)
      elseif index == 12 then
        rb.after(0, random_meta_pick)
      elseif index == 13 then
        rb.after(0, show_copy_formats)
      elseif index == 14 then
        export_setup()
      elseif index == 15 then
        import_setup()
      elseif index == 16 then
        rb.after(0, show_top3_compare)
      end
    end,
    on_close = function()
      state.menu = nil
    end,
  })
  if menu then
    state.menu = menu
  else
    notify("Could not open extras: " .. tostring(why), { title = "Extras", duration = 3000 })
  end
end

local last_hud_sig = nil

local function hud_settings_signature()
  return table.concat({
    tostring(cfg.hud_mode or "full"),
    tostring(cfg.hud_position or "top-left"),
    tostring(cfg.hud_scale or "normal"),
    tostring(cfg.theme or "default"),
    tostring(cfg.capturable),
  }, "|")
end

local function render_hud()
  apply_theme()
  last_hud_sig = hud_settings_signature()
  remove_surface(state.hud_surface)
  state.hud_surface = nil
  local mode = tostring(cfg.hud_mode or "full")
  if not hud_enabled(state.game_key) or #state.items == 0 or mode == "off" then
    return
  end

  local scale = 1
  if cfg.hud_scale == "small" then
    scale = 0.9
  elseif cfg.hud_scale == "large" then
    scale = 1.15
  end
  local row_count = math.min(3, #state.items)
  local base_width = mode == "compact" and 560 or (mode == "codes" and 340 or 390)
  local width = math.floor(base_width * scale)
  local height = mode == "compact"
    and math.floor(48 * scale)
    or (math.floor(34 * scale) + row_count * math.floor(20 * scale))
  local ops = {
    { kind = "rect", x = 0, y = 0, w = width, h = height, fill = THEME.surface,
      border = THEME.border, border_width = 1, radius = 8, shadow = 0.35 },
  }
  local function add_text(x, y, size, text, color, bold)
    ops[#ops + 1] = {
      kind = "text",
      x = x,
      y = y,
      size = math.max(8, math.floor(size * scale)),
      text = tostring(text or ""),
      color = color,
      bold = bold or false,
    }
  end

  add_text(12, 8, 10, state.game.title .. "  |  " .. (state.week ~= "" and state.week or ""), THEME.faint, false)
  if mode == "compact" then
    local names = {}
    for index = 1, row_count do
      names[#names + 1] = "#" .. (tonumber(state.items[index].rank) or index) .. " " .. fit(state.items[index].name, 18)
    end
    add_text(12, 26, 12, table.concat(names, "   "), THEME.accent, true)
  elseif mode == "codes" then
    local y = 26
    for index = 1, row_count do
      local weapon = state.items[index]
      local build = current_build(weapon) or primary_build(weapon)
      local code = build and build.code or weapon.code or "-"
      add_text(12, y, 11, "#" .. (tonumber(weapon.rank) or index) .. "  " .. fit(code, 24), index == 1 and THEME.accent or THEME.dim, index == 1)
      y = y + math.floor(18 * scale)
    end
  else
    local y = 26
    for index = 1, row_count do
      local weapon = state.items[index]
      local hint = weapon_hint(weapon)
      add_text(12, y, 12, string.format("%d  %s", tonumber(weapon.rank) or index, fit(weapon.name, 22)), index == 1 and THEME.accent or THEME.text, index == 1)
      add_text(width - 114, y, 10, fit(hint, 16), THEME.dim, false)
      y = y + math.floor(20 * scale)
    end
  end

  local anchor = tostring(cfg.hud_position or "top-left")
  local ok, err = pcall(function()
    state.hud_surface = rb.overlay.surface({
      capturable = cfg.capturable,
      anchor = anchor,
      width = width,
      height = height,
      offset_x = 24,
      offset_y = 24,
      opacity = 0.92,
      ops = ops,
    })
  end)
  if not ok then
    rb.log.warn("CODMunity HUD surface failed: " .. tostring(err))
  end
end

rb.timer.every(250, function()
  if hud_settings_signature() ~= last_hud_sig then
    render_hud()
  end
end)

local function toggle_hud()
  if sync_game then
    sync_game(false)
  end
  if state.search then
    close_search()
  end
  local enabled = not hud_enabled(state.game_key)
  set_hud_enabled(state.game_key, enabled)
  render_hud()
  if cfg.hud_mode == "off" then
    notify("HUD style is off in Options", { title = state.game.label, duration = 3000 })
  else
    notify(enabled and "Top-3 HUD on" or "Top-3 HUD off", { title = state.game.label, duration = 2500 })
  end
end

local function compute_changes(current, previous)
  local changes = {}
  if type(previous) ~= "table" or #previous == 0 then
    return changes
  end

  local old_by_key = {}
  for _, weapon in ipairs(previous) do
    old_by_key[weapon.url or weapon.name] = weapon
  end
  local new_by_key = {}
  for _, weapon in ipairs(current) do
    new_by_key[weapon.url or weapon.name] = weapon
  end

  for _, weapon in ipairs(current) do
    local key = weapon.url or weapon.name
    local old = old_by_key[key]
    if not old then
      changes[#changes + 1] = { kind = "new", text = "NEW   " .. weapon.name .. "   #" .. (weapon.rank or "?") }
    else
      local old_rank = tonumber(old.rank)
      local new_rank = tonumber(weapon.rank)
      if old_rank and new_rank and old_rank ~= new_rank then
        changes[#changes + 1] = {
          kind = new_rank < old_rank and "up" or "down",
          text = string.format("%s   %s   #%d -> #%d", new_rank < old_rank and "UP  " or "DOWN", weapon.name, old_rank, new_rank),
        }
      end
      if old.tier and weapon.tier and old.tier ~= "" and weapon.tier ~= "" and old.tier ~= weapon.tier then
        changes[#changes + 1] = {
          kind = "tier",
          text = "TIER  " .. weapon.name .. "   " .. old.tier .. " -> " .. weapon.tier,
        }
      end
      local old_pick = pick_value(old)
      local new_pick = pick_value(weapon)
      if old.pick_rate and weapon.pick_rate and math.abs(new_pick - old_pick) >= 0.5 then
        changes[#changes + 1] = {
          kind = "pick",
          text = string.format("PICK  %s   %s -> %s", weapon.name, old.pick_rate, weapon.pick_rate),
        }
      end
    end
  end

  for _, old in ipairs(previous) do
    if not new_by_key[old.url or old.name] then
      changes[#changes + 1] = { kind = "out", text = "OUT   " .. old.name }
    end
  end
  return changes
end

local function watchlist_alerts(items, previous_items, game_key)
  local alerts = {}
  local previous = {}
  for _, weapon in ipairs(previous_items or {}) do
    previous[weapon.url or weapon.name] = weapon
  end
  local current = {}
  for _, weapon in ipairs(items or {}) do
    current[weapon.url or weapon.name] = weapon
  end
  local favorites = state.user.favorites[game_key] or {}
  for _, favorite in ipairs(favorites) do
    local key = favorite.url or favorite.name
    local old = previous[key]
    local new = current[key]
    if old and not new then
      alerts[#alerts + 1] = "Dropped: " .. tostring(favorite.name)
    elseif old and new then
      if old.tier and new.tier and old.tier ~= "" and new.tier ~= "" and old.tier ~= new.tier then
        alerts[#alerts + 1] = string.format("%s: %s -> %s", new.name, old.tier, new.tier)
      elseif tonumber(old.rank) and tonumber(new.rank) and math.abs(old.rank - new.rank) >= 2 then
        alerts[#alerts + 1] = string.format("%s: #%d -> #%d", new.name, old.rank, new.rank)
      end
    end
    if #alerts >= 3 then
      break
    end
  end
  return alerts
end

local function show_changes()
  apply_theme()
  remove_surface(state.changes_surface)
  state.changes_surface = nil
  if state.previous_week == "" or #state.previous_items == 0 then
    notify("No previous weekly snapshot yet", { title = "What changed", duration = 3000 })
    return
  end

  local changes = compute_changes(state.items, state.previous_items)
  local width = 620
  local lines = math.max(1, math.min(#changes, 16))
  local height = 92 + lines * 20
  local ops = {
    { kind = "rect", x = 0, y = 0, w = width, h = height, fill = THEME.surface,
      border = THEME.border, border_width = 1, radius = 10, shadow = 0.45 },
  }
  local y = 14
  local function add_text(size, text, color, bold)
    ops[#ops + 1] = {
      kind = "text",
      x = 16,
      y = y,
      size = size,
      text = tostring(text or ""),
      color = color,
      bold = bold or false,
    }
    y = y + 20
  end

  add_text(18, "WEEKLY CHANGES", THEME.accent, true)
  add_text(10, state.previous_week .. "  ->  " .. (state.week ~= "" and state.week or "current"), THEME.faint, false)
  if #changes == 0 then
    add_text(12, "No top-10 changes in this snapshot", THEME.dim, false)
  else
    for index = 1, math.min(#changes, 16) do
      local change = changes[index]
      local color = THEME.dim
      if change.kind == "new" or change.kind == "up" then
        color = THEME.positive
      elseif change.kind == "out" or change.kind == "down" then
        color = THEME.danger
      elseif change.kind == "tier" then
        color = THEME.accent
      end
      add_text(11, change.text, color, false)
    end
  end
  add_text(10, "F8 close  |  " .. SOURCE, THEME.faint, false)
  ops[1].h = y + 12

  local ok, err = pcall(function()
    state.changes_surface = rb.overlay.surface({
      capturable = cfg.capturable,
      anchor = "center",
      width = width,
      height = ops[1].h,
      opacity = 0.98,
      ops = ops,
    })
  end)
  if not ok then
    rb.log.warn("CODMunity changes surface failed: " .. tostring(err))
  end
end

local function weapon_database_list(blocks)
  for _, block in ipairs(blocks) do
    if block["@type"] == "ItemList" and type(block.itemListElement) == "table" and #block.itemListElement > 0 then
      return block
    end
  end
  return nil
end

local function weapon_database_records(html)
  local items = {}
  for name, category, slug, prefix in tostring(html or ""):gmatch('WeaponName:"([^"]+)",Category:"([^"]+)",Icon:"[^"]*",slug:"([^"]+)",game:"([^"]+)"') do
    if name ~= "" and slug ~= "" and prefix ~= "" then
      items[#items + 1] = {
        name = name,
        category = category,
        url = "https://codmunity.gg/weapon/" .. prefix .. "/" .. slug,
        prefix = prefix,
      }
    end
  end
  return items
end

local function weapon_database_links(html)
  local items = {}
  for href in tostring(html or ""):gmatch('href="([^"]*/weapon/[^"]+)"') do
    local prefix, slug = href:match("/weapon/([^/]+)/([^/?#]+)")
    if prefix and slug then
      local name = slug:gsub("%-", " ")
      if #name > 0 then
        local url = href:match("^https?://") and href or ("https://codmunity.gg" .. href)
        items[#items + 1] = { name = name, url = url, prefix = prefix }
      end
    end
  end
  return items
end

local function read_catalog()
  local ok, data = pcall(require, "./weapon_catalog.luau")
  if not ok or type(data) ~= "table" then
    rb.log.warn("CODMunity weapon catalogue missing or invalid")
    return {}
  end
  return data
end

local function load_index()
  local items = {}
  local seen = {}
  local function add(entry)
    if type(entry) ~= "table" then
      return
    end
    local url = tostring(entry.url or "")
    local name = tostring(entry.name or "")
    if url == "" or name == "" or seen[url] then
      return
    end
    seen[url] = true
    items[#items + 1] = {
      name = name,
      url = url,
      prefix = tostring(entry.prefix or url:match("/weapon/([^/]+)/") or "cod"),
      category = tostring(entry.category or ""),
    }
  end

  if rb.file.exists(INDEX_FILE) then
    local ok, data = pcall(rb.file.read_json, INDEX_FILE)
    if ok and type(data) == "table" and type(data.items) == "table" then
      for _, entry in ipairs(data.items) do
        add(entry)
      end
      state.index_updated_at = tonumber(data.updated_at) or 0
    end
  end
  local catalog = read_catalog()
  for _, entry in ipairs(catalog) do
    add(entry)
  end
  state.index = items
  if #items > 0 then
    rb.log.info("CODMunity weapon index loaded: " .. #items .. " entries")
  end
end

local function refresh_index()
  if state.index_refreshing then
    return
  end
  state.index_refreshing = true
  rb.run(function()
    local ok, err = pcall(function()
      local html = http_get("https://codmunity.gg/database/weapons")
      local records = weapon_database_records(html)
      local _, href_count = html:gsub("/weapon/", "")
      rb.log.info("CODMunity weapon page bytes=" .. #html .. " hrefs=" .. href_count .. " records=" .. #records)
      local list = weapon_database_list(parse_jsonld(html))
      local items = {}
      local seen = {}
      for _, entry in ipairs(records) do
        if type(entry) == "table" and entry.url and entry.name and not seen[entry.url] then
          local url = tostring(entry.url)
          seen[url] = true
          items[#items + 1] = {
            name = tostring(entry.name),
            url = url,
            prefix = tostring(entry.prefix or url:match("/weapon/([^/]+)/") or "cod"),
            category = tostring(entry.category or ""),
          }
        end
      end
      for _, entry in ipairs(state.index or {}) do
        if type(entry) == "table" and entry.url and entry.name and not seen[tostring(entry.url)] then
          local url = tostring(entry.url)
          seen[url] = true
          items[#items + 1] = {
            name = tostring(entry.name),
            url = url,
            prefix = tostring(entry.prefix or url:match("/weapon/([^/]+)/") or "cod"),
            category = tostring(entry.category or ""),
          }
        end
      end
      local cached_count = #items
      if list then
        for _, entry in ipairs(list.itemListElement) do
          if type(entry) == "table" and entry.name and entry.url and not seen[tostring(entry.url)] then
            local prefix = tostring(entry.url):match("/weapon/([^/]+)/") or "cod"
            local url = tostring(entry.url)
            seen[url] = true
            items[#items + 1] = { name = tostring(entry.name), url = url, prefix = prefix }
          end
        end
      end
      for _, entry in ipairs(weapon_database_links(html)) do
        if not seen[entry.url] then
          seen[entry.url] = true
          items[#items + 1] = entry
        end
      end
      if #items == 0 then
        error("weapon database item list missing")
      end
      if #items < cached_count then
        error("weapon database refresh shrank from " .. cached_count .. " to " .. #items)
      end
      state.index = items
      index_cache = nil
      state.index_updated_at = os.time()
      local payload = {
        version = 1,
        updated_at = state.index_updated_at,
        items = items,
      }
      local write_ok, write_err = pcall(rb.file.write_json, INDEX_FILE, payload)
      if not write_ok then
        rb.log.warn("CODMunity weapon index write failed: " .. tostring(write_err))
      end
      rb.log.info("CODMunity weapon index updated: " .. #items .. " entries")
    end)
    if not ok then
      rb.log.warn("CODMunity weapon index failed: " .. tostring(err))
    end
    state.index_refreshing = false
  end)
end

local function ensure_index()
  if #state.index == 0 or os.time() - state.index_updated_at > 86400 then
    refresh_index()
  end
end

local function preferred_prefix_rank(prefix)
  for index, candidate in ipairs(state.game.prefixes or {}) do
    if candidate == prefix then
      return index
    end
  end
  return 99
end

local function top_weapon_by_url(url)
  for _, weapon in ipairs(state.items) do
    if weapon.url == url then
      return weapon
    end
  end
  return nil
end

local function fuzzy_match_score(text, query)
  local cursor = 1
  local gaps = 0
  for index = 1, #query do
    local found = text:find(query:sub(index, index), cursor, true)
    if not found then
      return nil
    end
    gaps = gaps + math.max(0, found - cursor)
    cursor = found + 1
  end
  return 40 - math.min(30, gaps)
end

local function search_matches()
  if state.search == nil then
    return {}
  end
  local query = trim(state.search.query):lower()
  if query == "" then
    local results = {}
    for _, weapon in ipairs(state.items) do
      results[#results + 1] = {
        name = weapon.name,
        url = weapon.url,
        prefix = tostring(weapon.url):match("/weapon/([^/]+)/") or "cod",
        in_top = true,
      }
    end
    return results
  end

  local results = {}
  for _, entry in ipairs(state.index) do
    local name = tostring(entry.name or "")
    local name_lower = name:lower()
    local prefix = tostring(entry.prefix or "")
    local prefix_rank = preferred_prefix_rank(prefix)
    local allowed = cfg.search_scope ~= "game" or prefix_rank < 99
    if allowed then
      local score = nil
      local substring_at = name_lower:find(query, 1, true)
      if substring_at then
        score = 0
        if name_lower == query then
          score = score + 100
        elseif name_lower:sub(1, #query) == query then
          score = score + 50
        else
          score = score + 25
        end
      else
        score = fuzzy_match_score(name_lower, query)
      end
      if score then
        local in_top = top_weapon_by_url(entry.url) ~= nil
        if in_top then
          score = score + 20
        end
        score = score + math.max(0, 10 - prefix_rank)
        results[#results + 1] = {
          name = name,
          url = entry.url,
          prefix = prefix ~= "" and prefix or "cod",
          in_top = in_top,
          score = score,
        }
      end
    end
  end
  table.sort(results, function(a, b)
    if a.score == b.score then
      return a.name < b.name
    end
    return a.score > b.score
  end)
  return results
end

local function render_search()
  if state.search == nil then
    return
  end
  remove_surface(state.search.surface)
  state.search.surface = nil

  local results = search_matches()
  state.search.results = results
  if #results == 0 then
    state.search.selected = 1
  elseif state.search.selected > #results then
    state.search.selected = #results
  end

  local width = 640
  local visible = math.min(8, #results)
  local height = 118 + math.max(1, visible) * 22
  local ops = {
    { kind = "rect", x = 0, y = 0, w = width, h = height, fill = THEME.surface,
      border = THEME.border, border_width = 1, radius = 10, shadow = 0.45 },
  }
  local function add_text(x, y, size, text, color, bold)
    ops[#ops + 1] = {
      kind = "text",
      x = x,
      y = y,
      size = size,
      text = tostring(text or ""),
      color = color,
      bold = bold or false,
    }
  end

  add_text(16, 12, 18, "SEARCH WEAPONS", THEME.accent, true)
  add_text(16, 38, 10, "Index " .. #state.index .. "  |  " .. state.game.label .. " preferred  |  Esc close", THEME.faint, false)
  local query_text = state.search.query ~= "" and state.search.query or "type a weapon name"
  add_text(16, 58, 15, "> " .. query_text, state.search.query ~= "" and THEME.text or THEME.faint, true)

  local list_y = 88
  if #results == 0 then
    add_text(16, list_y, 12, #state.index == 0 and "Weapon index loading..." or "No matches", THEME.dim, false)
  else
    for index = 1, visible do
      local entry = results[index]
      if index == state.search.selected then
        ops[#ops + 1] = { kind = "rect", x = 10, y = list_y - 3, w = width - 20, h = 20,
          fill = "#a5e63c22", border = "#a5e63c55", border_width = 1, radius = 4 }
      end
      local marker = entry.in_top and "*" or " "
      local prefix = string.upper(tostring(entry.prefix or "COD"))
      add_text(16, list_y, 12, marker .. " " .. fit(entry.name, 36) .. "  [" .. prefix .. "]", index == state.search.selected and THEME.accent or THEME.text, false)
      list_y = list_y + 22
    end
  end

  add_text(16, height - 24, 10, "Enter open  |  Up/Down select  |  Backspace edit  |  F2/Esc close", THEME.faint, false)
  ops[1].h = height

  local ok, err = pcall(function()
    state.search.surface = rb.overlay.surface({
      capturable = cfg.capturable,
      anchor = "center",
      width = width,
      height = height,
      opacity = 0.99,
      ops = ops,
    })
  end)
  if not ok then
    rb.log.warn("CODMunity search surface failed: " .. tostring(err))
  end
end

close_search = function()
  if state.search == nil then
    return
  end
  remove_surface(state.search.surface)
  if state.search.handler then
    pcall(function()
      state.search.handler:stop()
    end)
  end
  state.search = nil
end

local function open_indexed_weapon(entry)
  local weapon = top_weapon_by_url(entry.url) or state.dynamic[entry.url]
  if weapon then
    select_weapon(weapon)
    return
  end

  local game = state.game
  set_status({ { game.label .. " ", "dim" }, { "loading " .. fit(entry.name, 22), "accent" } })
  rb.run(function()
    local ok, result = pcall(function()
      local html = http_get(entry.url)
      local parsed = extract_weapon({
        position = 0,
        name = entry.name,
        url = entry.url,
      }, html, game)
      parsed.rank = 0
      return parsed
    end)
    clear_status()
    if ok and result then
      state.dynamic[entry.url] = result
      if state.game_key == game.key then
        select_weapon(result)
      end
    else
      rb.log.warn("CODMunity indexed weapon failed: " .. tostring(entry.url) .. " - " .. tostring(result))
      notify("No " .. game.label .. " build on that page", {
        title = entry.name,
        duration = 3500,
      })
    end
  end)
end

local function choose_search_result()
  if state.search == nil or #state.search.results == 0 then
    return
  end
  local entry = state.search.results[state.search.selected]
  if state.search.query ~= "" then
    add_search_recent(state.search.query)
  end
  close_search()
  if entry then
    open_indexed_weapon(entry)
  end
end

local function search_on_down(key)
  if state.search == nil then
    return true
  end
  local modifiers = rb.input.modifiers()
  if modifiers.ctrl or modifiers.alt or modifiers.win then
    return true
  end
  if key == "Escape" or key == cfg.search_key then
    close_search()
    return false
  end
  if key == "Backspace" then
    if #state.search.query > 0 then
      state.search.query = state.search.query:sub(1, -2)
      state.search.selected = 1
      render_search()
    end
    return false
  end
  if key == "Enter" then
    choose_search_result()
    return false
  end
  if key == "Up" or key == "Down" then
    local count = #state.search.results
    if count > 0 then
      if key == "Up" then
        state.search.selected = state.search.selected - 1
      else
        state.search.selected = state.search.selected + 1
      end
      if state.search.selected < 1 then
        state.search.selected = count
      elseif state.search.selected > count then
        state.search.selected = 1
      end
      render_search()
    end
    return false
  end

  local character = nil
  if #key == 1 then
    local lower = key:lower()
    if lower:match("%a") or lower:match("%d") then
      character = lower
    end
  elseif key == "Space" then
    character = " "
  elseif key == "Minus" then
    character = "-"
  elseif key == "Period" then
    character = "."
  elseif key == "Apostrophe" then
    character = "'"
  end
  if character then
    if #state.search.query < 32 then
      state.search.query = state.search.query .. character
      state.search.selected = 1
      render_search()
    end
    return false
  end
  return true
end

local function open_search()
  apply_theme()
  if sync_game then
    sync_game(false)
  end
  close_help()
  if state.search then
    close_search()
    return
  end
  if state.menu then
    pcall(function()
      state.menu:close()
    end)
    state.menu = nil
  end
  remove_surface(state.detail)
  state.detail = nil
  remove_compare()
  remove_surface(state.changes_surface)
  state.changes_surface = nil

  ensure_index()
  state.search = {
    query = "",
    selected = 1,
    results = {},
    surface = nil,
    handler = nil,
  }
  render_search()
  state.search.handler = rb.on("down", search_on_down)
  if #state.index == 0 then
    notify("Weapon index loading; showing top 10", { title = "Search", duration = 3000 })
  end
end

local function copy_last()
  if sync_game then
    sync_game(false)
  end
  if state.search then
    close_search()
  end
  local weapon = state.last
  if not weapon and #state.items > 0 then
    weapon = state.items[1]
  end
  if not weapon then
    notify("Open the meta menu first", { title = "CODMunity", duration = 3000 })
    return
  end
  if copy_code(weapon) and state.detail then
    show_detail(weapon)
  end
end

local function open_menu(page)
  apply_theme()
  if sync_game then
    sync_game(false)
  end
  close_help()
  if state.search then
    close_search()
  end
  if state.menu then
    pcall(function()
      state.menu:close()
    end)
    state.menu = nil
    return
  end

  if #state.items == 0 then
    notify(state.refreshing and "Downloading meta data..." or "No meta data yet. Press F7 to retry.", {
      title = SOURCE,
      duration = 4000,
    })
    return
  end

  remove_surface(state.detail)
  state.detail = nil
  remove_compare()
  remove_surface(state.changes_surface)
  state.changes_surface = nil

  if not rb.overlay.visible() then
    notify("Exclusive fullscreen hides overlays. Use borderless.", {
      title = "Overlay hidden",
      duration = 5000,
    })
    return
  end

  local listed = get_view_items()
  if #listed == 0 then
    local view = tostring(cfg.view or "meta")
    if view == "favorites" then
      notify("No favorites for " .. state.game.label, { title = "Favorites", duration = 3500 })
    elseif view == "recent" then
      notify("No recent weapons for " .. state.game.label, { title = "Recent", duration = 3500 })
    else
      notify("No weapons match the current filter", { title = "Filter", duration = 3500 })
    end
    return
  end

  local PAGE_SIZE = 24
  page = math.max(1, tonumber(page) or 1)
  local page_count = math.max(1, math.ceil(#listed / PAGE_SIZE))
  page = math.min(page, page_count)
  local first = (page - 1) * PAGE_SIZE + 1
  local last = math.min(#listed, first + PAGE_SIZE - 1)

  local items = {}
  local mapping = {}
  if page > 1 then
    items[#items + 1] = {
      label = "< Previous page",
      hint = string.format("%d / %d", page - 1, page_count),
    }
    mapping[#mapping + 1] = { kind = "page", page = page - 1 }
  end
  if page == 1 and state.previous_week ~= "" and #state.previous_items > 0 then
    items[#items + 1] = {
      label = "What changed",
      hint = state.previous_week .. " -> " .. (state.week ~= "" and state.week or "current"),
    }
    mapping[#mapping + 1] = { kind = "changes" }
  end

  for index = first, last do
    local weapon = listed[index]
    local mark = is_favorite(weapon) and " *" or ""
    local rank = tonumber(weapon.rank) or 0
    local rank_text = rank > 0 and string.format("%2d", rank) or " -"
    items[#items + 1] = {
      label = string.format("%s  %s%s", rank_text, fit(weapon.name, 24), mark),
      hint = weapon_hint(weapon),
    }
    mapping[#mapping + 1] = { kind = "weapon", weapon = weapon }
  end
  if page < page_count then
    items[#items + 1] = {
      label = "Next page >",
      hint = string.format("%d / %d", page + 1, page_count),
    }
    mapping[#mapping + 1] = { kind = "page", page = page + 1 }
  end

  local view = tostring(cfg.view or "meta")
  local subtitle = string.upper(view) .. "  |  Week of " .. (state.week ~= "" and state.week or "current")
    .. "  |  updated " .. updated_label()
  local category = tostring(cfg.category or "all")
  local sort = tostring(cfg.sort or "rank")
  if category ~= "all" then
    subtitle = subtitle .. "  |  " .. string.upper(category)
  end
  if sort ~= "rank" then
    subtitle = subtitle .. "  |  " .. sort
  end
  if page_count > 1 then
    subtitle = subtitle .. "  |  " .. string.format("page %d/%d", page, page_count)
  end
  if state.refreshing then
    subtitle = subtitle .. "  |  updating"
  end

  local ok, menu, why = pcall(open_overlay_menu, items, {
    title = state.game.title,
    subtitle = subtitle,
    width = 680,
    theme = "tokyo-night",
    on_select = function(index)
      local entry = mapping[index]
      if not entry then
        return
      end
      if entry.kind == "page" then
        local target = entry.page
        rb.after(0, function()
          open_menu(target)
        end)
      elseif entry.kind == "changes" then
        show_changes()
      elseif entry.weapon then
        if entry.weapon.from_index or entry.weapon.from_recent then
          if fetching_weapon then
            return
          end
          fetching_weapon = true
          notify("Fetching " .. entry.weapon.name .. " ...", { title = SOURCE, duration = 2500 })
          rb.run(function()
            local game = selected_game()
            local fetch_ok, fetched = pcall(function()
              return extract_weapon({ position = 0, url = entry.weapon.url }, http_get(entry.weapon.url), game)
            end)
            fetching_weapon = false
            if fetch_ok and fetched then
              fetched.from_index = true
              fetched.name = entry.weapon.name
              state.last = fetched
              state.last_build = primary_build(fetched)
              add_recent(fetched)
              show_detail(fetched)
            else
              rb.log.warn("CODMunity weapon fetch failed: " .. tostring(fetched))
              notify("Could not load " .. entry.weapon.name, { title = SOURCE, duration = 3500 })
            end
          end)
        else
          select_weapon(entry.weapon)
        end
      end
    end,
    on_close = function()
      state.menu = nil
    end,
  })
  if not ok then
    why = tostring(menu)
    menu = nil
  end

  if menu then
    state.menu = menu
  else
    rb.log.warn("CODMunity meta menu: " .. tostring(why))
    notify("Could not open menu: " .. tostring(why), { title = "Meta", duration = 4000 })
  end
end

local function refresh(game, force)
  if state.refreshing then
    notify("Meta update already running", { title = SOURCE, duration = 2000 })
    return
  end

  if not force and state.game_key == game.key and state.updated_at > 0
    and os.time() - state.updated_at < MIN_REFRESH_SECONDS then
    rb.log.info("CODMunity " .. game.label .. " cache is fresh; skipping refresh")
    return
  end

  state.refreshing = true
  set_status({ { game.label .. " ", "dim" }, { "checking " .. SOURCE, "accent" } })

  rb.run(function()
    local ok, err = pcall(function()
      local index_html = http_get(game.index)
      local report_url
      local report_html
      local list
      if game.direct_meta then
        report_url = game.index
        report_html = index_html
        list = best_guns_list(parse_jsonld(index_html))
      else
        report_url = latest_report_url(parse_jsonld(index_html))
          or index_html:match("https://codmunity%.gg/weekly%-meta/" .. game.path .. "/%d%d%d%d%-%d%d%-%d%d")
        if not report_url then
          error("could not find the latest " .. game.label .. " meta report")
        end
        report_html = http_get(report_url)
        list = best_guns_list(parse_jsonld(report_html))
      end
      if not list then
        error("could not read the weapon list from the " .. game.label .. " page")
      end

      local week = tostring(list.name or ""):match("week of (.+)$")
        or tostring(report_url):match("(%d%d%d%d%-%d%d%-%d%d)$")
        or (game.direct_meta and os.date("%d %b %Y"))
        or "current"
      local total = #list.itemListElement
      local items = {}
      local failures = 0

      for index, entry in ipairs(list.itemListElement) do
        set_status({
          { game.label .. " ", "dim" },
          { string.format("%d/%d", index, total), "accent" },
        })
        local page_ok, page = pcall(function()
          return extract_weapon(entry, http_get(entry.url), game)
        end)
        if not (page_ok and page) then
          local err_text = tostring(page)
          if err_text:find("HTTP request failed", 1, true) or err_text:find("decoding", 1, true) then
            rb.sleep(800)
            page_ok, page = pcall(function()
              return extract_weapon(entry, http_get(entry.url), game)
            end)
          end
        end
        if page_ok and page then
          items[#items + 1] = page
        else
          failures = failures + 1
          rb.log.warn("CODMunity weapon page failed: " .. tostring(entry.url) .. " - " .. tostring(page))
        end
        rb.sleep(600)
      end

      if #items == 0 then
        error(string.format("all %d weapon page(s) failed", total))
      end
      if failures > 0 then
        rb.log.warn(string.format("CODMunity %s: %d of %d weapon pages failed; keeping %d", game.label, failures, total, #items))
      end

      table.sort(items, function(a, b)
        return (tonumber(a.rank) or 99) < (tonumber(b.rank) or 99)
      end)

      local previous_week, previous_items, history = save_cache(game, items, week, report_url)
      if state.game_key == game.key then
        local last_url = state.last and state.last.url
        state.items = items
        state.week = week
        state.report_url = report_url
        state.updated_at = os.time()
        state.previous_week = previous_week or ""
        state.previous_items = previous_items or {}
        state.history = history or {}
        state.last = nil
        state.last_build = nil
        if last_url then
          for _, weapon in ipairs(items) do
            if weapon.url == last_url then
              state.last = weapon
              break
            end
          end
        end
        render_hud()
      end

      local change_count = #compute_changes(items, previous_items or {})
      clear_status()
      notify("Week of " .. week .. "  |  " .. #items .. " weapons"
        .. (change_count > 0 and ("  |  " .. change_count .. " changes") or ""), {
        title = game.label .. " updated",
        duration = 4500,
      })
      local alerts = watchlist_alerts(items, previous_items or {}, game.key)
      if #alerts > 0 then
        notify(table.concat(alerts, "  |  "), {
          title = "Watchlist",
          duration = 6500,
        })
      end
      rb.log.info("CODMunity " .. game.label .. " meta updated: " .. week .. " (" .. #items .. " weapons)")
    end)

    if not ok then
      clear_status()
      rb.log.warn("CODMunity " .. game.label .. " meta update failed: " .. tostring(err))
      notify(#state.items > 0 and "Using saved meta data" or "No meta data; check network", {
        title = game.label .. " update failed",
        duration = 5000,
      })
    end
    state.refreshing = false
  end)
end

sync_game = function(force)
  apply_theme()
  close_help()
  local game = selected_game()
  if state.game_key ~= game.key then
    if state.menu then
      pcall(function()
        state.menu:close()
      end)
      state.menu = nil
    end
    remove_surface(state.detail)
    state.detail = nil
    remove_compare()
    remove_surface(state.changes_surface)
    state.changes_surface = nil
    remove_surface(state.hud_surface)
    state.hud_surface = nil

    state.game_key = game.key
    state.game = game
    state.items = {}
    state.week = ""
    state.report_url = ""
    state.updated_at = 0
    state.previous_week = ""
    state.previous_items = {}
    state.history = {}
    state.last = nil
    state.last_build = nil
    state.last_copied_code = nil

    local loaded = load_cache(game)
    if loaded then
      rb.log.info("CODMunity " .. game.label .. " cache loaded: " .. tostring(state.week))
    end
    render_hud()
  end

  local stale = state.updated_at == 0 or (os.time() - state.updated_at >= AUTO_REFRESH_SECONDS)
  if game.direct_meta and state.report_url ~= game.index then
    stale = true
  end
  if force or stale then
    refresh(game, force)
  end
end

local bind_handles = {}
local native_bind = rb.bind

local function bind_action(key, callback)
  local handle = native_bind(key, callback)
  if handle then
    bind_handles[#bind_handles + 1] = handle
  end
  return handle
end

bind_action(cfg.open_key, open_menu)
-- F8 is a common game key; this fallback opens the same menu even when the
-- game or Rebind editor consumes F8.
bind_action("Ctrl+Alt+Shift+F8", open_menu)
bind_action(cfg.search_key, function()
  if open_search then
    open_search()
  end
end)
bind_action(cfg.hud_key, function()
  toggle_hud()
end)
bind_action(cfg.compare_key, function()
  toggle_compare()
end)
bind_action(cfg.favorite_key, function()
  if state.search then
    close_search()
  end
  if sync_game then
    sync_game(false)
  end
  toggle_favorite(state.last or state.items[1])
end)
bind_action(cfg.build_key, function()
  if state.compare_surface then
    open_compare_actions()
  else
    open_build_menu()
  end
end)
bind_action(cfg.refresh_key, function()
  if sync_game then
    sync_game(true)
  end
end)
bind_action(cfg.copy_key, function()
  if state.compare_surface then
    copy_compare_side("A", true)
  else
    copy_last()
  end
end)
bind_action(cfg.full_copy_key, function()
  if state.compare_surface then
    copy_compare_side("B", true)
  else
    copy_full_loadout()
  end
end)
bind_action(cfg.help_key, show_help)
bind_action(cfg.extras_key, open_extras)

rb.on("start", function()
  math.randomseed(os.time())
  load_user_state()
  load_index()
  if sync_game then
    sync_game(false)
  end
  ensure_index()
end)

rb.on("stop", function()
  for _, handle in ipairs(bind_handles) do
    pcall(function()
      handle:unbind()
    end)
  end
  bind_handles = {}
  state.menu = nil
  close_search()
  close_help()
  remove_surface(state.detail)
  state.detail = nil
  remove_compare()
  remove_surface(state.changes_surface)
  state.changes_surface = nil
  remove_surface(state.hud_surface)
  state.hud_surface = nil
  clear_status()
end)
9 files, 3.5 MB. 4 have no text preview.
1.3.6Currentpublished 6 days agoFiles at 1.3.6
1.3.5Files at 1.3.5
1.3.3Files at 1.3.3
1.3.2Files at 1.3.2
1.3.1Files at 1.3.1
1.3.0Files at 1.3.0
Link

BYOH

Codmunity Meta Overlay

Files9 files / 3.5 MB

Core

Compare

Saved setup and extras

Detail panel

Hotkeys

Options

Games and data coverage

First run and data flow

Limits

Patch notes

1.3.6

1.3.3

Data and attribution

Requirements

Codmunity Meta Overlay

Readme

Files9 files / 3.5 MB

Core

Compare

Saved setup and extras

Detail panel

Hotkeys

Options

Games and data coverage

First run and data flow

Limits

Patch notes

1.3.6

1.3.3

Data and attribution

Requirements

Files

Versions
