《俺娘王翠花》是一个自包含的单文件 HTML 文游:没有框架,没有构建步骤,图片以 base64 内嵌,配乐用 Web Audio 实时合成。整个作品只有一个 src/index.html,约 3MB,其中一半是六张场景插画。
开源出来,是想给同样做单文件叙事游戏的人一个能直接改的底子。
一、剧本怎么组织
场景与对白按 SCENES 结构排,一个场景一段,旁白和对白分开写。改台词、调场景顺序不用碰界面代码。角色表单独放在前面,立绘、名字、说话时的名牌都挂在那里。
二、线索与推理判定
CLUES 定义每条线索的名称、描述,以及它指向哪一处矛盾。指认环节按四处矛盾是否同时成立来判定,错判有单独的结局,不会一句「你错了」就打发。
三、警官笔记
玩家随时能点开右侧的笔记,翻已经收集到的线索。这是这个作品唯一的内置提示,也是卡关时的出口。
四、云存档
存档走平台云存档接口,不用浏览器本地存储——平台播放页会拦本地存储。这条规则在 scripts/validate.mjs 里做成了发布前自检,构建前跑一遍就能挡住。
五、程序化配乐
没有音频文件。谱子写成音符数组,播放时实时合成,所以整个包只有几百 KB 的代码,剩下都是图,加载不用等音频。
怎么跑
进目录跑 npm run dev,本地起服务,浏览器打开就能玩。改 src/index.html 即可,改完 npm run build 生成 dist/,dist/ 就是发布产物。
素材与文档
assets/ 里是立绘原图与封面源文件,可以换成自己的图重新内嵌,换完按原尺寸重新内联即可。
四条不能碰的线
不引入框架和构建工具,不加外链 CDN,不用本地存储,不用 meta 跳转。前两条是为了保持单文件,后两条是平台播放页真会拦。这四条,加上字号、对话框高度、剧情口径这些踩过的坑,都写在 AGENTS.md 里,改代码前先看一眼。
拿去改随意,改完发出来,可以到点评区说一声。
协议是 协议。