✅目标

在上一节教程中，你已经学习了如何创建和使用事件。本节教程是关于目标的。目标是你可以分配给玩家的任务。例如破坏方块或钓鱼。可能性几乎是无穷无尽的！您将在本节教程中了解这些内容。

要求

你必须已完成上一章“安装指南”内容

你必须已完成上一节“对话”内容

你必须已完成上一节“事件”内容

下载教程预设

如果您已经使用了上一个教程步骤的配置，请不要执行此操作。

在聊天框中输入以下命令下载本节教程的预设内容：

/bq download BetonQuest/Quest-Tutorials main QuestPackages /Basics/Objectives/1-DirectoryStructure /tutorialQuest

您现在可以在此位置找到本教程所需的所有文件：

"你的服务器文件存放位置/plugins/BetonQuest/QuestPackages/tutorialQuest"

1.为第一个目标创建文件结构

在“tutorialQuest”文件夹内，新建一个名为“objectives.yml”的文件；并在“Conversations”文件夹内，新建一个"blacksmith.yml"文件。你可能会问为什么我们将新文件添加到“Conversations”对话文件夹。这是因为城市之旅目前以虚无告终。我们将添加一个铁匠NPC，玩家可以与NPC交谈。

以下是你现在的文件结构：

• 📁tutorialQuest

  • 📂package.yml

  • 📂events.yml

  • 📂objectives.yml

  • 📁conversations

    • 📂jack.yml

    • 📂blacksmith.yml

现在，我们的文件结构已准备就绪，可以开始编写目标和新的对话了！

2. 定义你的第一个目标并完成事件

打开新创建的文件“objectives.yml”并添加以下内容：

objectives.yml

objectives: 
  fishingObj: "fish cod 10 notify hookLocation:100;50;100;world range:20 events:caughtAllFish"

所有目标都必须在objectives.yml文件中定义。

让我们来拆解分析一下：

• fishingObj是目标的名称。你可以随意起名。但是，建议以它的作用命名它。这会让你更方便地编写任务

  • 目标结构

    • fish：指令中的第一个值始终是目标类型。

    • cod：这是目标的一个选项。它定义了fish所需要的的物品。

    • 10：这是另一个选项。它定义了鱼的数量。

    • notify：这是大多数目标的常规设置。当玩家完成目标时，它会启用通知。

    • hookLocation:100;50;100;world：此选项定义鱼竿的位置必须位于何处。只有在这个特定区域捕捞的鱼才会被目标计算在内。

    • range:20：如果使用hookLocation，则还必须定义范围选项。这是鱼竿位置坐标周围的范围，其中钓出的东西仍然被计算在内。

    • events:caughtAllFish：这不是鱼目标的选择，而是目标的一个常规设置。目标完成后（在指定的钓鱼位置捕获 10 条鳕鱼后），将触发定义的事件。

之后，我们将caughtAllFish事件添加到“events.yml”中，如下所示：

events.yml

events:
  # 其他事件不在这里显示
  tpBlacksmith: "teleport 50;70;50;world"
  caughtAllFish: "notify You caught enough fish!\nReturn to the blacksmith! io:Title sound:firework_rocket"

它让玩家知道他们成功完成了目标。

3. 在物品部分中创建物品

像我们在上一教程中学到的那样，我们必须在物品部分中定义，因为BetonQuest不知道是什么。要将该物品添加到列表中，让我们重新打开“package.yml”文件。

package.yml

npcs:
  '1': "Jack"

items:
  steak: "COOKED_BEEF"
  cod: "COD" 

• 第6行 cod：将BetonQuest配置中的物品cod连接到Minecraft中的物品。

现在，cod是一个已被定义的物品，可以在整个任务中使用。

现在，是一个已定义的物品，可以在整个任务中使用。

4. 测试你的第一个游戏目标

每次测试一些内容时，保存所有文件是非常重要的！保存后在服务器上输入：/bq reload

目标必须在开始观察玩家的行动之前启动。执行此操作的最简单方法是运行命令：

