加载中
这是一个用原生 HTML / CSS / JavaScript 写的单文件文字解谜游戏,没有框架,没有构建工具,双击 html 就能玩。把整套源码开源出来,是想给做同类文字游戏的朋友一个能直接拆开看的样本。
一、故事与体量
一九七七年冬,桦树屯。招生名单贴在大队部的墙上,苏玉兰的名字被人用墨涂掉了,底册第十七页被撕走,重贴上去的那两行字不是她的。她只有九天,要查清是谁动的手。
六十六个场景,三万余字,十一件证物,四道推理解谜,六个结局。单周目约两小时,收齐全部结局大概四到五周目。证物不会自动送上门,要靠选对地方、选对话;推理答案都能从手里的证物推出来,不用猜。
二、源码怎么组织
整个游戏拆成几片写,改起来不打架。
01_head.html 负责页面结构和全部样式,档案袋、卷宗、印章那一套外观都在这里。
02_engine.js 是剧本引擎,负责台词推进、条件跳转、证物旗标、推理判定、自动播放和存档读档。
03 到 06 是新四幕剧本,按章节分文件,一册一个文件,几万字塞在一起谁也改不动。
07_stage.js 管舞台层,背景、立绘、道具的入场和退场都在这一层控制。
merge.js 把上面几片按顺序拼成一个 html,就是可以直接双击打开的成品。
三、三个值得看的地方
第一个是单文件分发和资源外置的折中。平台限制每个 html 不超过 5MB,而把全部素材内联进去会到 15MB。externalize.js 会把内联的 base64 逐段拆成外部文件,重新生成 dist 目录;本地双击走单文件,上传走可分发结构,两套都能跑,互不干扰。
第二个是换场不卡顿。图片先按两条队列分别预热:取图四路并发,解码另开两路,取完即放行,不让慢的解码堵住整条队。切场景时先备好新图、解码完成再贴上去,找不到就等加载完再贴,带了超时兜底和过期回调拦截,快速连点也贴不上错图。
第三个是引导不抢台词。新手引导原本是定时弹出,正好把玩家正在读的那句话盖住。现在改成先停在那一句,等玩家自己点一下再出卷宗,读完了才给须知。
四、怎么跑起来
工程根目录里有一个已经合成好的 html,直接双击就能玩全流程。
要从源码重新构建:先执行 node build/merge.js 把分片合成单文件,再执行 npm run build 生成 dist。依赖只有一个发布工具和几个图像处理库,都写在 package.json 里,版本都是公开可安装的。
build 目录里还留着一批测试脚本,跑通关路线、查死锁、查空白场景、查引导时机,改完剧情可以直接拿来回归。
五、素材与授权
代码和剧情可以随意阅读、学习、改写,拿去改成自己的故事没问题。
美术是 AI 生成后统一处理的水彩风格,配乐和音效取自幻光免费素材库。这些素材的二次使用请遵守各自来源的授权,不要把本作的美术和剧情原样拿去商用。
做法上有想聊的,或者发现哪一段写得不够干净,欢迎在帖子下面留言。
协议是 协议。
请打开 lumi.66rpg.com 回帖
加载中