加载中
《小梨的初遣日记》开源工程
这是一个已经完整跑通、可以直接上手的单文件 HTML 文字游戏工程。四岁的小梨第一次带着爸爸写的购物清单独自出门,走过小卖部、蔬菜店、肉铺、花店和面包店,而爸爸妈妈一路躲在电线杆和货架后面偷偷看着她。整部作品没有失败结局、没有倒计时,点错了也只是被老板温和地提醒一句。
把它开源出来,是想给刚接触幻光(Lumimaker)的创作者一个能照着改的完整样例:文案、配置、美术、音频、构建、测试,全都在本地,改完就能重新打包。
工程里有什么
源码一共六个文件,纯前端、零框架、零外部依赖:
src/index.html 页面骨架
src/style.css 全部样式与动画
src/art.js 立绘与场景(含内联 SVG 兜底图)
src/audio.js 用 Web Audio 现场合成的音效与 BGM
src/game.js 主循环、小游戏、彩蛋、结局
src/data/config.js 结构配置(物品、价格、章节、钱包)
src/data/script.js 不用手改,它由文案自动生成。
游戏里的所有文字都不在代码里,而是集中在《文案编辑/作品完整文案.md》。用记事本打开就能改,改完跑一句 npm run copy:export,新的台词、选项、数值就同步进游戏了。编剧和程序可以完全分开工作。
技术上的几个选择
单文件产物:npm run build 会把样式、脚本、立绘、音效全部内联进 dist/index.html,不引用任何外部资源,也不联网。丢给浏览器就能玩。
音频是算出来的:工程里没有一个音频文件。九套环境 BGM 和音效全部由 Web Audio 实时合成,随场景切换淡入淡出,因此包体很小,也不用担心外链失效。
立绘防闪:同一角色的多个表情叠在一层,用透明度切换,配合预加载,切表情时不会闪一下白。
小屏适配:对话框宽度跟随画面,清单浮在左上角,小屏下立绘不会被选项挡住;清点面板这类内容多的浮层用 safe center 居中,避免溢出裁顶。
不含平台 SDK:游戏本身完全不调用 LumiMakerSdk,因此在已登录、试玩未登录、无 SDK、未受信外壳这四种环境里表现一致。
怎么跑起来
npm install 只需要 @66rpg/lumimaker 这一个开发依赖
npm run dev 本地预览
npm run build 构建到 dist/index.html
npm run validate 校验文案、配置、美术是否对得上
npm run smoke 从头到尾自动跑一遍,确认流程不卡死
npm run copy:export 把文案重新导出成游戏数据
想改成自己的故事
1. 改《文案编辑/作品完整文案.md》里的台词、旁白和选项。
2. npm run copy:export 导出,npm run validate 校验。
3. npm run smoke 自动通关一遍,确认没有卡住的分支。
4. npm run build 出包,然后 npx lumimaker publish 发布。
美术素材在 assets/ 下,按立绘、背景、封面分目录;想换皮就替换同名文件,不用动代码。
关于素材与授权
代码按 MIT 授权,可以随意取用、修改和二次发布。美术素材由 AI 生成后人工清理,随工程一并放出,供学习和二次创作使用;如果要拿去商业用途,请先自行确认素材授权。
安全声明
本作是童话模拟。现实中四岁的孩子不可以独自出门;剧情里父母全程隐形跟随,不鼓励模仿。
如果你也用它做了自己的故事,欢迎在社区里说一声,我很想看看小梨这条商店街上还会长出点什么。
协议是 协议。
请打开 lumi.66rpg.com 回帖