《言刃:断章》是一周目约一到两小时的动作冒险文字 RPG:在一座说完话就消失的城里,用动词加词缀拼词出招——限时指令窗、QTE 闪避、连句 COMBO、沉默槽处决。正式版 1.7.1 已在文游发布区上架,这是它的完整源码,面向想学习、改造、二创的创作者。
【怎么跑起来】
零外部依赖、零 CDN,构建脚本只用 Node 自带能力写成。拿到源码后三步:
1. npm install(装平台官方 CLI @66rpg/lumimaker,只有构建脚本用)
2. npm run build(把 src 七个文件拼装成 dist/index.html 单文件)
3. 双击 dist/index.html 就能玩,断网也能玩,手机浏览器直接打开即可。
平台打包时自动排除 node_modules、dist 和 lock 文件,所以拉到源码后请先跑一次构建。
【源码结构】
src/index.html 页面骨架与全部静态弹层
src/style.css 全部样式(手机竖屏 flex 与横屏三列两套布局,无框架)
src/core.js 共享状态、存档读档与迁移、渲染、音效(WebAudio 现场合成,无音频文件)
src/data.js 全部文案与数据表:剧情、敌人、词库、结局、帮助
src/engine.js 战斗流程、地图、剧情引擎、结局
src/guide.js 新手引导(按实测尺寸定位气泡,不写死宽高)
src/sdk.js 平台 SDK 只读接入,无平台环境时静默降级
scripts/build.mjs 构建脚本:占位符拼装,外加红线扫描与体积上限校验
scripts/validate.mjs 发布校验(按钮接线、数据完整性等 10 项)
scripts/test-story.js 剧情回归,69 条断言
scripts/test-features.js 战斗特性回归,58 条断言
scripts/playtest.js 假时钟自动试玩,数值平衡抽样
scripts/serve.mjs 本地预览服务
【改动的建议路径】
改文案只动 src/data.js;改数值平衡先跑 scripts/playtest.js 抽样对比;改布局注意手机竖屏(约 500px 以下一套)与横屏两套都在 style.css。每次改完跑 npm run validate 和两个回归脚本。构建脚本会自动扫外链、动态执行等 12 类红线关键词,命中直接拒绝出包。
【几个值得看的实现】
1. 剧情续播链:过场进度(pendingStory、pendingSeq、pendingThen)全部落盘,中途退出刷新后能从断点重建整条过场链,不丢段、不断链。
2. 存档健壮化:normalizeSave 对负数属性、空词库、非法续播字段全部兜底修复,坏档可救。
3. 限时指令窗与 QTE 由 scripts/playtest.js 注入的假时钟驱动,可脱离真实时间做整场数值回归,平衡改动不用靠手感。
4. 引导气泡按实测尺寸计算方位(下方、上方、左右、居中逐级回退),长文案不会被截断。
【两点约定】
一,图与音全部程序生成:界面用 CSS,音效用 WebAudio 现场合成,所以包里没有任何二进制素材,工程天然轻量。
二,欢迎对代码、结构、玩法做学习与改造。
协议是 协议。
加载中