← 回成果库

环球旅行 2D · RPG —— 素材清单 / 互动模式 / 游戏方式 / 模块化拆解

• 对象:https://metazero-terminal.pages.dev/travel-2d/rpg(线上实测 2026-07-27 HTTP 200,标题 🧭 环球旅行 · 探索发现)
• 代码位置:web/terminal/travel-2d/(rpg.html 799 行 + rpg.js 3056 行 + 5 个玩法模块 + 6 个数据文件,合计约 56 万字符代码 + 2.37 MB JSON)
• 本报告目的:按主席要求,把这个项目拆成【可组合的大类零件】,为未来「换不同组合看不同效果」做地基
• 配套成品:模块组合实验台(可点开关、切配方、导出配置)+ 机器可读注册表 modules.json

---

一句话结论

这不是一个"游戏",而是一套【真实世界数据 → 可玩体验】的转换管线,已经攒下 8 个大类 71 个零件。

最值钱的不是任何一条玩法,而是那 12 个免 key 的公开接口 + 2.37 MB 本地素材 —— 换一套组合就是一个新游戏,而不用重新采一次数据。

但代码里现在没有任何一处"开关总闸",做组合只能手工注释,所以第一件该补的事是抽一个 world.config.js(见第五章 GAP4)。

---

第一章 · 可用素材总清单

1.1 地图与世界底座

> 卫星图有一个已修的坑值得记:Esri 在偏远地区的超高倍瓦片不是 404,而是返回 200 + 恒定 2521 字节的"暂无数据"占位图(实测乍得/中非/刚果 z18),代码里已做体积探针自动降级。

1.2 真实地点(全部实时拉,零预建库)

这一层是整个项目的地基:演唱会场地、跑腿目的地、人生清单的"那个地标",全部从它长出来。

1.3 人物信息

> 可玩性最高的一个旋钮:把 Wikidata 那句 P19 换成 P937(工作地)或 P20(逝世地),整座城的人就换了一批 —— 一行改动,完全不同的世界。

1.4 音乐(全部真实,零编造)

诚实边界(代码里已明写):部分国家 Apple 无商店或榜单为空(中国大陆榜仅 1 条、伊朗古巴返回 400),此时自动降级到曲库搜索并在面板上明写来源,不假装是当地榜单。

1.5 视频与图片

1.6 语言(最被低估的一块)

• 69 种语言 × 52 句 = 3588 句:每种语言 12 句基础短语 + 10 个数字 + 30 句街头通用模板
• 24 国文化特色包 × 30 句 = 720 句:只有那个国家的人才会说的话(如日本的「いらっしゃいませ!」进店必听)
• 合计 4308 句,每句三件套:当地文字 + 拉丁读法 + 中文意思
• 两层结构设计得很干净:gen 全球通用(按语言存)/ cul 文化特色(按国家存,因为西语各国各有各的说法)

1.7 任务与文案

---

第二章 · 游戏界面互动模式文档

2.1 屏幕分区(这套布局是这个项目最值得复用的设计)

`

┌──────────────────────────────────────┐

│ 顶栏 HUD:城市名 · 金币 · 🌐语言 ⚙️设置 │ 固定 44px

│ 🖼️图集 📒记录 🎞️视频 │

├──────────────────────────────────────┤

│ 🎬 多媒体舞台(可有可无,高度可拖) │ ← 关键设计

├──────────────────────────────────────┤

│ │

│ 地图 = 剩下的全部空间 │

│ 📍别针 🧑人 🎁宝箱 🎤音乐家 🏛️地标 │

│ │

│ 🔍缩放 ⭕按钮圈 │

│ 🧭小地图 (7+1) │

└──────────────────────────────────────┘

`

核心设计原则(owner 反复迭代得到的):多媒体不浮在游戏上面,而是切走屏幕上方一条,游戏用剩下的部分 —— 两者互不打断。

• 双开(视频+图片):顶部横条,5 档高度,下沿可用手指拖
• 单开:变成贴左上/正上/右上的浮窗方块,旁边和下面全露出地图,地图照常能点能拖

2.2 五种互动范式

② 是最标准的可插拔位:npcRing() 里的 items 数组加一项,就多一个互动动词 —— 未来任何新玩法都可以只做成"环上多一颗"。

2.3 互动动词全表(玩家能对世界做的事)

2.4 界面组件家族

• 气泡四兄弟:npcBubble(头顶身份牌,不可点)/ sayBubble(当地话)/ reply(回应,同屏多人错开冒)/ wayArrow(粉色发光指路箭头)
• 按钮圈:7 颗环绕 + 圈心 ✨,钉死在右下角固定高度区域,屏幕矮时整圈等比缩小,永远长不到顶栏去
• 弹窗壳:默认整体可滚;含 .dlgScroll 的改三段式(头 + 可滚区 + 常驻底部按钮)—— 治手机上"滚不动"
• 面板身份令牌:每个面板把自己名字盖在容器上,点击前先验章,章不对直接不响应 —— 结构性防串台,模块越多越需要它
• 三语:所有文案过 L3(中,英,日),加第四语言只需扩表

---

第三章 · 游戏方式(玩法循环)

3.1 一条完整的玩家路径

