RPG Game designer

This skill enhances "SECOND BRAIN" for custom player memories. It covers full-color pixel RPG design: palettes, tile scenes, dialogues, memories, CGs, rhythm games, and dynamic BGM in a single HTML5 file. Play here:https://evernotebot.itch.io/secondbrain

RGB Studio · 全彩像素叙事 RPG 设计技能

把一款全彩像素叙事 RPG从零做到可上架的完整方法论。 本技能提炼自已完成并上架的《第二大脑 SECONDBRAIN》第 1–4 章—— 四章主线(平凡生活→启程群山→禅室觉醒→草甸新路)、10×9 瓦片场景、三语文案、 75 情绪图鉴、30 条禅语、9 处可收集记忆、两类小游戏、随海拔流转的四季 BGM， 全部装进一个单文件 HTML。

原作是 GB 四阶绿；本技能是它的全彩(RGB)分支——保留全部经过实战验证的 叙事与系统设计，把"四阶绿约束"替换为"全彩色阶体系"。

详细逐步操作见 references/SOP.md(必读，含每一步的命令与代码模板)。

---

〇、适用范围(先确认再开工)

✅ 适用	全彩像素、叙事驱动、章节制、探索+对话+轻机制、单文件 HTML、疗愈/文艺向
↔️ 分流	目标是 Game Boy 四阶绿(160×144·DMG 复古掌机风) → 改用 gameboy-game-dev 技能
❌ 不含	战斗/数值成长/装备背包系统、3D、多人联机、需要引擎(Unity/Godot)的项目

第 1–4 章的设计之所以成立，是因为它只做探索、对话、情绪与轻机制—— 把战斗与数值全部砍掉，才换来了叙事密度。要做 RPG 战斗系统，本技能不适用。

---

一、五条设计基石

1. 单文件原则：代码/美术/地图/音频/文案全在一个 HTML 内，零外部请求。 美术是索引字符串 + 调色板表，音乐是 MIDI 音符数组。双击即玩、离线可玩、一个 zip 上架。

2. 全彩＝有纪律的彩，不是随便的彩：不是"想用什么色就用什么色"，而是 主调色板(16–32 色) + 若干条色阶(ramp)。每个物件从一条 ramp 里取暗/中/亮三档， 全局统一光照方向。禁止在绘制代码里写裸色值——只准引用调色板常量。 (GB 项目靠 4 色天然统一；全彩必须靠 ramp 纪律人为维持统一感，否则立刻变脏。)

3. 叙事驱动系统：先有"这一章要让玩家感受到什么"，再决定加什么机制。 第 3 章要"第一次听见自己的呼吸"，才有了禅走与禅语；第 4 章要"喜悦很简单"， 才有了呼吸引导坐禅。没有情绪目标的机制一律砍掉。

4. 章节冻结原则：通过验收的章节即冻结区。任何新功能上线前， 全量回归必须证明旧章行为不变(通关流程/记忆数/情绪数)。

5. 音频程序化：所有声音由 Web Audio 现场合成(振荡器+噪声)，零音频文件。 全彩不代表要上真人配乐——单文件原则优先。BGM 用 MIDI 数组 + 音序器实时演奏， 随场景/环境切换。明确排除：<audio>、new Audio()、mp3/ogg/wav、TTS。

---

二、第 1–4 章验证过的系统清单(照抄即可用)

这七套系统是四章跑通的骨架，任何叙事 RPG 都能复用：

系统	核心做法	来自
瓦片场景	10×9 网格、T=16px；SCENES={id:{map,night,start,npcs}} 注册表；SOLID 集合管碰撞	全章
对话	行=数组 ['情绪码',中,英,日]；startDialog(lines, 回调)，回调切场景/结算	全章
情绪图鉴	台词携带情绪码 → EMOTRIG 映射 → checkEmo() 收录 → 75 条图鉴	全章
AI 陪伴页签	暂停菜单 5 页签(交谈/技能/记忆/语言/系统)；"交谈"页按 chatState() 显示当前情绪与心声	全章
可收集记忆	关键交互 addMem(中,英)；四章共 9 处；结算与图鉴可回看	全章
CG 插画	cg='key'; SFX.cg(); + startDialog(..., ()=>{cg=null;})——过场用 CG 定场再拉回场景	全章
环境流转	trailSeason() 按玩家 y 坐标返回春/夏/秋/冬 → 同时切 BGM 与季节字幕(150 帧浮现)	第 2 章

