Usage Instructions / 使用说明

1. Overview / 概述

BGLite is a lightweight, purified version of the BiaoGe addon for World of Warcraft. It provides raid loot auction management, trade accounting, and related utilities for raid leaders and guild members. This version has been stripped down to core auction functionality only, with all non-essential modules removed for security and performance.

BGLite 是魔兽世界 BiaoGe 插件的精简纯净版本，提供团队副本拍卖管理、交易记账及相关工具功能，供团长和团员使用。本版本仅保留核心拍卖功能，移除了所有非必要模块，以确保安全性和轻量性。

2. Quick Start / 快速开始

EN:

• Type /bglite or /gbg to open the main window.

• Bind a key in Key Bindings > BGLite for quick access.

• Right-click the minimap icon to open the settings panel.

中文:

• 输入 /bglite 或 /gbg 打开主窗口。

• 在「按键设置 → BGLite」中绑定快捷键快速打开。

• 右键点击小地图图标打开设置面板。

3. Core Features / 核心功能

3.1 Raid Loot Auction (表格拍卖) / 团队拍卖表格

EN:

• Select a raid instance from the top tabs to switch boss loot tables.

• Each boss has rows for equipment items. Click an item's cell to enter a player name (buyer) and bid amount.

• Use Ctrl+Click on an item to auto-fill from inventory or chat links.

• The table supports payment (付款/工资), fine (罚款), and debt (欠款) tracking.

中文:

• 点击顶部副本标签切换 BOSS 掉落表。

• 每个 BOSS 有多行装备，点击单元格输入买家名和出价金额。

• Ctrl+点击 物品可从背包或聊天链接自动填入。

• 表格支持工资、罚款、欠款等多种记账类型。

3.2 Auto Auction / 自动拍卖

EN:

• Hold Alt and click an item in the table, inventory, or chat to open the auction panel with the item pre-filled.

• The auction panel supports manual or automatic bidding (watch auction / WA).

• Right-click a chat item to start auto-countdown (raid leader / loot distributor only).

中文:

• 按住 Alt 点击表格、背包或聊天中的物品，打开预填物品的拍卖面板。

• 拍卖面板支持手动出价和自动出价（WA 守拍）。

• 团长或物品分配者右键点击聊天物品可开启自动倒计时。

3.3 Trade Accounting / 交易记账

EN:

• Trade records are automatically logged when trading with other players.

• View trade history via Trade History module.

• Mail history and payment sending are also tracked.

中文:

• 与玩家交易时自动记录交易信息。

• 通过「交易历史」模块查看交易记录。

• 邮寄历史和工资发送也会被追踪。

3.4 Quick Accounting / 快速记账

EN:

• Right-click a chat item (guild members only) to open quick accounting mode.

• Select the boss slot and enter buyer + amount in a streamlined interface.

中文:

• 团员右键点击聊天中的物品打开快速记账模式。

• 在精简界面中选择 BOSS 槽位，输入买家和金额。

3.5 Notification System (通报) / 账单通报

EN:

• Broadcast final tables to guild or custom channels:

  • ZhangDan (账单): Full auction summary, wages, income, expenses, fines.

  • LiuPai (流拍): List of items that received no bids.

  • XiaoFei (消费): Top spenders ranking.

  • QianKuan (欠款): List of players with outstanding debts.

中文:

• 将最终账单通报到公会频道或自定义频道：

  • 账单: 总览、工资、收入、支出、罚款明细。

  • 流拍: 无人出价的装备列表。

  • 消费: 消费排名。

  • 欠款: 未结清款项的玩家列表。

3.6 History & Data Management / 历史与数据管理

EN:

• Saved tables can be viewed, applied, or deleted via History module.

• ClearBiaoGe module allows bulk reset of all data.

• DuiZhang module provides account reconciliation between multiple recorders.

中文:

• 通过「历史」模块查看、应用或删除已保存的表格。

• 「清表」模块可一键重置所有数据。

• 「对账」模块支持多个记录员之间的数据核对。

4. Slash Commands / 斜杠命令

5. Limitations / 已知限制

EN:

• Due to Blizzard's UI element limits, this addon cannot be used on Hardcore (HC) servers.

