cbfd4d871b
固化 Match-3 生产者、视觉、音频与双 Judge 证据闭包。 将《山海行纪》r1.1 绑定新的不可变 release，并以生产预检现场核验 bundle、Registry/2 和 25 项 Writer 快照。 同步地图1平衡锁值、跨游戏回归修复、验收契约与 SoT 证据。
_template-trpg — A-model「掷骰爬塔」TRPG 品类黄金骨架(3 层架构)
一个可玩的完整掷骰冒险游戏:勇者限时闯一座试炼塔,每层翻出几张遭遇卡(怪物/宝箱/奇遇,难度与奖励亮牌)→ 点一张卡 = 掷 d20 加等级加成对抗难度 → 大成功/成功/失败三档结算(战利品金币、经验升级、怪物卡失败扣血)→ 清层登上一层、难度渐升 → 登顶 win / HP 耗尽 lose / 60 秒到点结算(menu→play→over)。这份骨架已经把整套掷骰爬塔循环接好了(含可选的调试视图)——你的活是按 brief 换皮,不是重写循环。
怎么改 = 给这场冒险换题材,循环结构别动:
- 换题材/遭遇/数值 → 改
src/core.js顶部的「多样性参数空间」(ENCOUNTER_DECK遭遇表、层数、血量、难度曲线、经验曲线)。魔塔写史莱姆/骷髅卫,西游写小妖/山神庙,星际写巡逻机甲/补给舱——同骨架做出不雷同的冒险就靠这里。 - 换观感(塔长啥样/卡面画法/配色)→ 改
src/render.js。 - 想加机制(道具/技能/事件链)→ 在
src/game-logic.js循环里加。 - 别推倒重写整个循环:翻层/掷骰判定/三档结算/升级/连胜/登塔都接好了,从它起步只补身份,远比从零写省。
3 层 + 你只碰 L3
| 层 | 文件 | 你 |
|---|---|---|
| L1 固定 plumbing(write 会被拒) | index.html · entry-bundle.js · src/host-config.js(已注入全 11 插件 + viewport 390×844 + wiring) · src/game.js(薄 wrapper:摊平 opts.runtime → 交 game-logic) |
不碰 |
| L3 游戏本体(已是完整掷骰冒险) | src/game-logic.js(掷骰爬塔循环 + 五法 + 取证契约) · src/core.js(纯逻辑 + 多样性参数空间) · src/render.js(观感) · src/assets.js(资产装载) |
在这上面换皮 |
入口契约(钉死)
// src/game-logic.js —— 掷骰爬塔循环已写好,你换身份
export function createGame({ plugins, bundle, viewport }) {
// 插件已扁平注入(全 11 件,用到才解构);本骨架掷骰档用 6 件:
const { sceneFsm, sessionScore, hudUi, timerScheduler, audioMusic, juice } = plugins;
// 全部可用键:sceneFsm sessionScore hudUi timerScheduler save gamefeel juice palettePost audioMusic collision physics
return {
async init(boot) { const ctx = boot.ctx; /* 装资产→定义场景→start;输入不订阅(L1 派发到 handleTap) */ },
update(dt) { bundle.tick(dt); /* ★必调;再推进玩法 */ },
render(g) { /* 画在 g;读 viewport.w/h */ },
handleTap(x, y) { /* ★输入入口:各 phase 点击逻辑;L1 在 pointerdown 时直达调用(别自己订阅输入) */ },
destroy() {},
_forensicsView() { return { state(){ /* phase/score/targets 实时算 */ }, measures(){} }; }, // 可选调试接口(验收不读)
};
}
铁律(check 会拦)
- 入参扁平
{plugins, bundle, viewport}—— 没有 opts、没有 opts.runtime、没有 ctx(L1 已摊平)。受控面 ctx 只在init(boot).boot.ctx(时间/随机/输入/引擎)。 - 插件直接
const {…} = plugins—— 别写opts.runtime.plugins(L1 内部的,你见不到)。游戏只用、不 new、不 register。 update(dt)必调bundle.tick(dt)—— 否则 timer-scheduler/gamefeel 等 onFrame 不推进、timer 永不到期、一局不结束。dt是秒:游戏内毫秒计时要elapsedMs += dt*1000;timerScheduler.after(ms)收毫秒(60s 写 60000)。- 零引擎 import(引擎经
boot.ctx.getEngine());游戏源零裸 Math.random/Date.now/setTimeout/new AudioContext/addEventListener —— 时间随机经 boot.ctx,定时经 timer-scheduler,音效经 plugins.audioMusic;输入不调 ctx.getInput——写实例方法handleTap(x,y)(点击)/handleKey(key)(键盘),L1 在 pointerdown/keydown 时直达调用。 - 插件方法名一律以
src/plugins/<name>/api.d.ts为准,别臆测(scene-fsm 是define不是 defineScenes)。本骨架已用对的母语写法:sessionScore.add(n)计分、juice.burst(x,y)爆点、hudUi.drawButton(g,rect,opts)返回命中矩形可直接接住判命中。 - 画面读
viewport.w/h,别硬编码 390×844。 _forensicsView()是可选调试接口:state() 实时导出层数/血量/金币/卡态等,供人工调试观测;W-AXIS-V2 起验收不再读它(验收 = 四门投影 ∧ 测试 agent 真玩)。失败也有安慰 1 金(保底正反馈,连败不空手)。- 掷骰过程可见:判定式(d20:骰值+加成 vs 难度 → 结果)要飘字亮给玩家——绝不黑箱出结果,「看得见的随机」是 TRPG 手感之根。
你写什么 vs 调什么
- 你写(玩法身份):题材/遭遇表/数值(core 顶部参数空间)、观感与命中区(render)、把身份接到已写好的掷骰循环(game-logic 一般只微调)。
- 你调(通用机制):计分
sessionScore· 场景机sceneFsm· UI 原语hudUi· 受控定时timerScheduler· 持久save· 手感gamefeel· 粒子juice· 后处理palettePost· 音频audioMusic· 碰撞/物理collision/physics(全已注入,用到才取)。
详见 .agents/skills/littlejs-game-dev.md(11 插件 API 速查 + ❌→✅ 易犯错)与 .agents/skills/trpg-game-design.md(TRPG 品类「设计什么才好玩」)。