你大概率在小时候玩过那种游戏：屏幕上只有几行字，你敲 `go north`，它告诉你前面有一扇锁着的门；你敲 `look at door`，它说门上有个钥匙孔。没有画面，没有音效，但你愣是在被窝里玩了一晚上。这类游戏叫文字冒险（Text Adventure），上世纪七十年代起源于大型机，80 年代跟着软盘进过千家万户，后来被 3D 画面拍死在沙滩上。 但有个叫 Benji Kay 的独立开发者不这么想。据他自己的说法，现在的浏览器已经强大到能模拟当年游戏赖以生存的整个操作系统——那为什么不把文字冒险装回去？于是有了今天要拆的这个仓库：**okaybenji/text-engine**。 ## 仓库档案 - **仓库**：[okaybenji/text-engine](https://github.com/okaybenji/text-engine) —— "An HTML-based text adventure game engine"，一个跑在浏览器里的文字冒险引擎 + 一个示例游戏 - **⭐ 375 star / 68 fork**，语言 JavaScript，GPL-3.0 协议（这条对想变现的人很关键，后面细说） - **作者**：Benji Kay，个人账号，据其个人主页曾在 Google 做设计工程，2024 年还用同一套技术做过一款叫 Monkey Trap 的免费网页游戏 - **体量**：核心就一个 `index.js`，零依赖；`game-disks` 文件夹里放"游戏盘"；436 个 commit，最近一次更新在 2025 年 6 月 - **在线 Demo**：[okaybenji.github.io/text-engine](https://okaybenji.github.io/text-engine/)，打开即玩，另在 itch.io 上有页面（okaybenji.itch.io/text-engine） 注意它的定位：**引擎 + 游戏盘，而不是一个孤立的游戏**。仓库里附带的 demo 游戏本身就是完整可玩的冒险，而任何人拿它做自己的游戏，本质上就是"写一张新软盘"。 ## 这游戏是什么 一句话：**你负责打字，引擎负责让世界回应你**。 打开 Demo，屏幕是一个复古终端：橙色文字，光标闪烁。你处在一个房间里，引擎会打印房间描述和里面的东西。你输入 `look at desk`，它描述桌子；你输入 `take key`，钥匙进背包；你输入 `talk to waiter`，他给你一堆可以聊的话题，每个话题前面标着大写关键词，你敲关键词就把天聊下去。走到锁门前敲 `use key`，门开了——就这一个瞬间，多巴胺跟四十多年前一模一样。 核心循环长这样： ```mermaid flowchart LR A[读一段文字描述] --> B[输入指令
look take go talk] B --> C{引擎解析} C -->|认识这个词| D[世界变了
拿到道具 开门 剧情推进] C -->|不认识| E[无效反馈
好奇心加一] D --> F[冒出新线索或新出口] E --> B F --> A F --> G{结局} G -->|卡关| B G -->|通关| H[换一张新盘 再来一局] ``` 整个游戏的数据被作者叫做"disk"（软盘），其实就是一个返回 JSON 的函数：顶层必须有 `roomId`（玩家当前在哪）和 `rooms`（所有房间）。每个房间有描述 `desc`、出口 `exits`、可捡的 `items`、可对话的 `characters`。也就是说，**做一张新盘 = 写一份 JSON**，几乎不用编程；想加戏，才需要在 `onEnter`、`onUse` 这些钩子里写几行 JS。仓库里的 `newDiskTemplate` 就是为这个准备的模板。 ## 为什么上头 文字冒险这个品类被验证了五十年，它的“上头机制”其实非常现代，拆开看全是今天手游在用的东西： **1. 解析器就是老虎机。** 你永远不知道哪个词能触发反应。`look`、`take`、`use`、`talk` 是基本功，但 `unlock`、`flip`、`push` 这些隐藏动词全靠猜。每猜对一个，等于拉动一次拉杆中奖——这是典型的“猜测-奖励”循环，跟 Wordle 让你猜五字母单词是同一种快感。text-engine 还专门做了**命令自动补全**（2.0 版加入的，作者在致谢里专门感谢了帮他设计这个功能的朋友），把“打错词的挫败”压到最低，让猜词的快乐留在原地。 **2. 物品栏就是进度条。** 你的 `inventory` 从空到满，每捡起一样东西，都是系统在告诉你“你变强了”。而钥匙开门这类设计，本质是“先给锁、再给钥匙”的经典钩子——玩家先看见目标（上锁的门），动力就自动产生了。 **3. 对话系统是收集玩法。** text-engine 的角色对话用 `topics` 实现：每个话题有 `option`（显示的选项）和 `line`（选中后说的话），还能设置 `prereqs`——必须先聊过某话题，新话题才会解锁，`removeOnRead` 控制聊过即消失。这不就是对话形式的收集图鉴吗？玩家会下意识把每个 NPC 的话茬聊干。 **4. ASCII 画是彩蛋奖励。** 房间可以配 `img` 字段放 ASCII 艺术图，进入就打印。在没有美术成本的前提下，这反而是最便宜的“哇”时刻。 **5. 单局成本趋近于零。** 打开网页就能玩，一条指令一秒钟，卡关了随时 `save`。这种低摩擦恰恰是网页小游戏最值钱的特质——留存靠的不是大坝，是水龙头。 ## 技术拆解 这个仓库对开发者的价值，一半在“能抄的架构”，一半在“能复用的组件”。 **零依赖单文件架构。** 全部引擎逻辑在 `index.js` 里，通过 `