• BGLite removed the following modules compared to the original BiaoGe: Achievement, AtlasLoot, BestPrice, BoardReceiver, ChannelHistory, CommerceAuthority, Dungeon, EquipViewer, FilterClassItem, Handbook, Hope (partially), InfoBar, Map, MeetingHorn, Model, Mount, Report, RoleOverview, Shopping, WhoHistory, WorldBossCD, YY, bagSync.

• Some advanced features (item library / 装备库) are present as stubs and do not provide full functionality.

中文:

• 由于暴雪 UI 元素限制，本插件无法在硬核（HC）服务器使用。

• 相比原版 BiaoGe，BGLite 移除了以下模块：成就、AtlasLoot、BestPrice、频道历史、Dungeon、装备查看器、职业物品过滤、手册、Hope（部分）、信息条、地图、集结号、坐骑、报告、角色总览、购物、WhoHistory、世界BOSS计时、YY、背包同步等。

• 部分高级功能（装备库）以空壳形式保留，不提供完整功能。

6. For Developers / 开发者须知

EN:

• BGLite is built on the BiaoGe addon framework. Core architecture uses:

  • BG global namespace for module communication

  • BiaoGe SavedVariables for persistent data

  • BGLite.toc defines load order: Locales → Templates → embeds → DB → function1/2 → FBUI → Modules → BiaoGe.lua → Options.lua

• Stub functions in function2.lua replace removed module features to avoid nil-reference crashes.

• Addon communication uses C_ChatInfo.RegisterAddonMessagePrefix with "BiaoGeReceive" channel and compression encoding.

中文:

• BGLite 基于 BiaoGe 插件框架构建。核心架构：

  • BG 全局命名空间用于模块间通信

  • BiaoGe SavedVariables 存储持久化数据

  • BGLite.toc 定义加载顺序：本地化 → 模板 → 库 → 数据库 → 工具函数 → FBUI → 模块 → 主入口 → 设置

• function2.lua 中的 stub 函数替代被删除的模块功能，避免空引用崩溃。

• 插件间通信使用 C_ChatInfo.RegisterAddonMessagePrefix 注册 "BiaoGeReceive" 通道，配合压缩编码传输。

Changelog / 更新日志

v2.4.1 (2026-08-26)

Bug Fixes / BUG 修复

EN:

1. [Receive.lua:526] Removed redundant class variable in auction record reception condition. The original code referenced the local player's class (UnitClass("player"), line 19) instead of a parsed field from received data — a meaningless dead check. Cleaned up.

2. [BiaoGe.lua:1714] Added nil-safety check for BG.ItemLibMainFrame.bg. The equipment library feature was removed in BGLite and its stub does not implement the .bg attribute, creating a nil-pointer crash risk in the dress-up frame positioning logic. Guard added before access.

3. [AuctionLog.lua / Auction.lua] Fixed misspelling StartAucitonFrame → StartAuctionFrame (missing letter i). Globally unified across 2 files, 20 references.

4. [DB.lua:49-50] Cleaned up or short-circuit in BG.editTemplate and BG.editSearchTemplate. The fallback after or (e.g., "InputBoxTemplate") could never be reached since the first value is always truthy. Removed dead fallback and added comments referencing template definitions.

5. [function2.lua:43-48] Added documentation comments to the ItemLibMainFrame stub, noting the equipment library feature is removed and listing properties needed for future restoration.

中文:

1. [Receive.lua:526] 移除接收拍卖记录条件中多余的 class 变量引用。原代码中 class 取自本地玩家职业（第19行 UnitClass("player")），而非接收数据的解析字段，属于无意义的死检查，现已清理。

2. [BiaoGe.lua:1714] 为 BG.ItemLibMainFrame.bg 增加 nil 安全检查。装备库功能在 BGLite 中已移除，其 stub 未实现 .bg 属性，导致幻化框定位逻辑存在空指针崩溃风险。现已在访问前添加非空判断。

3. [AuctionLog.lua / Auction.lua] 修复 StartAucitonFrame 拼写错误（缺少字母 i）。已全局统一为 StartAuctionFrame，涉及 2 个文件共 20 处引用。

4. [DB.lua:49-50] 清理 BG.editTemplate 和 BG.editSearchTemplate 中 or 短路写法。原代码中 or 后的 fallback 永远不会生效，现已移除并添加注释说明模板定义位置。

5. [function2.lua:43-48] 为 ItemLibMainFrame stub 添加说明注释，标注装备库功能已移除及恢复时需实现的属性列表，便于后续维护。