加载中
《死亡回溯》是一套可以直接跑起来的完整互动阅读工程,现在把源码开放出来。
它不是演示片段,而是一部已经上线、能从头玩到结局的作品:15 章剧情、14 种结局的都市悬疑故事,以及围绕「死亡回溯」这个核心设定搭起来的一整套玩法系统。开放这份工程的目的很简单——如果你也想做互动阅读,这里有一份可以照着改的完整实现。
一、这套工程里有什么
故事讲的是一个普通人被卷进连环死亡事件,每次死亡都会退回同一天重新开始。玩家要靠记住上一轮的线索,改变这一次的选择。
系统层面包含:
五次回溯的体质机制。每次死亡都会消耗体质,共 5 点,耗尽即抵达真结局。
悬疑推理节点。答错不会直接失败,三次提示后仍错才走向错误分支。
线索图鉴。7 条关键线索,随剧情推进逐步解锁。
结局图鉴与成就。14 个结局独立记录,配合成就系统。
剧情树。按章节解锁,可以从已经通过的章节直接入局重玩。
通话式互动与密码解谜。部分章节用拨号盘、暗号输入替代普通选项。
二、技术选型
没有用 React、Vue 之类的框架,全部是原生 JavaScript。理由是互动阅读的界面状态相对固定,框架带来的抽象成本大于收益,而原生 DOM 操作在低端机和手机浏览器上的表现更可控。
构建用 Vite 8,输出相对路径的静态站点,可以直接放进任意静态托管目录。
平台对接只有一处:@66rpg/lumimaker-sdk。云存档、登录、宿主握手都走这个包,作品自己不去碰浏览器本地存储。
三、目录结构
src/legacy/story.js 剧情数据。整部作品的节点、选项、分支、结局都在这里,由 tools/build_story.py 从剧本文本生成。
src/legacy/engine.js 引擎主体。对话推进、立绘、选项、推理判定、图鉴、设置。
src/legacy/preload.js 资源预加载与片头。
src/legacy/audio.js 音效与 BGM 管理。
src/platform/store.js 存档层。把引擎里散落的 9 个存储键合并成一份文档,内存同步读写,400ms 防抖后写云端。
src/platform/sdk.js 平台 SDK 封装。
src/platform/watermark.js 全屏昵称水印,用于截图外流时溯源。
assets/ 全部素材,分 img、bgm、se、video 四类。
tools/ 构建与校验脚本。
四、本地跑起来
npm install
npm run dev
npm run build
dev 模式不需要登录平台,SDK 会自动走本地实现,存档写在本机。build 产物在 dist/ 目录。
跑校验用 npm run validate,会检查剧情节点连通性、结局可达性,以及源码里有没有误用浏览器本地存储。
五、改成你自己的作品
第一步,改 package.json 里的 name、slug、version。
第二步,替换 assets/ 下的素材。
第三步,改 src/legacy/story.js 的剧情数据。数据结构是节点数组,每个节点带背景、立绘、台词流和选项目标;也可以照着 tools/build_story.py 的格式写自己的剧本文本再生成。
第四步,改 index.html 里的标题和文案。
不需要动引擎代码,就能换出一部新作品。
六、几个可以直接抄的实现细节
云存档的合并写入。平台存档接口按 key 存,逐个写会产生大量小请求,也容易出现两次写入互相覆盖。这里的做法是把 9 个键合并成一个文档,内存里同步读写不等待,累积 400ms 再整体写一次;写入串行化,并用代际号校验,避免慢请求返回时把新数据覆盖成旧数据。
读档失败不当空档。云端读取失败时不能当成「没有存档」,否则下一次写入就会把玩家真实进度覆盖掉。这里把失败和空档分成两种状态,失败时不写,只在界面上提示。
预加载的真实进度。每一张图、每一段音频、每一个视频都单独计数,任何一个失败都不阻塞主流程,只记日志并跳过,进度条不会永远停在 99%。
按章节入局。剧情树记录玩家走过的每个章节起点,解锁后可以直接跳进去重玩,不必从头开始。
图鉴的兜底恢复。运行环境可能清掉存储,启动时如果发现图鉴为空、但检查点存档里还有记录,就自动补回来。
七、平台适配的几条硬规则
如果你的作品也要发到幻光文游,这几条不能碰:
作品不得使用浏览器本地存储,存档一律走 SDK 的 writeSave、readSave。
不得用 meta refresh 做自动跳转。
不得用 postMessage 或 window.parent 直接和宿主通信,也不得自行读取 token。
所有素材必须是工程内本地文件,不能引用外部 CDN。
必须通过 npm 包引入 SDK,不要手写脚本注入。
八、关于版权
代码部分欢迎学习、修改、商用,保留出处即可。剧情文本、角色设定版权归原作者所有,请勿直接搬运到自己的作品里。这一点请务必留意:工程里包含完整剧情数据,是为了方便你研究结构,不代表可以照抄内容。
如果你用它做出了作品,欢迎回来告诉我。
协议是 协议。
请打开 lumi.66rpg.com 回帖