Vocation

作者：Vazkii

一款模组，允许整合包制作者等添加带有触发条件和动作的语音消息叠层。

模组 Forge 冒险地图与信息服务器工具

介绍

介绍由机器翻译自 CurseForge 原页面，仅供参考。

Vocation

懂了吧，因为她是个职——算了。

Vocation 是一款会在屏幕上显示文字（以及配音）消息的模组。可以看看那个视频，里面有一段简短演示（不到 1 分钟）。这款模组面向整合包开发者及类似用户。我某天直播时花了大约 7–8 个小时做了这个模组，所以它可能没那么厉害。

演示中展示的“教程”不包含在模组内。

如何开始使用：

安装 Vocation（服务器和客户端都需要安装此模组）
启动游戏一次
在 mods 和 config 文件夹旁边找到 vocation_data 文件夹
在其中创建一个文件夹，名称随意。你要把自己的内容放在里面
如果需要配音或音效，请在刚创建的文件夹中创建一个名为 “audio” 的文件夹
在你创建的文件夹中（不是 “audio” 文件夹）创建一个文件，名称随意，但必须是 .json 文件。你可以创建任意数量的文件。
将消息放入你创建的 .json 文件中。消息数量和存放位置都没有限制。支持多个文件只是为了方便你整理。
确保服务器和客户端上的文件一致。服务器上可以缺少音频文件，但 .json 文件必须一致。

消息格式：

你可以在这里获取示例文件，也就是演示视频中使用的文件。建议你先读完下面的内容再查看，这样就能更好地了解如何使用。

消息采用标准 JSON 格式。文件主体必须是一个简单数组：

[

(在这里填写你的消息)

]

你可以在数组中放入任意数量的消息。下面是单条消息的格式：

{
“id”: “(这条消息的 ID)“,
“message”: “(要在屏幕上显示的消息)“,
“narrator”: “(显示在消息上方的名称)“,
“time”: “(希望这条消息在屏幕上显示多久，以刻为单位)“,
“voiceover”: “(这条消息出现时播放的声音，必须是位于 audio 文件夹中的 .ogg 文件名，可选)“,

“requirements”: (一个消息 ID 数组。玩家至少看过其中的消息一次后，触发条件满足时这条消息才会显示，可选),

“triggers”: (触发这条消息显示的条件；任意一项满足时，消息就会显示，可选；稍后会介绍触发条件的格式),

“actions”: (这条消息显示时会执行的操作，可选；稍后会介绍操作的格式)
}

虽然 “message” 不是可选项，但你可以将它留空。留空后，消息不会显示，但仍会被计为已看过，其操作也仍会执行。你可以用这种方式让某些事情在满足条件时发生，或者创建更复杂的条件链。

触发条件也是可选的，因为你可以使用命令来显示消息；如果不想设置触发条件，就可以使用命令。下面是触发条件的格式。

“triggers”: [

{

“trigger”: “message_seen (当玩家看过 Vocation 中的另一条消息时触发)“,

“key”: “(要检查的消息 ID)“

{

“trigger”: “stat_above （当玩家的统计数据高于某个值时触发）“,

“key”: “（要检查的统计数据名称）“,

“value”: “（触发此事件所需的统计数据最低值）“

{

“trigger”: “item_pickup （当玩家拾取物品时触发）“,

“stack”: （要检查的物品堆叠，堆叠格式稍后展示）

{

“trigger”: “item_craft （当玩家合成物品时触发）“,

“stack”: （要检查的物品堆叠，堆叠格式稍后展示）

{

“trigger”: “mob_kill （当玩家击杀生物时触发）“,

“key”: “（需要击杀的生物名称）“

}

]

一旦触发消息，其动作（如果有的话）就会执行。动作数量不限。目前动作不多，但应该能应对大多数可能的情况。以下是动作格式。

“actions”: [

{

“action”: “give_item （此动作给予玩家一个物品）“,

“stack”: （要给予玩家的物品堆叠，堆叠格式稍后展示）

{

“action”: “run_command （此动作执行一条命令，以命令方块级别的权限在玩家位置执行）“,

“param”: “（在此处填写要执行的命令，包括 /）“

}

]

最后，以下是堆叠格式。

“stack”: {

“id”: “（物品的 id，包括模组 id，例如：minecraft:log）“,

“metadata”: “（此物品的元数据。可选。如果未提供，物品元数据将为零；如果该堆叠用于触发器，则不会检查元数据）“

“stackSize”: “（此堆叠的大小。可选。如果未提供，堆叠大小将为 1。对触发器完全无影响）“,

“nbt”: （此物品 NBT 的 json 对象，类似于运行 /give 命令时使用的格式。可选。如果未提供且该堆叠用于触发器，则不会检查 NBT）

}

命令

该模组还附带可用于 run_command 动作的命令，可通过命令方块或服务器管理员使用：

/vocation-review – 任何人都可以使用此命令，它会再次发送玩家上次看到的职业消息，但不会执行任何操作
/vocation-reload – 管理员命令，重新加载所有职业文件
/vocation-clear <player> – 命令方块及以上权限可用的命令，清除玩家的所有职业数据
/vocation-set-seen <player> <id> <true/false> – 命令方块及以上权限可用的命令，将玩家某条消息（按消息 ID）的标记设置为已读或未读（这样它之后就不会显示；如果你希望它多次显示，也可以将其设为未读）。此命令不会触发操作，但如果你将标记设为未读后触发了相应条件，操作就会再次执行。
/vocation-show <player> <id> [do-actions] – 命令方块及以上权限可用的命令，向指定玩家显示给定消息（按消息 ID）。末尾的 “do-actions” 是可选的；如果提供了它，且该消息尚未被看过，就会执行相应操作，并将消息标记为已读。如果不提供，消息将不会被标记为已读。
/vocation-check <player> <id> – 命令方块可用的命令，如果玩家看过该消息（按消息 ID），则发出红石比较器信号。它的工作方式与 /testfor 类似，如果你熟悉这个命令的话。

源代码

如果你在使用这个模组时遇到问题，或只是想联系我，可以在 Twitter 上找到我（@Vazkii），也可以通过 IRC 联系我（irc.esper.net 上的 #vazkii）。