加载中
《暗潮骨号》是一套完整可跑的中世纪海盗悬疑互动剧,现在把整套源码开源出来,供各位创作者拉取、学习、直接改成自己的作品。
【这是什么】
赏金猎人孤身登上名为「暗潮骨号」的海盗船,在七个昼夜与一场风暴里辨认真凶、查明黑石港血案。作品含 71 个剧情节点、3 条隐藏数值(信任 / 戒备 / 人心)、5 条独立结局与一封番外信,单周目阅读时长约 110–130 分钟。
【技术上有什么可抄的】
1. 单文件引擎:全部逻辑写在一个 index.html 里,剧情是一张 STORY 有向图,节点支持 text / speaker / bg / music / sfx / choices / choicesFn / onEnter / next / ending,零框架、零运行时依赖。
2. 分支与条件选项:choicesFn 可按 flag 与数值动态生成选项,textExtra 可在同一段文本后追加随数值变化的段落——隐藏数值能真正影响叙事,而不只是记个数。
3. 云存档适配:全部存档走平台的 writeSave / readSave / getSaveInfo,读档完成前禁止覆盖写,写入串行化加防抖,脱离宿主时优雅退回内存态。
4. 音频双通道:优先播放本地 mp3,加载失败自动回退到 Web Audio 程序化合成,保证任何网络环境下都有声。
5. 平台合规自检:scripts/validate.mjs 九项检查(入口位置、无手引 SDK、无外链 CDN、无 window.top、资源齐全、云存档、viewport、手势启动音频、体积),发布前一条命令跑完。
【目录结构】
index.html 引擎与全部剧情
assets/characters/ 9 张角色立绘
assets/scenes/ 14 张场景背景
assets/bgm/ 7 首 BGM
build.mjs 构建(按播放页尺寸压图输出 dist/)
scripts/dev-server.mjs 本地预览服务
scripts/validate.mjs 平台合规自检
package.json 名称 / 版本 / 五个必需脚本
【怎么跑起来】
npm install
npm run dev 本地预览
npm run build 产出 dist/
npm run validate 规范自检
【怎么改成你自己的】
换皮最快的路径:改 index.html 里的 STORY 对象写你的剧情,把 assets/ 里三类素材换成自己的图与曲,再改 package.json 的 name / slug / version。变量 {player_name} 会在渲染时替换成玩家输入的名字,可直接复用。人物名与头像映射集中在 NAMES 与 ASSETS 两处,改完即生效。
【使用条款】
源码可自由拉取、修改、二次创作与商用,保留出处即可。美术素材由 AI 生成,配乐取自 lumimaker 免费曲库,二次分发时请自行确认素材条款。
如果这个工程帮你省下了搭引擎的时间,欢迎在评论区说一声,也欢迎基于它做出你自己的船。
协议是 协议。
请打开 lumi.66rpg.com 回帖