存档字段(localStorage 一个 key，try/catch 包住)： ch, sceneId, flags, progress, mem, LANG, soundOn, seenHowto, textSpeed, fontBig, emoSeen, curEmo, started, px, py, zenSeen

---

三、两类小游戏原型(第 3、4 章验证)

叙事 RPG 的小游戏不该是"考验操作"，而是让玩家用身体经历那个情绪：

1. 推进型 · 禅走(第 3 章)：镜头帧推进 zenApproach 从 0 到 N， A/B 可跳过(直接置 N)；抵达后进入抽取(zenpick) → 逐字揭示(zenreveal， zenRevN/zenRevTotal 计数)。用于"仪式感的接近与领受"。
2. 节奏型 · 坐禅(第 4 章)：A+B 组合键启动 → 难度选择(初心者/上级者) → 呼吸引导 吐 8000ms / 吸 5000ms(慢而深)，配"吐气/吸气"字幕与两张姿势 CG → 结束起身动画。用于"把顿悟收回到呼吸这件最小的事上"。

通用规矩：每个小游戏＝一个 state 字符串，必须在四处登记 (状态变量 / loop 更新 / loop 绘制 / onPress 输入)，且必有跳过路径。

---

四、全彩美术管线(与 GB 的关键差异)

1. 建调色板：先定 4–6 条 ramp(肤色/植被/木石/织物/天空/金属)，每条 4–5 档。 全局 PAL={ramp名:[c0..c4]}，绘制只引用 PAL.wood[2] 这种索引。
2. 参考图 → 像素：PIL 裁 4:3 → LANCZOS 缩到目标分辨率 → 量化到你的主调色板(而非亮度四分位)：用最近邻色距离匹配 + Floyd–Steinberg 或 Bayer 抖动 → 输出"每像素一个调色板索引"的字符串行 → 注入 CG={}。
3. 昼夜/情绪染色：不再靠"整体降一档"，改用染色函数—— 对最终帧做一次色相/明度偏移(夜=偏蓝降明，回忆=偏黄降饱和)， 场景注册表里 night:true 触发。
4. 精灵：字符网格，一字符=一个调色板索引，.=透明；主角 16×28、小跟班 14×19 档； 翻转靠 flip 取 row[w-1-xx]。
5. 彩色纪律的验收：全彩最容易死于"脏"——每张新美术都要和已有场景并排截图比对， 确认没有引入 ramp 之外的杂色。

---

五、叙事设计要点(四章提炼)

• 一章一情绪：01 麻痹 → 02 决断 → 03 觉醒 → 04 安住。章名即情绪落点。
• 章节制 + 隐藏内容：菜单只列公开章(硬编码 for(let i=0;i<公开数;i++))， 隐藏内容只能经剧情选项进入。
• 引导靠拒绝：顺序外的交互返回一句提示，用 flags 记录前置是否完成。
• 环境即叙事：第 2 章不写"他走了很久"，而是让海拔改变季节—— 玩家自己"走"出了时间流逝。
• 三语同步：文案数组一次写齐(中/英/日)；英文最长，用英文验收框宽。
• 逐字演出：关键台词逐字浮现 + 每字一声 tick(0.5 字/帧)， 首次 A 补全整句、再按 A 收束。

---

六、测试与发布

三层测试栈，每里程碑全跑：

1. Node headless 逻辑回归：stub 环境 + ctx 用 Proxy 吞掉 + 尾部 return {内部句柄}； 脚本化按键序列跑完四章。标准断言：情绪全触发、每章 progress、 记忆数不变(冻结区证明)、菜单只列公开章、小游戏可跳过可完成。
2. Playwright 真机截图：evaluate 直跳目标画面截图——文字出框、色彩脏否、 精灵比例全靠这步；全彩项目必须比对色板一致性。
3. grep 抽查：禁用词为零、调色板外裸色值为零(grep -oE "#[0-9a-f]{6}" 应只命中调色板定义处)。

发布：zip(index.html + README_上架指引.txt)；README 含操作键位、 音频解锁提示、章节流程表、特色列表、上架四步。

---

何时读 SOP

• 从零起项目 → SOP §1–§3
• 建全彩调色板与染色 → SOP §2
• 新场景/新章节 → SOP §4
• 对话/情绪/记忆/存档系统 → SOP §5
• 参考图转全彩像素 → SOP §6
• 设计新小游戏 → SOP §7
• BGM/音效与环境流转 → SOP §8
• 回归测试与发布 → SOP §9–§10
• 反模式清单 → SOP §11