不是 Demo,是已经在重度使用的工具
角色库已收录 559 个角色,其中 523 个已有战绩记录。涵盖 MUGEN 社区各类角色,从普通到神凶全覆盖。
已自动执行 2476 场 AI 对战,产生 1563 条结构化对局记录和 2691 条积分变动明细。全部通过内存级胜负检测自动记录。
配置了 15 级实力档位(超神到地板),283 个角色已自动定档。含 1v1 和 1v2 双人守门员挑战机制,档位判定由真实战绩驱动。
对局记录从 2026-05-09 持续到 2026-09-08,跨越 4 个月的日常使用。不是做出来就放着,是每天都在用的工具。
20 年社区沉淀,角色星海浩瀚
全球社区累计 10 万+ 自制角色,仅知名合集就涵盖 3,000~18,000+ 角色规模。涵盖街头霸王、龙珠、火影、海贼王、真人快打、漫威、卡普空等数百个 IP,从动漫、游戏、影视到网络热梗全覆盖。
单个合集就包含 300~400+ 独立舞台,全球累计数千个自制战场,涵盖经典游戏场景、动漫名场面、原创世界观等。
MUGEN Free For All、Mugen Archive、GitHub 等平台汇聚全球数千名角色作者和 AI 开发者,持续 20 年产出新角色和新引擎补丁。
从七龙珠到原神,从赛尔号谱尼到雷电将军,从漫威英雄到初音未来,MUGEN 是唯一能让任何角色跨 IP 对战的开放平台,真正的文化大熔炉。
从自动对战到 AI 生成,从战绩统计到剧情编排,覆盖 MUGEN 全生态
选好角色,点一下按钮,自动配对、自动启动 MUGEN 子进程、自动记录胜负、自动更新战绩。全程零人工干预,百场比赛压缩到喝杯咖啡的时间。
自由战斗(1v1指定角色)、随机战斗(多角色自动配对)、档位挑战(守门员1v1/1v2)、批量挑战(多角色循环挑战某档位)、播放列表(编排赛程拖拽排序)。随机模式支持按段位/实力档次匹配对手,支持左侧固定锚定角色。
可配置的段位阈值与积分规则,7 级档位(青铜→王者)。守门员挑战机制支持 1v1 和 1v2 双人守关,5 级优先级判定链确保档位公正。
从 SFF 精灵文件直接提取 9000 号大头像,渲染各 P 数站立姿态。P 数差异分析引擎扫描角色源码,自动识别 AI/性能/动作/模型/色表差异。
与 Ikemen GO 中的角色用自然语言对话——"释放小型火焰""跳过去打他"。DeepSeek API 解析意图生成 [ACTION:xxx] 动作标记,转成 realtime_cmd.json 文件指令,Lua 端 hook.add("loop") 每帧检测执行 selfState/setAILevel,实现零延迟帧级控制。
战斗进行中右侧悬浮窗随时接管——上部技能快捷按钮一键释放指定招式,下部自然语言指挥框输入"让桐人现在开大反击",LLM 解析意图后写入 realtime_cmd.json,与剧情模式共用 story_runtime.lua 底层。Watch 模式下 AI vs AI 推荐场景。
可视化编排多场连续战斗剧情:14 种步骤类型(对话/状态/生命/能量/AI/等待/受击等待/动画/速度/结束)× 8 种节点条件(始终/存活/阵亡/血量≤/血量≥/能量≥/状态/回合状态),4 种内置模板(变身反杀/绝地反杀/阶梯训练/多场对话)一键创建。
五阶段向导(分析→决策→生成→检查→测试)为无 AI 角色自动生成战斗代码。3 种战斗模式(近战连段型/均衡型/远程压制型)× 3 种实现模式(独立 AI 文件/主文件追加/覆盖作者),严格兼容 MUGEN 1.1 标准。检查清单覆盖招式覆盖率/距离校验/安全条件/兼容性,未通过可自动修复重试。
将 WinMUGEN/1.0 角色移植到 1.1 引擎。自动化扫描风险项、报错驱动修复、功能验证全流程。已成功转换谱尼(455处%n)、雷电将军、流萤等角色。
不止"用"引擎,而是改引擎——fork 源码做 6 处 Go 定制 + 新增 2 个 Lua 每帧运行时脚本,AI 对话 / 战斗干预 / 剧情编排三大模块都建立在这层改造之上
上游引擎打完不写输赢,我们在 system.go 新增 writeMatchResult(),整场结束时把 winner / p1_wins / p2_wins 写入 save/logs/match_result.txt。自动对战的胜负判定因此无需逆向内存,与 MUGEN 侧的内存读取形成两条互为备份的路线。
fightscreen.go 在角色名后附加当前实际生效的配色号(P 数),批量 AI 对战核对双方配色一眼可见;并保留"未加修改"的备份 exe 作对照。
上游是"两个对话框同时挂"的格斗游戏风格,且新对话会因渲染状态未释放而卡死。motif.go + script.go 改造后:头像显示说话者本人、只绘制当前说话者一侧、连续对话即时加载——剧情演出才成立。
main.go 用 os.Executable() + os.Chdir 把工作目录钉死在 exe 目录,治"save/ 落到盘根";dllsearch_windows.go 放宽 DLL 检查——官方发布包不带 avdevice-*.dll,原版检查会导致启动即崩。
新增 story_loader.lua + story_runtime.lua:hook.add("loop") 每帧调度——实时指令消费(读后即删)→ 无限血守护 → 静止敌人压制 → holdState 持续状态保持 → 14 步骤剧情状态机 → 中文对话气泡。全部 pcall 包裹,出错不崩引擎。
带 -trace 参数的运行时追踪版(可追踪任意角色的实际绘制帧与调色板)、调色板追踪版、P 数显示修改前的备份版——引擎级的问题,在引擎里排查。
解决 MUGEN 社区长期存在的工程难题
直接读取 MUGEN 进程内存基址,通过指针偏移定位双方胜场计数器。解决 MUGEN 1.1 原生日志不含胜者字段的根本问题。
用 Windows mklink /J 创建 junction 联结,将中文路径映射为 ASCII 短路径,资源文件零拷贝直接引用,彻底解决崩溃问题。
BattleWorker / PrefetchWorker / RecalculateWorker / LivePreviewWorker / PortraitQueue + 60s 看门狗,UI 全程不卡顿。
以 file_signature (size+mtime) 为核心原语,6 层递进签名校验 + SHA1 内容寻址缓存,源文件变化自动失效。
定档结果反向进入战斗编排系统自动播放战斗,战斗后再计算实力定档,实现完全自动化的联赛循环。
窗口/分割器/表格列序/冻结列/自定义列名/折叠状态全部自动保存恢复,含离屏检测和防抖机制。
三层解耦:扫描只发现、运行才证明、Fatal 才修改。配套自动化脚本 fix_tagout / fix_exploit / fix_binary_st。
18 章系统化手册:分层决策(宏观策略/中观距离/微观连段)+ 概率驱动 + 安全优先 + 全招式覆盖,3 个端到端参考角色。
逆向分析 MUGEN 二进制 SFF 精灵文件格式,提取 9000 号大头像和站立姿态精灵。不依赖 Fighter Factory 等第三方工具,纯代码实现精灵解析与渲染。
Python 端写 realtime_cmd.json / active_story.lua 文件,Ikemen GO Lua 端 hook.add("loop") 每帧检测执行。零进程间通信开销,零延迟帧级精度,无需改引擎源码即可注入剧情逻辑。
不是"拿来就用":fork 引擎源码定制 6 个 Go 文件——writeMatchResult() 结果落盘、对战界面 P 数显示、baseDir 修复、DLL 检查放宽、连续对话修复、剧情轮流对话框。DLL 全部放 lib/ 并在 PATH 注入,stdout 重定向捕获 init() 阶段错误。
新增 story_loader.lua + story_runtime.lua(约 1000 行),hook.add("loop") 每帧调度实时指令→无限血→holdState→剧情状态机,全部 pcall 包裹;配套 -trace 追踪版 / 调色板追踪版 / 备份版三个定制 exe,引擎行为全链路可观测。
Ikemen GO Lua API 操作 sys.debugWC(当前焦点角色),严格遵循"保存 id()→player() 切换→操作→playerId() 恢复"模式,实现 selfState/setLife/setPower/setAILevel 帧级角色控制。
命令行参数 -p1.life 999999 兜底 + Lua 每帧守护检测 infinite_life.flag 标志文件生命值低于 50% 回满 + 标志文件生命周期管理(对话模式启动创建/关闭删除),防止 AI 对话误杀导致模式自动退出。
CharacterStandardizer 一次性读取角色 .def/.cmd/.cns 文件,调用 DeepSeek API 提取技能(人话名/状态号/类型/命令/消耗/描述)存入 character_skills 表,AI 对话、技能按钮、剧情编辑三功能共用,避免反复读文件。
分析(读取 .def/.cmd/.cns/.air + DeepSeek 辅助)→ 决策(战斗模式/实现模式/var 规划)→ 生成(CMD 虚拟命令 + CNS Statedef -3)→ 检查(招式覆盖率/距离校验/安全条件/MUGEN 1.1 兼容性)→ 写入+测试。未通过检查可自动修复重试。
3 种战斗模式(近战连段型/均衡型/远程压制型)× 3 种实现模式(独立 AI 文件/主文件追加/覆盖作者)= 9 种组合,每种模式有独立策略状态机和连段系统。远程压制型采用技能轮换替代连段,每帧攒气维持火力。
开发用 Ikemen GO 排查问题,目标运行环境为 MUGEN 1.1。禁止使用 AssertCommand/RedirectID/AILevelF/ZSS 语法等 Ikemen 独有特性;AI 开关用 var(59) 虚拟命令 + 恒真兜底(ai设计.md 模式二),所有版本通用。
逆向解析 AIR 动画文件的 Clsn1(攻击碰撞框)和 Clsn2(受击碰撞框),结合 CNS Statedef 提取每招式的伤害/距离/取消链,为 AI 生成提供精确的招式元数据,避免 AI 释放超出攻击范围的招式。
story_runtime.lua 实现节点条件检测→执行步骤序列的状态机:非阻塞步骤(dialogue/state/life/power/ai)立即执行推进,阻塞步骤(wait/wait_hit/wait_alive/wait_state)设置 blocking 状态条件满足后解除,end 步骤跳下一节点。
懒加载 simhei.ttf 系统黑体支持中文,角色名黄色 24px + 对话文本白色 20px,UTF-8 自动换行(中文算 2 宽度英文算 1),luaFlushDrawQueue 在 renderFrame 中执行,frames 倒计时到 0 自动清除。
无边框半透明深色背景,置顶可切换;100ms 采样 win32gui 跟随 Ikemen GO 引擎窗口移动/缩放;引擎最小化时悬浮窗跟随隐藏恢复时自动恢复;左右边界拖拽条调整宽度。
逆向解析 AIR 动画定义文件,提取角色站立动作序列帧,自动选择最佳帧渲染各 P 数(1-12 色表槽位)的实机预览图,无需进入游戏即可查看角色。
逆向解析 .def 舞台定义文件格式,提取背景层定义、parallax 视差参数和遮挡关系,独立渲染战场预览图,不启动 MUGEN 即可预览场景全貌。
80000+ 行代码背后,是反复打磨的工程细节
threading.Event() 零开销查询取消标志,先设协作标志,再 terminate() 进程,3s 后 kill(),确保战斗任务安全终止不残留。
PortraitQueue 每 5s 检查 worker 状态,超过 60s 未完成的任务自动踢出,_emitted 标志防止超时与正常完成的竞争条件。
批量更新战绩表/角色表时 blockSignals(True) 阻止逐行触发信号,20+ 处调用,避免大量无用的 UI 重绘。
StatsService 用 (file_signature, data) 对做内存缓存,读取前先比对文件签名,未变化则跳过 JSON 解析直接返回。SQLite 5 个索引加速查询。
WinCountMonitor 100ms 轮询间隔,仅在胜场变化时记录。诊断采样 5s 一次,样本上限 40 条,防止长时间战斗内存无限增长。
启动时清理 30 天前的 .log 文件,desktop_runtime.log 超 5MB 自动归档为带时间戳文件,归档文件 30 天后自动删除。
离屏检测恢复时检查窗口矩形与屏幕相交;offscreen 平台保护跳过保存;启动防抖 500ms 防中间状态写入;自动保存防抖 350ms 单发定时器。
立绘/预览缓存文件名由 SHA1(源文件签名+版本号) 生成,源文件变化产生新路径,旧缓存自动孤立无需手动清理。