为魔兽世界无限(WoW Forever)打造的一套莫奈印象派风格整合 UI —— 界面配色按区域离线采样的环境色查表,再由莫奈规则实时派生四档主题色,随区域切换平滑变化。
配色的两半各管一段:环境色离线采样(按区域从官方地图美术贴图 / wuxianwow 旅拍 / 游戏截图提取,存成一张 mapID → 环境 HSL 的表),主题色运行期实时派生(拿你所在的地图 ID 查表 → 莫奈规则算出边缘 / 环境 / 高亮 / 中性四档 → 亮度阶梯定位 → 广播重涂)。运行期不读任何贴图像素(这个客户端也没有可用的像素读取 API),所以换区域时既不用等截图分析、也不会卡一下。查不到的区域沿 C_Map 的父链继承上一层(大陆 / 世界)的派生色,父链也断时退回中性灰兜底 —— 配置面板的「区域配色」一行会写明当前用的是哪一档。
色源优先级:官方地图美术贴图 > wuxianwow/trip 旅拍 > 自己的游戏截图,前一级有数据就用前一级。当前共 33 个精确区域(贴图 17 / trip 15 / game 1)+ 3 条父链派生兜底,唯一缺口是银月城 2393(旅拍站点不覆盖)。
- 区域驱动配色 —— 接入
LibMonetColor-1.0后,颜色 = 当前地图 ID 查按色源优先级离线采样的区域环境色 → 莫奈规则运行期实时派生四档 → 亮度阶梯定位。未覆盖的区域沿C_Map父链继承大陆 / 世界层的派生色,父链也断时退回中性灰兜底(面板「区域配色」一行会写明是哪一档);库缺失时优雅降级为内置默认配色。 - 模块松耦合 —— 模块之间只通过
Utils/EventBus.lua通信,互不直接依赖;每个模块都能单独开关,关掉即完整回退到暴雪原样。 - 自绘材质 —— 31 张自绘 UI 贴图(关闭钮三态 / 勾选框 / 状态条 / 图标 / 角饰 / 织纹 / 三角火花),结构性的走脚本(
tools/regen-textures.js)、可改的走 SVG(tools/svg/*.svg)、笔触走 GIMP,不引外部贴图。 - 无限客户端优先 —— 单位数值一律过保密值查询(
Utils/Secrets.lua);Interface 16001,Lua 5.1,不使用 5.2+ 特性。 - 永不抛错 —— 访问暴雪帧一律存在性 /
pcall防护;失败一次性告警,不刷屏。
| 模块 | 说明 |
|---|---|
| UnitFrames | 玩家 / 目标 / 焦点 / 宠物单位框架:血条、能量、名字、等级、提示,连击点小格;可拖动并保存位置。 |
| GroupFrames | 小队(自己 + 1–4)/ 团队(8 组 × 5 人)框架:暴雪安全头 + Monet 皮肤,职业色血条、能量、名字、职责图标、距离淡出、当前目标高亮边框、点击选中 / 右键菜单;可拖动并保存位置,默认接管暴雪自带的小队 / 团队框。 |
| BossFrames | 首领框架:压制暴雪 Boss1–5 目标框,自建按钮由 visibility 驱动显隐,样式与小队 / 团队同源(血条、能量、名字、选中边框)。 |
| Cooldown | 冷却数字 / 充能 / 快捷键字体美化,技能可用状态着色。 |
| BuffFrame | 自绘增益 / 减益网格,按时长排序。 |
| Minimap | 小地图矩形化(256×190),去掉坐标与时钟,配主题面板;右键弹微菜单(自有动作 4 行 + 原生微按钮的两击代点坞)。 |
| Bags | 分类背包(含账号银行页切片):全自绘,接管暴雪背包框(开背包时把我们的窗口顶上来),支持搜索 / 分类 / 整理。 |
| QuestTracker | 任务追踪主题边框 + 标题栏拖动 + 位置保存。 |
| ActionBars | 1–8 号自绘动作条(不依赖任何动作条库:按钮用客户端的 SecureActionButtonTemplate + actionpage 属性自绘,施法 / 翻页 / 载具条全部由客户端判定),接管宠物 / 姿态条,隐藏暴雪动作条与背包条。宠物条的「自动施法」提示用自绘的像素环替掉暴雪那圈旋转的蚂蚁。 |
| Nameplates | 挂在暴雪姓名板底座上的细条姓名板:血条 / 名字等级 / 百分比 / 施法条 / 仇恨描边。当前目标=金色描边 + 放大 1.1 倍(固定信号,不随主题变;仇恨色优先级更高);不显示增益 / 减益(2026-10-26 起,光环交回玩家单位框与暴雪原生)。 |
| InfoBar | 贴屏幕边缘的整幅细条 + 6 个数据块(金钱 / 耐久 / 货币 / 系统 / 好友 / 属性),悬停淡入 —— 系统块例外:居中且常显;战斗呼吸、宠物对战自动隐藏。每格可点:金钱 / 货币开背包,耐久弹贴格「角色」小菜单(第二击开角色界面),系统开设置,好友直开社交窗,属性开属性面板(映射与两击代点的理由见「已知限制」)。底边衬线就是经验条(进度=线的长度,进度头一枚 ▲,涨经验时三角滑过去并白热、升级时闪两下,悬停三角才弹具体数值),满级后同一条线改显示当前监视的声望、颜色随关系走。 |
| Skins | 暴雪窗口美化:任务、世界地图、角色、收藏、社交、交易(邮件 / 商贩 / 拍卖 / 专业)、系统、Forever,统一铺 Monet 底板 / 边框 / 字体;可逐窗口开关。 |
| Tooltip | 鼠标提示:摆法三选一 —— 跟随鼠标(贴屏幕右/上边缘自动翻边)/右下角对齐小地图面板右上角/暴雪默认位置;单位提示补一行「目标: 谁」;按住 Alt 显示 ID(NPC / 物品 / 法术)。外观(边框 / 底色 / 字体)在 Skins 的「鼠标提示边框」里,默认开。 |
| Cursor | 光标拖尾(快速移动时跟出一条主题色笔迹,停下自己淡没)+ 速度星芒(快速甩动时出现十字光)。全部用 Line 自绘,不引任何贴图,两个效果各自可关。 |
| Toast | 通知横幅:屏幕顶部一条主题化提示,一次一条、排队播完,底边细线随停留时间排空。接三件事——新邮件(小地图邮件图标默认隐藏)、背包满、进出战斗提示(自绘剑 + 盾 + 大字)。 |
| Durability | 装备耐久警告:最低的那件跌破阈值时用横幅提醒一次,修好或换装回到阈值以上才重新武装。 |
| Atmosphere | 氛围暗角:世界之上、所有 UI 之下的一层径向压暗(三档强度),默认关 —— 开不开是审美选择,不是缺省。 |
另有四个工具模块不进上表:Report(/mui report,一份可贴回来的诊断包)、DevTools(/mui perf 调度器总账)、Tweaks(/console 设置逐条开关,默认开着作者调好的那几条:视距 / 伤害数字 ×0.5 / 战斗文字只留伤害 / 任务物品发光 / 复活不灰屏 / 关雨雪)、WhatsNew(版本更新一次性提示,/mui whatsnew 重看)。原 CombatText 已于 2026-11-02 撤销:浮动战斗文字交回暴雪原生(机密值下我们的数字拿不到明文),进出战斗提示并入 Toast。
CurseForge(推荐):https://www.curseforge.com/wow/addons/monetui —— 当前 0.13.0,
Forever 1.60.1 / Release;首版 0.12.0 的文件 ID 是 9506208。用 CurseForge 客户端可直接订阅更新。
自动发版走 GitHub tag:纯数字 tag 触发 Actions 打包上传,见 docs/HANDOFF.md §8.69.4;
新版本上传后通常要过 CF 审核才会在公开文件页出现,期间可从
GitHub Releases 直接下载同名 zip。
手动安装:
- 把整个
MonetUI文件夹放进客户端的Interface/AddOns/下(或从 Release 下载 zip 解压)。 - 完整重启客户端 —— 新增文件不会被热加载。
- 游戏内输入
/mui看用法,/mui status看模块与主题状态。
配置面板在暴雪界面设置里(Esc → 界面),设置存于 MonetUIDB。
- 硬依赖:无 ——
LibStub已内嵌在Libs/下,不需要额外安装任何库。 - 随包:
LibMonetColor-1.0(配色引擎)、LibMonetColor-Anim-1.0(状态染色层)、MonetColorMapData-1.0(25 个区域的实测环境色:trip 18 / game 7,自家仓库 monetcolors 的生成产物,不要手改)。 - 随包的派生数据:
MonetColorMapEnvOverride.lua(本仓算出的 3 条大陆 / 世界层父链色,运行时走引擎的RegisterMapEnvoverride 通道注册)—— 数值由该层成员区的实测色取圆均值派生,不是新采的样,所以不写回生成文件;RegisterMapEnv自带ClearCache + Refresh,而本文件在Libs组、Core.lua之前加载 —— 那一刻还没有人订阅引擎回调,所以这几次刷新只重算缓存,不会播一次多余的重涂。 - 随包的贴图覆盖层:
MonetColorMapEnvAtlas.lua(17 区官方地图美术贴图环境色,同样走RegisterMapEnv;加载序排在父层 override 之后,故优先级最高,会顶掉数据包里 9 个同名区域,并补上数据模块没有的 8 个区域)。加上 25 区数据包即现行 33 个精确区域。口径由tools/env-source-check.js守门(逐区对账 + 加载序 + 底账source标签),tools/map-env-coverage.js出覆盖率账。 - 动作条不依赖任何动作条库:按钮用客户端自己的
SecureActionButtonTemplate+actionpage属性自绘,施法、翻页、载具 / 变形 / 覆盖条全部由客户端判定。
⚠️ 不要同时启用独立的LibMonetColor-1.0插件。同MAJOR由LibStub按MINOR仲裁(Libs/LibStub/LibStub.lua:15-18:先注册且MINOR不低于对方的一份拿到库表),落选的那份在LibMonetColor-1.0.lua:29-33的if not LMC then return end处静默退出 —— 不报错、不崩,但两份的区域色数据不同步时,真正生效的是哪一份取决于加载顺序。本体已内嵌该引擎,重复启用只会让其中一份白加载。
| 命令 | 作用 |
|---|---|
/mui status |
显示模块与主题状态 |
/mui theme |
按当前区域重查环境色、重新派生四档并广播重涂(不做任何像素取样) |
/mui <模块> on|off |
单独开关模块(模块名见上表,小写) |
/mui skins diagnose |
探测本客户端缺失的对象名(nameplates / infobar 同样支持) |
/mui infobar diagnose |
信息栏自检 |
/mui reset |
恢复默认设置(需 /reload) |
/mui enable / disable |
启用 / 禁用本体(禁用需 /reload) |
/mui report |
生成一份可贴回来的诊断包(环境 / 设置差异 / 提示历史 / 同机插件清单,全量落账本) |
/mui compat |
客户端能力自查 —— 换客户端第一趟先跑它(bad 只看与假设不符的项) |
/mui restrict |
六类受限窗口自查(战斗只是其中一类) |
/mui scale |
像素网格 / UI 缩放自检(改完缩放再跑一次对比) |
/mui blocks |
机密布尔被拦的调用栈账本(full 看完整栈) |
/mui perf |
调度器总账:订阅数 / 逐路耗时 / Lua 内存 / 被暂停的轮询框 |
/mui whatsnew |
重看本版本的更新提示 |
/mui help |
列出全部命令(含深层诊断探针) |
/monetui 亦可。
MonetUI/
├── MonetUI.toc 入口清单:只列各组 xml + Core.lua(顺序即加载顺序)
├── Core.lua SavedVariables / 模块注册与生命周期 / 主题管线 / 斜杠命令
├── LICENSE / THIRD-PARTY-NOTICES.txt 自身 MIT + 随包第三方与字体的许可清单
├── Libs/ 随包库 + NOTICE.md(第三方许可清单)+ Libs.xml
├── Utils/ 基础工具(Math Secrets Media EventBus Color Widget Layout Mover Skin)+ Utils.xml
├── Config/ 设置面板(SimpleConfig)+ Config.xml
├── Modules/ 各功能模块(见上表),每个模块一份同名 xml 清单
├── Assets/ 字体 / 自绘材质 / 图标
├── docs/ 开发记录、布局与材质预览页(不入库;README 头图例外)
└── tools/ 闸门脚本(api-audit / audit-taint / audit-locals / sync-check / env-source-check / map-env-coverage)+ 材质生成器
一个子模块 = 一份 xml 清单:MonetUI.toc 不逐个列 .lua,而是列
Libs/Libs.xml、Utils/Utils.xml、Config/Config.xml 和 Modules/<模块>/<模块>.xml;
组内加载顺序写在 xml 的 <Script file> 里,组间顺序就是 toc 里的排列。toc 里直接列的
.lua 只有 Core.lua。要加减文件就改对应 xml ——
顺序和"这一组是干什么的、为什么是这个先后"都写在各 xml 头部的注释里。
仓库只跟踪发行集(
.toc/ 各 xml 列出的文件 +Assets/+Libs/+README.md/LICENSE)与tools/的闸门与材质生成脚本(验证链的一部分)。其余开发资料(docs/交接包、AGENTS.md、MonetUI.md、TODO.md)按.gitignore不入库 —— 克隆下来是可直接用的插件,不是完整开发环境。脚本用法写在各脚本头部注释里。
2026-11-05(《无限》1.60 开服日)已在交付客户端上实机复验:1.60.1 · build 70790 · Interface 16001 · zhCN。
更早的 12.1.5 验收记录现在只是历史证据;下面写的都是 1.60 实测。
2026-11-08 追加:1.60.1 · build 70862 上,/reload 后全 33 区实机逐区对账 33/33 完全一致(17 贴图 override + 15 trip + 1 game);/mui colors 四级亮度阶梯 4/4 对比度过线(阈值 1.4);ERR / BLOCKED 零条,加载 21/21 模块。细节见本地开发文档 docs/HANDOFF.md §8.68。
- 登录:
已加载 20/20 个模块、界面美化已启用(46 个窗口)、/mui report四段(环境 / 角色 / 位置 / 受限)都对。 - 只读诊断全跑过:
/mui compat(58 项,与假设不符 6 项已逐条处置)、/mui skins diagnose(277 存在 / 64 缺失,缺的不全是缺陷:GameRule 关掉的面板、别的客户端的名字、以及窗口还没开)、/mui restrict、/mui blocks、/mui perf。 - 功能项:背包分类窗 + 品质边框 + 等级数字 + 空格可掉落(拖放实测);银行与背包同屏并存不重叠; 人物页签 / 好友 / 社交窗 / 任务详情 / 技能书 / 传承三页按 1.60 实名涂到位。
- 干净基线(关掉同机 QoL 套件 + 重载,且在战斗中):
ERR / BLOCKED零条,/mui blocks账本空。
已知限制(都是取舍,不是坏掉的功能;自 0.12.0 起持续适用):
-
暴雪面板没有"一击直开",最多两击(2026-11-07 更新)。一击直调暴雪 Lua 全局会把整段面板链记到插件名下 (11-05 开服 P0 判例:
ToggleCharacter→TextStatusBar.lua:110机密值比较按 MonetUI 记账), 把安全模板挂进信息栏又会把逐拍排版的整条标成受保护(每 10 秒上百条拦截)。所以能一击的都一击,其余走代点 —— 金钱 / 货币 → 我们自己的背包窗;系统 → 设置(Settings.OpenToCategory,纯 C_*);属性 → 我们自己的属性面板; 耐久 → 贴格小菜单只留「角色」一行、第二击由安全按钮代点开角色界面;好友 → 直开社交窗 (作者批准的例外:ToggleFriendsFrame,taintLog=2下 open + close 零新增)。右键小地图的微菜单是代点坞: 自有 4 行(背包 / 地图 / 日历 / 设置)+ 11 颗原生微按钮的代点行(角色 / 专业 / 法术书 / 天赋 / 传承 / 任务日志 / 公会 / 查找队伍 / 收藏 / 帮助 / 商店 —— 游戏菜单那颗代点不通,11-06 实机零反应,不建行)。 -
银行默认接管暴雪银行框(只留我们的窗,2026-11-06 起)。我们的银行空格自 11-06 起是真容器槽 (拖放三向已实测:背↔银、背内互拖)。要买栏位 / 换银行包这类必须回到暴雪那块面做的事, 用
/mui bags bank off(或面板里的「放开暴雪」钮);想让两套并存就/mui bags hidebliz off。 -
同机插件会抢东西:
RurutiaSuite的"小地图按钮收纳"会把我们的命中层搬走(本版已改成挂自己的容器),DungeonsForeverSpell一类会让暴雪动作条报SetCooldown。这类拦截可能记到 MonetUI 名下, 出问题请先跑/mui report,并在关掉其它插件后复现一次。 -
/mui perf的逐路耗时在这一版恒为 0(GetTime粒度不够,客户端另有高精度计时器,待接入)。 -
逐项进度、验收清单与客户端约定记在本地开发文档(
AGENTS.md、MonetUI.md、TODO.md、docs/,按.gitignore不入库)。
- MonetUI 自身代码:MIT。
- 随包第三方组件保留各自许可:
LibStub(公有领域)。逐条清单见THIRD-PARTY-NOTICES.txt(发行时随包分发),细节见Libs/NOTICE.md与Assets/Fonts/NOTICE.md。 - 随包字体各自授权(随包只有三份,
Assets/Fonts/实测):正文小字轨Pingfangpixel.ttf(点阵苹方,作者 2026-11-01 已授权我们再分发 ⇒ 公开 Release 不需要替换,条款见Assets/Fonts/NOTICE.md)、正文大字LXGWWenKai-Regular.ttf(SIL OFL 1.1,随包附全文)、 倒计时数字super-effective.ttf(CC BY-SA 3.0,需署名)。像素轨替代候选(Fusion / Ark Pixel) 与朱雀仿宋放在Assets-src/Fonts/,不进包;roadway.ttf无授权声明、代码不引用、不分发。
魔兽世界无限(WoW Forever) / Interface 16001 / Lua 5.1