在服务器上输入/bq objective YOUR_NAME add tutorialQuest.fishingObj此命令将开始玩家的目标。如果你想检查目标是否正确完成，请转到目标所定义的位置并钓10条鳕鱼。捕获10条鳕鱼后，你应该会收到通知。

命令拆解分析

命令部分	意义
/bq objective	告诉BetonQuest应该执行一些事件。
NAME	玩家名。
add/complete/del/list	使用这些参数可以添加、完成、或列出目标。list参数不需要任何进一步的参数，并列出所选玩家的所有目标。
tutorialQuest	任务包的名称。这是必需的，因为您可以在不同的包中具有相同名称的目标。
fishingObj	要执行的目标的名称。不要忘记用一个点将其与package分开。tutorialQuest.fishObj

你还可以使用/bq objective NAME 命令来列出玩家的所有目标。

如果要手动完成玩家的目标，你需要输入/bq objective YOUR_NAME complete tutorialQuest.fishObj 。发送此命令后，你还应该会收到有关完成此目标的通知。

5. 使用事件开始设定目标

目标不仅可以使用命令启动/停止，还可以使用事件启动/停止。让我们添加一个事件来启动钓鱼目标：

events.yml

events:
  # 其他事件不在这里显示
  tpBlacksmith: "teleport 50;70;50;world"
  caughtAllFish: "notify You caught enough fish!\nReturn to the blacksmith! io:Title sound:firework_rocket"
  startFishingObj: "objective start fishingObj" 

• 第5行 startFishingObj：启动执行fishingObj事件的玩家的目标。

6. 将目标整合到对话中

如标题所示，我们可以从对话中运行事件。现在，我们可以使用新事件从对话中启动目标。

让我们在对话文件夹中为新创建的文件“blacksmith.yml”添加一些对话：

blacksmith.yml

conversations:
  Blacksmith:
    quester: Blacksmith
    first: firstGreeting
    NPC_options:
      firstGreeting:
        text: Welcome %player% in Valencia! The mayor already told me that you are new to our town.
        pointer: thatsRight
      newArmorForNewCitizens:
        text: So every new citizens in our town will get a new armour from me but you have to do something for me in order to get this really nice upgrade!
        pointer: whatToDo
      collectFish:
        text: You will have to fish 10 fresh cod for me and bring them to me. After that I will give you the nice new armour! Is that a deal?
        pointer: accept,deny 
      maybeLater:
        text: No problem! You can comeback later aswell. Bye!
      goodLuck:
        text: Good luck and I will see you later!
    player_options:
      thatsRight:
        text: Yeah thats true. Thank you!
        pointer: newArmorForNewCitizens
      whatToDo:
        text: What can I do for you?
        pointer: collectFish
      accept:
        text: Sure! I could use a new armour.
        event: startFishingObj 
        pointer: goodLuck
      deny:
        text: I dont have time right now.
        pointer: maybeLater

• 第14行 pointer：玩家可以选择接受或拒绝。

• 第28行 event：这是开始你目标任务的事件，去捕捞10条新鲜的鳕鱼。

现在，将对话连接到一个新的NPC，该NPC放置在城市游览结束的地方。你应该已经知道如何将对话框连接到“package.yml”中的npc。如果你不会，请查看之前的教程！

每次测试一些内容时，保存所有文件都非常重要！保存后在服务器上输入：/bq reload

这个示例不起作用吗？

通过运行以下命令获取正确的配置。 这将覆盖您对示例所做的任何更改（包括 NPC ID）。 基础教程中介绍了将 NPC 链接到对话。

/bq download BetonQuest/Quest-Tutorials main QuestPackages /Basics/Objectives/2-FullExample /tutorialQuest

总结

您已经了解了什么是目标以及如何创建目标。现在，你可以给玩家一个目标，让他们拥有更高级的任务！可以在目标列表中找到更多目标。在下一教程中，您将学习条件的工作原理以及如何使用它们使铁匠对完成的目标做出反应。