加载中
《伪籍》开源工程
一张路引上的名字不是你的——直到你把它写成真的。
这是一个发布在幻光文游平台的文字游戏的完整工程源码,现以开源形式放出,供各位创作者交流学习。
【这是什么】
《伪籍》是一款单文件 HTML 文字游戏。玩家在旧图书馆的闭馆广播里醒来,被投进「书径」——六本书,六道副本,一关古代一关现代。每本书里都混着真话和假话,你要把它读完,判断哪句是真的。读到第七本时你会发现:第七本书就是你。
工程包含游戏引擎、全部剧情数据、本地美术素材、原创音乐音效,以及一整套开发构建脚本。
【怎么跑起来】
需要 Node.js 20 以上。
npm install 安装依赖(仅开发工具链,运行时零依赖)
npm run dev 本地预览,按提示在浏览器打开
npm run build 产出单文件 dist/index.html
npm run validate 校验剧情结构、素材引用与剧透红线
【工程结构】
src/index.html 引擎 + UI + 样式 + 音频管理,原生 JS,零框架零依赖
src/story.js 唯一事实来源:全部正文、选项、数值、结局
assets/ 场景图、地图、角色立绘、结局图、BGM、音效,全部本地化
scripts/ dev / build / validate / render-story / simulate
【可以改着玩的地方】
src/story.js 是唯一事实来源,改剧情只改这一个文件:
回合 id 从 1 连续,每回合至少 2 个选项;fx 只放五个属性键 ji / yi / qi / wu / shu;回合 mode 支持 talk / map / battle / game / vn;结局判定集中在 endRule,改结局只改这一处。
引擎自带:打字机对话、立绘差分、地图跑图(时辰消耗)、回合制战斗、五种小游戏(投壶 / 归档 / 走桩 / 色谱 / 布阵)、章节古今双皮肤、结局收集图鉴、localStorage 存档。
【几点说明】
1. 全部素材本地化,严禁外链。换图换音乐请放进 assets/ 再改引用。
2. 古代篇(1 / 3 / 5 章)黑金水墨风,现代篇(2 / 4 / 6 章)青蓝科技风,两套皮肤由章节 era 字段切换。
3. 音乐音效含平台素材与自处理音频,仅作学习交流使用,商用请自行替换。
4. 如果这个工程帮你摸到了幻光文游的开发门道,欢迎回社区分享你的作品。
感谢每一位走到第七本的读者。
协议是 协议。
请打开 lumi.66rpg.com 回帖