一套能直接跑的网页养成游戏模板:日程排期、属性成长、多期考核、多结局,数据全在 JSON 里,改数值不用读代码。
一套完整的养成游戏工程,不是空架子。前端 React 18 + TypeScript + Zustand,配置后台是 Express,内容全在 JSON 分表里。
内置《新乡的女儿》第一年——九岁到十岁、春夏秋冬四个回合:60 段剧情、24 个事件、10 个结局、15 个角色、10 个地点、15 个日程项,能一路玩到考核和结局结算。
界面是齐的:剧情演出、日程排期、地图出行、背包衣柜、结局收集、存档、配乐与音效、横竖屏切换、中英双语。素材 688 个文件、312MB,字体本地托管,不依赖任何在线 CDN。
换题材不用改引擎。属性名、货币名、地名、人名、考核线、结局条件都是表里的字段。改成宫廷、修仙、开店、校园,动的还是同一批中文名和数字。
它不包含:多阶段的长线养成(只配了一段成长期,四个回合)、联网、账号、云端存档。存档在浏览器本地。
一回合是一个季节,一年四回合。
排日程。 每回合两个槽位,从课程、打工、休息里挑。课程涨体魄、才情、自在、名望四项;打工换刀币;休息回精力。精力不够硬上课会失败,钱不够报不了名。
花行动点。 每回合两点,用来出行。十个地点——书院、铁匠铺、武馆、茶馆、瓦肆、钱行街、郡衙、卫辉古城、老街集市、面馆——可以买东西、见人、触发地点事件。
两条暗线。 谨慎↔果敢、天真↔圆滑。日程和事件一直在推这两根针,剧情分支和结局判定都读它们。
处关系。 十五个角色各有好感度。每回合只能互动一次、送礼一次,跟谁说话是要选的。好感最高的会走进恋爱线。
过考核。 期末考一次:四项属性总和 ≥ 20,且至少一项 ≥ 11。不过就是淘汰结局。
看结局。 十个,分淘汰、真·隐藏、好、普通、坏、恋爱六档,按剧情标记和数值算优先级。
一、人用后台点表单
双击根目录的 run.bat。它会装依赖、起后端(6983)和前端(5173),再打开浏览器。
游戏:http://127.0.0.1:5173/
后台:http://127.0.0.1:5173/admin
调试:http://127.0.0.1:5173/debug
不想用 bat,手动两条命令也行:
后台左边七组、二十四张表,从上往下就是建议的顺序:基础设定(属性、成长期)→ 养成循环(日程、经济)→ 出行与物资(地点、商店、道具、衣服)→ 角色与关系 → 叙事与终局(剧情、事件、结局)→ 开局与界面 → 数值平衡。另有新手引导的两个页面。
改的都是中文名、数字、下拉选项。点「保存(自动导出到游戏)」,它会写回 assets/source/ 的分表,同时合并出 assets/final_game.json。游戏刷新后就能看到。
二、让 AI 改
先让 AI 读根目录的 AGENTS.md。目录结构、命令链、哪些脚本会覆盖数据,都写在那里;README.md 是更偏人看的版本。
然后正常提要求:
「体魄上限从 25 提到 40」
「加一个采茶日程,涨才情 3、耗精力 10」
「把年考线从总和 20 降到 15,第一年别太紧」
AI 改的是 assets/source/*.json。改完必须合并一次:
也就是 node tools/build-final-game.mjs。不跑这一步,游戏读到的还是旧的 final_game.json。
分表和成品是两份文件,中间隔着一次合并:
只改了数值:跑 npm run build:data,刷新页面即可。
要出包、要预览构建产物:跑 npm run build,它重新构建前端,并把 final_game.json 内联进 dist/index.html。数据不重新构建,dist/ 里还是旧的。
检查素材有没有缺:跑 npm run validate。报「引用 N 条,缺失 0 个,外部链接 0 条」才算干净。
想直接看构建结果:node src/serve.mjs(默认 5173,可用 PORT=5180 改)。
build 和 validate 是原生 Node 脚本,本身零依赖;build 内部会调 frontend/ 的 Vite,所以那部分依赖要装好。
发成模板(给别的作者拉取):
工程的 package.json 里已经写好 slug、version、data_ver,升版本改这三个字段即可。
发成能直接打开的游戏:
双击 导出离线包.bat,或:
它会先合并分表、构建前端,再把脚本、样式和数据一起内联进 export/新乡的女儿/index.html,然后复制素材。双击即可玩,封面没有后台入口,后端也不参与。数据是内联的,改完数值要重新导出一次。
发成社区作品:npm run build 后用 npx @66rpg/lumimaker publish 上传 dist/。
分表和成品是两份。 assets/source/*.json 是源表,assets/final_game.json 是游戏真正读的成品。只改源表不合并,等于没改。后台点保存会自动合并,手改就必须自己跑 npm run build:data。
workspace/game 底下是链接,不是副本。 它的 assets/、source/ 都链到根目录的 assets/,真实文件只有一份。用资源管理器的复制、剪切去碰它,会把 312MB 素材展开成第二份;删它也有可能把真文件一起带走。要操作素材,直接动根目录的 assets/。
素材路径从根 assets/ 算起。 数据里写 assets/background/xx.jpg,实际文件就在 assets/background/xx.jpg。中文文件名可以,但必须和磁盘上的名字完全一致——包括扩展名。工程里就有一处写死 .png 而文件是 .jpg 的地方,改素材时容易碰上同类问题。
dist/ 是产物,不要当源码改。 每次 npm run build 都会覆盖。改了 dist/index.html 里的数据,下次构建就没了。
后台改的东西可能被同步脚本盖掉。 tools/sync-*.mjs、tools/import-*.mjs 这类脚本会按文档整体重写剧情和事件表,路径写死在作者原来的机器上,直接跑大概率报错,跑通了也会覆盖手工改动。用后台改完剧情别再跑它们。
tools/generate-seed.mjs 会重写全部分表,是早期原型用的,日常改内容别碰。
只有一年内容。 四个回合是样本。要做多年养成,得在 stages.json 里加阶段、延后 turnEnd,再补对应的事件、剧情和考核线。
后端只给开发和后台用。 玩家包不依赖 6983 端口,别把它一起部署出去。
字体别删。 assets/fonts/fonts.css 负责挂本地字体(思源宋体等 woff2),删了会退回系统宋体,界面气质全变。
依赖随工程带。 拿到就能双击 run.bat。如果你删过 node_modules,在 frontend/ 和 backend/ 里各跑一次 npm install。
run.bat 一键起前后端并打开浏览器
导出离线包.bat 打包成 export/游戏名/
package.json build / build:data / validate / dev / export:offline
src/ 构建、预览、校验脚本
assets/ 数据包(312MB)
source/ 24 张数据分表(改这里)
final_game.json 合并后的成品(游戏读这个)
background/ half/ CGx2/ title/ 日程/ 道具/ UI/ svg/
audio/ fonts/
frontend/ 游戏 UI + /admin 后台 + /debug
backend/ 配置 API,端口 6983
tools/ 合并分表、导出离线包、内容同步脚本
workspace/game/ 运行期视图;它下面的 assets/、source/ 链到根 assets/,不是副本
dist/ 构建产物,不参与模板代码包
export/ 离线包输出目录
请打开 lumi.66rpg.com 回帖
谢谢老师的模版啊!!!受我一拜