[Wiki][多人插件] BetonQuest-具体任务Wiki翻译第七章：参考-扩展II - Minecraft(我的世界)中文论坛

取消任务

如果你想让你的玩家取消任务，有一个功能可以做到。在main.yml文件中有被称为cancel的分支。您可以在这儿指定可以取消的任务和取消它们所需要完成的操作。你同样可以在default包中找到一个例子。您可以指定的参数有：

name - 这将是显示给玩家的名称。_（英文半角下划线）将转换为空格。如果您想要启用翻译/多语言系统，您可以在此添加其他语言的选项（en，cn等等）
conditions - 在这儿你列出删除任务所需要的条件，用 , 也就是英文半角逗号分隔多个条件。例如，你可以通过这个来令玩家必须完成任务的某个阶段才能停止。
objectives - 在这儿请列出你所取消的任务中使用过的目标。这些目标将被取消/不启动
tags - 在这儿列出的标签将被全部删除。这些标签应当是任务中使用过的（当然也可以通过这个来实现“取消了就不能再领取的任务”）
points - 列在这儿的点数类别将被清空。
journal - 这些日志条目将在取消任务时被删除。
events - 如果您想在取消任务时执行其他操作（例如惩罚玩家），请在此处列出事件。当玩家取消任务时，这些事件将被执行。
loc - 这是当取消任务时，玩家将被传送到的位置。（你可以把它理解为一个传送事件）
要取消任务，你需要打开你的任务物品背包（使用/backpage，并选择命名为“取消/cancel”的按钮（默认显示为骨头物品，将一个物品重命名为“cancel_button”然后放入背包即可修改显示物品）。点击后将显示可以取消的任务列表。点击其中的某个，它将被取消。

日记

这本日记是一本书，其中描述了所有的冒险经历。您可以通过键入/j直接或键入/b然后从背包中选择它来获取它。你不能把它放到任何箱子，物品展示框之类的地方。如果你觉得日记太烦人/占背包格，那就把它放置回/b打开的任务背包。更新日记需要使用日记类事件，其中援引的文本需要在journal.yml配置文件中自行定义。如果您更新这些文本并重新加载插件，更改将会应用到所有玩家的日记上。日记的默认颜色可以在config.yml中更改。条目可以使用颜色代码，但是只会在该条目中应用——下一个条目将在行首重置为Config中的颜色。

默认情况下，日记的位置是在快捷栏的最后一格。如果你想改变它的位置，那么在config.yml中的default_journal_slot项，尝试修改，直到你确定。

如果您要翻译条目，你要做的和对话一样——到下一行，添加语言ID和对应的文本。

您可以在日志部分中的config.yml文件中控制日记的相关内容。 chars_per_page指定在一个页面上放置多少字符。如果你设置太高，文本会溢出页面，太低，太多页。 one_entry_per_page允许您一页一个条目。在这种情况下，系统将忽略chars_per_page项，BetonQuest将把整个条目放在一个页面上。
reversed_order允许您倒序排放条目，而hide_date将使得条目不显示日期。

您可以在config.yml中的journal_colors部分中设置日记中的颜色：date是每个条目的日期的颜色，line是分割线的颜色，text是文本的颜色。您需要使用不带＆的标准颜色代码（意思就是说，直接填写即可。例如，使用“4”来表示深红色）。

您还可以将给日记添加一些固有页面。它是几个字符串列表，只有满足指定的条件才会显示。您可以在main.yml文件中的journal_main_page条目中进行设置。每个字符串可以有多语言系统/翻译，后方可以跟着用英文半角逗号分隔的条件列表。对了，还有个优先级的，它控制这些字符串在固有页面中的显示顺序。你可以在文本中使用变量，但是只有当玩家每次使用/journal命令获取日志时，它们才会被更新。固有页面支持颜色代码。

NPC

对话可以分配给NPC。你可以在package中的main.yml文件中的“npcs”部分中进行如下设定：

npcs:
'0': innkeeper
'老板': innkeeper

复制代码

第一个字符串是NPC的名称，第二个是相应的会话文件名。如果你使用Citizens插件，那么名字请填写NPC的ID（不要尝试把CitizenNPC的名字在这里，它必须是ID）。要获取一个Citizen中NPC的ID，只需要选中它然后键入/npc。如果你不想使用Citizens，你也可以“建”起一个NPC：