`

开场页(讲清玩法 + 发 10 万启动金 + 选目的地或随机)

↓ 从香港起飞,2D 卫星图上看着大圆航线飞过去,情绪横幅报里程时长

降落 → 🧭 导游主动搭话("欢迎来到 XX,这城有三件事你别错过")

↓

在城里走(步行 🚶 / 自行车 🚴 / 开车 🚗 三档速度)

├─ 遇到 🧑 职业 NPC → 聊天 → 免费解锁他那一维的当地视频

├─ 遇到 ⭐ 历史名人 → 先出简介卡,再开互动圈

├─ 开 🎁 宝箱 → 一首当地歌 / 现金 / 补给

├─ 走到 🏛️ 地标(未点开过的会发绿光召唤)→ 真实简介 + 实景照片

├─ 接 📦 跑腿单 / 载客 → 送到另一个真实地标 → 按距离给钱

├─ 📜 人生清单:每座城固定一条(按城名哈希),走到 120 米内即完成

└─ 📣 演出预告 → 箭头指路 → 买票 🪙180 → 满屏灯光特效演 3 分钟 → 散场余韵 45 秒

↓

🛂 盖章 · 攒里程 · 攒歌单 · 攒学会的外语句子

↓

飞下一座城(机票要花钱:短途贵/公里,长途摊薄)

↓

📒 旅行记录 → canvas 生成一张可保存的分享图

`

3.2 六条并行循环(互不阻塞)

这六条都往同一个地方汇流:trip 计数器(公里/城市/宝箱/听歌/看片/时长)→ 最后生成旅行报告分享图。

这是最好的模块化接口:任何新玩法只要往 trip 里记一笔,就自动进报告,不用改报告代码。

3.3 经济系统

存档:13 个独立的 localStorage 键,每个玩法一把。这是个现成的模块化优势 —— 拆掉任何一个模块,不会污染别人的存档。

3.4 世界的"活"从哪来

三个让世界不像死图的机制,都值得复用:

1. 密度随缩放调度:高空只铺 1 类人,街景铺 7 类;curGap 保证任意两人最小间距;超过 220 个实体自动回收远处的;每次缩放全清重铺

2. 演出会散场:一场演出挂 12 分钟就没了,演满 3 分钟自动散,走出 400 米算你自己离场,在城里待够 100 秒自动播报下一场 —— 世界不等你,它自己在动

3. 未访问的会发光:没点开过的地标发绿光召唤,点过就恢复普通

---

第四章 · 模块化组合矩阵(主席要的"多做几个组合看效果")

4.1 八个正交大类

合计 71 个模块。 层与层之间基本正交 —— 这意味着可以像调音台一样推拉。

4.2 八套现成配方

红队观察(对现状的最强反对):现在六条循环并行,新玩家落地 30 秒内同时被给到导游搭话、宝箱、演出预告、人生清单、路人冒泡 —— 注意力被切碎,每条循环都没被玩深。上面七个配方本质上都是对现状做减法,而做减法比做加法更可能提升体验。这一条可证伪:任何一个减法配方,如果单次游玩时长不如现状,那这个判断就是错的。

4.3 还能怎么组合(未列进配方的想法)

• 换名人属性:P19 出生地 → P937 工作地 / P20 逝世地 → 同一套代码,三个完全不同的世界
• 换底图:古地图瓦片 + 只留历史名人 + 关掉所有现代内容 = "时空旅行"
• 换飞行:恢复 3D 地球转场(资产现成),与 2D 版做 A/B 观感对比
• 特效引擎复用:演唱会的满屏均衡器 + 灯光配色,可以直接搬去做"节日 / 烟花 / 任务完成"的高潮时刻
• 箭头引擎复用:问路箭头已被演唱会复用了一次,证明它是通用的"去某地"组件

---

第五章 · 缺口与改造路线(按性价比排序)

建议顺序:GAP4(总闸)→ GAP2(遗产,最快见效的新玩法)→ GAP1+GAP3(策展内容 + 分类合并)→ GAP5(3D 转场 A/B)。

---

第六章 · 证据与红队自审

证据等级

红队:对本报告的最强反对

反对:「把项目拆成 71 个模块,本身就是过度工程。真正的问题可能是玩法不够深,而不是不够可组合 —— 拆得再细,组合出来的也还是同一批浅玩法。」

回应:这条反对部分成立,我接受它的一半。拆解不会自动让玩法变深,这一点是对的。但两件事使拆解仍然值得做:

1. 拆解过程本身已经找出两块被浪费的高价值资产(654 条策展内容 + 1864 处遗产地),这是纯粹的净收益,与"要不要模块化"无关;

2. 主席的诉求明确是"未来做成模块化、多做组合看效果",拆解是这个诉求的直接交付物,不是我自己加的工程。

但我把这条反对写进结论:GAP4 的总闸做完后,建议先只做 1-2 个减法配方并真玩一次,验证"减法是否真的更好玩",再决定要不要继续扩配方 —— 而不是一口气把八个配方都实现。

已知边界(不掩盖)

• 模块的行号锚点会随代码演进漂移,注册表里已注明"以文件名+函数名为准"
• 71 个模块的边界是我划的,不是代码里的硬边界;真要落地 world.config.js 时,某些模块可能需要合并或再拆
• 各配方的"开哪些模块"是设计判断,没有经过真人试玩验证
• 本报告未做性能测试(实体上限 220、多接口并发时的手机表现)

---

附:交付物