加载中
《公主请和亲》开源工程说明
这是一款古言权谋文字游戏的完整源代码工程,已作为正式版作品发布到幻光文游社区。本仓库把从策划到上线的全部过程开放出来:你既能直接拿来玩,也能作为 Lumimaker 工程的参考样例学习,或在此基础上二创。
一、游戏是什么
你是大晟长公主李昭宁。北燕太子入京求亲,皇帝只给了三十日限期。每天三点余暇,你要在这座深宫里权衡亲信、势力与风险,或择一人订下名分,或集齐条件让这桩和亲整件事作罢。三十天倒计时结束,按五步短路判定得到 S / A / B / C / D 五档结局。
游戏包含 191 个场景、16 篇结局、26 条随机事件、8 条线索图鉴,六条可攻略恋爱线与一条独身掌权线,外加一条失败线。第 9 天万寿节选婿宴、第 23 天秋狝惊马与边关急报是两道关键闸门。
二、界面与玩法
界面采用橙光传统文游的横屏模式,舞台固定 16:9,所有元素按舞台宽度等比缩放,建议横屏全屏游玩。
左上角显示当前天数、剩余天数、三点余暇、当前任务与和亲之期进度。
主界面是昭阳殿卧室,女主立绘居中,右上方有半透明的内心心念气泡。
右上角设置里可存读档、开关声音、查看已见结局。
右下角可查看数值(信任、势力、资源、风险、安全)、好感(六人立绘与简介)、线索图鉴,并出门探索大地图。
大地图列出当日可探索地点,每个地点按钮都配场景图。
剧情用金边对话框加姓名牌与头像框呈现,选择后数值加减浮层自动出现并自动推进,余暇用尽自动入日终,用卷轴画面转场到次日。
三、技术栈
构建:Vite + React。
平台能力:@66rpg/lumimaker-sdk(云存档与平台接口)。
美术资源:本地 AI 生成的唯美古风二次元半写实 WebP 立绘、头像与场景图,共 41 张约 3 MB,无任何在线链接。
音频:本地化的古风背景音乐与点击音效,基调与正文一致,沉敛克制有暗流。
源码与资源全部本地化,不引用任何外部 CDN。
四、目录结构
docs/ 存放 D0 总纲、D1 人物库、D2 时间线、D3 路线与结局矩阵、D4 数值与判定、D5 交互文案与 UI 规范、D6 分卷剧本与写作规范、D7 测试用例与校验报告,以及 canon 唯一事实来源。
src/game/ 是运行核心,含判定器 judgement.js、状态机 engine.js、音频 audio.js、存档 save.js 与美术映射 art.js。
src/data/ 由剧本解析生成,请勿手改。
assets/art、assets/bgm、assets/se 分别是本地美术、背景音乐与音效。
scripts/ 包含解析、结局模拟、冒烟测试、文档总检、素材处理、文本修正,以及界面、落幕页、音频的实机检查脚本。
五、本地运行
在本工程目录下执行:
npm install
npm run dev
浏览器打开终端给出的地址即可游玩。
npm run build 把成品输出到 dist/,入口是 dist/index.html。
npm run validate 会依次执行剧本解析、结局模拟、冒烟测试与文档总检(77 项)。改了剧本后务必先 validate 再 build,游戏读取的是解析产物。
六、关于素材与再发布
本工程的美术与音频均来自幻光免费素材库或本地 AI 生成,请遵守幻光文游社区的相关素材使用与署名规范;二次创作或再发布时请保留本说明与出处。游戏正式版已发布到幻光文游社区,可在平台内搜索《公主请和亲》找到对应的可玩作品。
祝游玩与改造愉快。
协议是 协议。
请打开 lumi.66rpg.com 回帖
加载中