在某个地方放置一个任意颜色的染色粘土/粘土块。然后在它的顶部放一个头（类型无所谓，但必须是头）。然后在粘土块的一侧（可以在它的背面）放置一个告示牌，并在第一行中输入[NPC]，第二行输入NPC的名称（是NPC名称而并非对话名称。在上述代码示例的情况下，请填写“老板”）。你需要有betonquest.createnpc权限。恭喜，您已创建NPC。现在你可以添加杠杆（当做手），和栅栏门（当做腿）。玩家可以通过右键单击它的头来开始对话。

物品

如果要在Give和Take事件或Item和Hand条件中使用物品，则必须在items.yml文件中设定这些物品。这保证给予的/带走的/手持的/背包中的将是和你要求的完全相同的物品。您可以通过两种方式将它们添加到此文件：

方法一：使用命令/q item <包>.<物品内部名>。它会检测你手中的物品，并把它储存在<包>内的items.yml里面的<物品内部名>名称下。方便快捷。

方法二：手动敲代码。向items.yml添加一行，并键入物品的ID，后跟冒号和空格。现在你需要做的第一件事是插入物品的类型。您可以在这里找到所有可用的物品类型。如果你只是需要一个普通的物品，那么现在就可以结束了。但是你可以添加一些NBT：

data：是方块附加值（例如，不同的羊毛颜色）。它后面应该是一个整数。默认值为0，因此在大多数情况下，您可以忽略它。
name是物品的显示名称。所有空格应由_替换。
lore：是物品的介绍。空格遵循与名称中相同的规则，每一行由分号隔开。
enchants：是由命令分隔的附魔列表。每个附魔有两个值，用英文半角冒号分隔：名称和等级。所有的名字都可以在这里找到。这里是例子：
1. enchants:DAMAGE_ALL:3,KNOCKBACK:2
复制代码
如果物品是书，您还可以添加title: 和 author: 以及 text:。空格应该始终由_替换。使用|分隔多个页面，您可以用\n来换行。
如果物品是药水，那么你可以添加药水效果：，其中不同的效果用逗号分隔。药水效果的样式如下：
1. 药水名:X:Y
复制代码
其中可用的效果名称列表可以在这里找到，X是药水的等级（1就是I，不是II，不像某些插件会自动+1），Y是以秒为单位的持续时间（不是tick）。
如果物品是皮革盔甲部分，您可以通过添加color: （后方跟着颜色数据）指定它的颜色。这里使用RGB颜色系统（例如#ff00ff）。使用此工具可以轻松生成你想要的颜色。如果你需要得到染料的颜色，只需通过/q item 随便一个名称来保存一个染色的盔甲，然后进入配置文件查看确切的结果。
如果该物品是玩家的头部，您可以通过添加owner: 来指定其所有者，owner后面跟着的是所有者的姓名，例如owner:Notch。注意：当头颅的附加值不为3的时候，这个属性就不会正常运作。
如果这个物品是附魔书，那么请参考enchants条目。

有时候你想要广泛地检测物品，例如检查玩家是否有一柄任何样式的钻石剑（你肯定不希望玩家在没有适当装备的情况下进行危险的任务）。但是有时候，你会遇到一些问题。想象一下，任务要求玩家必须送给某人一柄钻石剑。但他还身上还带有自己名叫Diamond Sword of Beton and Destruction的钻石剑。你肯定不希望随便移除玩家的一柄钻石剑，因为这样可能会移除他的“私人”剑。这时候none选项就变得有用了。

如果你想只定位没有任何附魔的物品，或没有名字（或没有效果的魔药等），你应该把它设为enchants:none 或者 name:none等。该物品将照常使用，但在条件和事件中，将进行有特殊的选取。

物品无法使用多语言功能/翻译，因为在每次更改语言时，无法都跟踪您的每个物品并更改其元数据。抱歉。

关于1.8版本的Minecraft书的重要说明
有些服务器，由于一些插件的影响，在书本每行的末尾默认添加了§0，当插件生成书籍时。它看起来没有什么大不了，因为这个颜色代码只是将下一行的颜色重置为黑色，但它可以搅乱物品的配置（保存到配置的物品不同于您拥有的物品）。因此，我建议您执行以下操作，以确保这两本书（手中的和配置里的）是相同的：

