Hey, Listen! – Make Your Own Tutorials

Hey, Listen! – 制作你自己的教程

让整合包亲自教玩家，而不是丢给他们一个 Wiki 链接。

每个大型整合包都有同样的问题：新玩家加入后，打开一台从没见过的机器，而你能给他的帮助只有一个为其他版本编写的 Wiki 链接。于是他们切出游戏，或者在聊天里提问，或者干脆离开。

Hey, Listen! 让你可以亲自在游戏中编写帮助内容，并指向实际的目标。教程步骤会让屏幕变暗，在关键按钮上挖出一个高亮区域，再显示一句提示；只有玩家真的完成了操作，教程才会继续。

一个步骤，三项功能

• 变暗。除了你指向的目标，其他地方都会变暗，让玩家一眼就能看清重点。
• 指引。在暗幕上开一个洞，再加上箭头、方框、圆圈或你自己的图片，放在槽位、按钮、HUD 区域或屏幕上的任意位置。
• 门槛。玩家完成指定操作前，步骤不会继续。操作可以是打开界面、点击槽位、按下按键、挖掘方块、拾取物品或获得进度。

高亮始终停在正确的位置

这正是让教程经得起整合包更新的关键。

所有内容都不会以像素坐标保存。每个标记都依附于一个父级：槽位 36、标有“制作”的按钮、快捷栏，或带黑边的虚拟画布。每一帧都会重新解析父级的位置。

在步骤进行中调整 GUI 缩放，高亮仍会对准槽位。调整窗口大小、切换分辨率，或者某个模组把自己的窗口挪动了四个像素：高亮依旧在正确位置，因为它从来就不依赖像素坐标。

不只是教程，还有任务

步骤可以等待由服务器自行验证的条件，这意味着教程也可以是任务。

让步骤以一项进度为门槛，就无法伪造或只完成一部分：游戏已经判定了什么才算完成。要求玩家收集五块圆石，角落里的计数器会自动计数。完成后，还可以通过任意命令奖励玩家。

指南知道何时该安静

指南有两种状态，模组会自动选择合适的状态。

讲解时，玩家会看到完整面板和角色肖像。一旦步骤只是在等待玩家去完成某项操作，指南就会缩成角落里的一张小卡片，只显示目标；暗幕随之消失，玩家可以自由游玩。

角色就是文件夹

一个角色对应一个图片文件夹，一个表情对应一个文件名。

把neutral.png和happy.png放进config/heylisten/characters/herald/，你的指南就做好了。加入happy_talk.png后，文字逐字显示时，角色的嘴巴也会跟着动。这一切都不需要 JSON。PNG、JPG、BMP 和 TGA 格式均可加载。

用对话取代 NPC

角色肖像、一段台词，以及两个到四个可以分支的回复按钮。回复可以设置供后续步骤读取的玩家个人变量；即使死亡或退出游戏，这些变量也会保留。

它能为你的整合包实现过去 NPC 所能做到的一切，却不需要玩家特地走到 NPC 面前，也不必把对话存进世界存档里，随存档一起消失。

只需一条命令即可编写。

教程是普通的 JSON 文件，放在 config/heylisten/tutorials/ 中即可。放入文件、重新加载，就完成了。整合包作者也可以将教程作为数据包发布，这样教程就能和整合包的其他内容一起纳入版本控制。

它会教你如何使用自己

模组自带两节课程，它们直接写在模组里，因此你会在循序引导中学会如何使用它。

如何制作教程会在你体验教程的过程中拆解自己。它会显示你正在阅读的文本，并指出文本来自哪个字段；它会调暗屏幕并告诉你是哪一个元素造成的；它会在快捷栏上方挖出一个洞，让你看懂什么是父级；接着，它会停止讲解，等你真正打开聊天框，让你亲身感受带门槛的步骤是什么样的。

如何制作任务会给你选项，让你亲眼看到分支如何展开；它会为你设置一个变量，并告诉你用什么命令读取变量；然后让你去破坏一个方块，在你动手时不再打扰你。

运行 /heylisten start heylisten:how-to-make-a-tutorial，从这里开始吧。

文件夹会自我说明

你无需离开游戏查找语法。每次启动时，模组都会在同一文件夹中重新生成 HOW-TO-WRITE-A-TUTORIAL.md：一份包含完整格式的文档，列出所有键、所有合法值、原版物品栏的槽位索引，以及关于未使用原版控件的界面的警告。

你写的任何内容也不会导致游戏崩溃。文件中无法识别的键会被忽略，而不是导致加载失败；/heylisten validate会准确告诉你忽略了什么以及原因。

不会让任何人卡住

会困住玩家的教程还不如没有，所以这个模组绝不会这么做。

• /heylisten validate会在教程发布前检查是否有步骤把玩家锁在该步骤要求他们使用的功能之外。
• 无论步骤要求锁定多久，所有输入锁定都有由配置设定的硬性上限。
• 死亡会解除锁定，然后 会从你离开的地方继续任务，而不是悄悄把任务删掉。
• 登出时会解除所有锁定。

需求

支持单人游戏和服务器。状态按玩家分别保存，并由服务器负责判定，因此一名玩家的教程绝不会影响其他玩家。

如实说明

这是一个早期 Alpha 版本。运行时功能已经完整，也已从头到尾实际测试过，但安装前有两点值得了解。

目前还没有附带默认的教程插画，因此在你放入角色文件夹之前，第一个教程只有声音，没有角色形象。另外，像 Create 和 MineColonies 这样使用自定义界面而非原版控件的模组，目前尚未验证其槽位和控件高亮功能。在界面上运行 /heylisten debug，即可查看它实际提供的内容；如果没有提供任何内容，就改用界面父级。

欢迎并鼓励提交 Bug 报告。

支持这些模组

这些模组永久免费。如果你在服务器上运行了其中任何一个，可以前往 patreon.com/epicwarborn 支持后续版本、移植和新模组的开发。支持者的名字会列入鸣谢名单，还能直接联系我反馈 Bug、抢先体验测试版，并投票决定接下来开发什么。

别再贴 Wiki 链接了，直接指向那个按钮。

这是 barunn 创作的 Warborn Realm 的一部分