获得所需的书（例如通过写它）
用/q item 书（或任何其他名称，对这个例子而言用什么名称没有关系）保存它，
接着输入指令获得它（/q give 书）
然后把刚刚获得的书再次保存。（最好用相同名字以覆盖掉之前的记录）
再次输入指令获得它
这一次获得的将是和配置中完全相同的
对于由此带来的不便，我们深感抱歉，但是自动删除这些§0会导致一系列的错误。我（指作者）不打算冒险。

例子：

sword: 'DIAMOND_SWORD data:0 name:Slasher lore:Very_powerful;Forged_by_Endermen
enchants:DAMAGE_ALL:5,KNOCKBACK:2'
potion: 'POTION name:Poison lore:Will_kill_you_in_10_secods_flat effects:HARM:10:0'
book: 'WRITTEN_BOOK title:Book_about_everything author:Notch
text:The_text_goes_here.|This_is_on_the_new_page.\nAnd_this_is_one_line_below.'

复制代码

注意YAML允许换行。

任务背包

有时候，你会希望一些物品不会死亡掉落。如果玩家失去了这些物品，那么任务就会失败。你可以给物品添加一行特殊的介绍，令其绑定给玩家（默认是&2Quest_Item；_，也就是英文半角下划线代表一个空格）。注意，必须是全新的一行介绍！这样，玩家死亡时，这件物品便不会掉落。
例如：

important_sword: 'DIAMOND_SWORD name:Sword_for_destroying__The_Concrete lore:Made_of_pure_Mithril;&2Quest_Item'

复制代码

只需要输入/j你便可以打开你的任务背包。这将打开一个箱子状的GUI，里面可以储存你的物品。第一个槽始终是日记，当你把它拿出来那么这个格子就会变空。你可以通过点击来将任务物品传输到任务背包。左键单击将传输单个任务物品，右键单击将尝试传输所有任务物品。普通物品不能存储在任务背包中，所以这将不会使玩家拥有无限的背包格。

如果你有超过一页的任务物品，将出现按钮（比如用于翻页）。您可以通过在items.yml文件中创建previous_button和next_button物品来自定义这些按钮。它们的名称将被messages.yml中定义的名称覆盖。

正常情况下任务物品不会消失——它们不能被丢弃，也不会死亡掉落。但是有一种情况除外——使用它们（比如说吃掉一个苹果或者喝下一瓶药水）。这样，你就可以制作一个“吃饼干”的任务——给玩家一堆标记为任务物品的饼干，系统将检测玩家背包&任务背包里是否还有饼干，由于饼干是任务物品，玩家无法丢弃，所以为了完成任务，玩家将必须吃掉全部的饼干。

不要担心，在创造模式下，“物品丢失保护器”（也就是上文提到的任务物品不能被丢弃）将不会启用——这不是BUG，这是特性。玩家应当能自由地决定任务物品的去留或者把他们放到某个箱子中（比如宝箱？）。

队伍

组队非常简单。简单到你难以理解其他的冗杂的任务系统。基本上，只有你需要使用队伍，系统才会创建队伍。队伍直接通过条件/事件定义（队伍事件和队伍条件，可以在下面的列表中看到）。在这样的指令字符串中，第一个参数是数字范围。它定义了将要查找队员的半径。第二个是条件列表。只有符合条件的玩家才会被认为是队伍的成员。对于玩家来说，这是最直观的，因为他们不需要做任何事情，没有任何命令，没有GUI，只需要“正在做一样的任务”或者“拥有一样的物品”，你们就是同志了 —— 你的选择意味着你的队伍。

为了更好地了解它如何运作，我会给你一个队伍事件的例子。我的意思是，每个玩家都有一个目标——按下按钮。当玩家按下它时，此事件被触发：

party_reward: party 50 quest_started cancel_button,teleport_to_dungeon

复制代码

现在，这意味着，所有在按下按钮（也就是执行这个指令）的玩家周围50格内并满足quest_started条件的玩家将执行cancel_button和teleport_to_dungeon事件。第一个将取消按下其他按钮的任务（不再需要），第二个将传送把他们传送到某处。
现在，假设在世界的另一边有一个玩家也满足quest_started条件，但他不会被传送到dungeon，因为他没有在50格内；在按下按钮的玩家旁边有一堆其他的玩家，但他们没有满足quest_started条件，因此他们也不会被传送（因为他们没有开始这个任务）。