插件脚本 【GPT汉化】【搬运】任务系统插件（v21.1）

[叶昕苍.]

原贴链接：原帖链接

Modern Quest System + UI 1.1.0​

此资源可用于为您的游戏添加一个灵活的任务系统，并附带一个受 HGSS 启发的 UI 用于查看任务信息！这是对 mej71 原始实现的一个大幅修改版本，适用于早期版本的 Pokémon Essentials。其他鸣谢包括 derFischae，他负责将 mej71 的脚本升级并维护到 v17.2 和 v18/18.1，Marin 的 Easy Questing Interface，Phantombass 的测试帮助，以及来自各个 Discord 服务器的许多人的宝贵反馈。

特点​

• 易于使用且灵活的任务系统。
• 单个任务可以有任意多个阶段，没有限制。
• 丰富的颜色选项，且您可以添加自定义颜色。
• 当任务更新时，会有一个指示器（如感叹号），避免了猜测。
• 目前支持一些定制功能，未来会有更多更新！

下面是主任务选择页面的示例，任务名称的外观（颜色和加粗）由您设置。例如，您可以为所有主线任务设置特定的颜色，为支线任务设置另一种颜色。您将有三个页面：正在进行的任务、已完成的任务和失败的任务。您还可以通过编辑配置脚本中的 SHOW_FAILED_QUESTS 来从 UI 中移除失败的任务。

主任务选择页面：


下面的图片展示了任务描述页面的外观，这里总结了玩家需要了解的关于选定任务的信息。这里的文字颜色并非固定，示例中只是为了好玩选择了不同的颜色。如果您想要更改这些颜色，您需要在 003_Quest_UI.rb 中做一些小的修改。搜索 colorQuest，您就会找到需要修改的地方。

任务总结页面：

安装 (v21/21.1)​

1. 从 MediaFire 链接下载 .zip 文件，通过页面右上方的“Go to download”按钮。
2. 下载后，打开 .zip 文件。
3. 将其中的 Audio、Graphics 和 Plugins 文件夹拖到您项目的主文件夹（即包含 Game.exe 的文件夹），让它们与现有的文件夹合并。
4. 编译您的游戏。

安装 (v20/20.1)​

1. 从 MediaFire 链接下载 .zip 文件。
2. 下载后，打开 .zip 文件。
3. 将其中的 Graphics 和 Plugins 文件夹拖到您项目的主文件夹（即包含 Game.exe 的文件夹），让它们与现有的文件夹合并。
4. 编译您的游戏。

安装 (v19/19.1)​

1. 从 MediaFire 链接下载 .zip 文件。
2. 下载后，打开 .zip 文件。
3. 将其中的 Audio、Graphics 和 Plugins 文件夹拖到您项目的主文件夹（即包含 Game.exe 的文件夹），让它们与现有的文件夹合并。
4. 编译您的游戏。

如何使用​

我已经在下载的资源中的 Plugins/MQS/meta.txt 文件中提供了详细的使用说明，建议您阅读该文件。

以下是概述，您需要使用的四个关键方法：

1. activateQuest(quest) — 激活任务并将其添加到任务日志中。
2. advanceQuestToStage(quest, stageNumber) — 将任务推进到指定阶段（如果适用）。
3. completeQuest(quest) — 标记任务为已完成。
4. failQuest(quest) — 标记任务为失败。

quest 参数应该是定义在 QuestModule 模块中的任务符号名称，您可以在上述提到的文件中查看更多内容。stageNumber 参数应为一个数字，表示任务进度。这个参数只在 advanceQuestToStage 方法中使用。

访问 UI​

我建议通过暂停菜单或 Pokégear 让玩家访问任务 UI，根据您的需要选择。我将描述如何从默认的暂停菜单中调用任务 UI。如果您使用的是自定义暂停菜单，则需要自己实现。

在 UI_PauseMenu 脚本的末尾添加以下代码：

MenuHandlers.addpause_menu, :quests, {
"name" => _INTL("Quests"),
"order" => 50,
"condition" => proc { next hasAnyQuests? },
"effect" => proc { |menu|
pbPlayDecisionSE
pbFadeOutIn {
scene = QuestList_Scene.new
screen = QuestList_Screen.new(scene)
screen.pbStartScreen
menu.pbRefresh
}
next false
}
})

您可以根据游戏的需要将“任务”改为任何其他名称，如“任务日志”等。通过编辑 order 的值来改变 UI 元素的位置（值为 50 时会显示在训练师卡和保存之间）。

控制说明​

• 按左/右箭头键可以在进行中/已完成/失败的任务列表之间切换，并查看任务描述页面。
• 按上下箭头键可以在主任务列表中导航。
• 按 A/S 可以在主任务列表中跳跃到上/下。
• 按 C/空格/回车查看选中任务的详细信息。
• 按 X/ESC 关闭 UI。

感谢您阅读这些说明！如果您遇到任何崩溃或错误，请在讨论区报告，或者您可以通过 Discord 联系我（ThatWelshOne_#3324）。

感谢阅读！

 

[叶昕苍.]

GPT汉化-使用说明：
现代任务系统 + 用户界面（Modern Quest System + UI）
版本: 1.1.0
Essentials 版本: 21.1
官网: https://reliccastle.com/resources/709/
作者: ThatWelshOne_，mej71，derFischae，Marin

详细的作者鸣谢
mej71 - 该任务系统使用了mej71的原始任务系统脚本，适用于早期版本的《宝可梦 Essentials》（资源链接）。
derFischae - 更新了mej71的任务系统脚本，适配了v17.2和v18/18.1版本的《宝可梦 Essentials》（讨论帖）。
Marin - 提供了任务系统界面组件的灵感来源（资源链接）。
ThatWelshOne_ - 升级和重新设计了任务数据录入和用户界面。
安装说明
将下载内容解压到你项目的主文件夹（即包含 Game.exe 的文件夹）。
合并下载中的 Audio、Graphics 和 Plugins 文件夹与现有文件夹。
编译游戏。如果插件正确编译，你应该会在调试控制台看到 "Compiling plugin scripts... done"（v19 和 v19.1），并且插件名称会出现在控制台窗口中（仅 v19.1）。
如果你没有看到该信息，可以删除 PluginScripts.rxdata 文件并重新尝试。
必须开启一个新的存档文件。
这样，你就成功安装了任务系统！
如何使用
你将会非常熟悉以下四个方法：

activateQuest(quest) - 用于激活一个任务并将其添加到任务日志中。
advanceQuestToStage(quest, stageNumber) - 用于将任务推进到指定阶段（适用于多阶段任务）。
completeQuest(quest) - 用于将任务标记为已完成。
failQuest(quest) - 用于将任务标记为失败。
任务参数：
quest 是定义在 QuestModule 模块中的任务符号名称（例如，如果你的任务数据是 Quest1，则应提供 :Quest1）。
注意：忘记加上冒号或者提供了不存在的任务会报错。

阶段编号参数：
stageNumber 是表示任务进度的数字，仅在 advanceQuestToStage 方法中需要。
阶段可以不一定是线性的，你可以从阶段1直接跳到阶段3，然后再回到阶段2。你也可以重复同一个阶段，谨慎使用！

除了上面描述的方法，还有一些可选的参数可以用来调整界面显示：

activateQuest(quest, color, story)
advanceQuestToStage(quest, stageNum, color, story)
completeQuest(quest, color, story)
failQuest(quest, color, story)

color: 任务名在界面上显示的颜色。使用15位的十六进制RGB颜色代码格式（例如 XXXXyyyy，其中 XXXX 是基础颜色，yyyy 是阴影颜色）。可以参考此网站转换颜色： 15-bit color converter。
story: 这是一个布尔值，默认值为 false。设置为 true 时，任务名称在界面中会加粗显示。这是用来区分某些任务的显示样式，你可以根据需要决定是否使用。
例如，你可以这样激活一个任务，并让任务名以紫色加粗显示：

activateQuest(quest, colorQuest("purple"), true)

注意：你可以根据任务完成/失败时，改变显示颜色，或者让已完成的任务使用不同的颜色。

任务数据录入（在 004_Quest_Data.rb 中）
你需要打开并编辑 Plugins/MQS 文件夹中的 004_Quest_Data.rb 文件。

推荐使用 Notepad++ 编辑此文件。如果你还没有安装 Notepad++，建议安装它。使用基本的记事本可能会导致格式问题。

任务数据录入格式: 在 QuestModule 模块中，你需要手动为每个任务添加以下信息：

ID - 任务的编号（目前未使用，但可以将来用于排序任务）。
Name - 任务名称，在界面上显示。
Quest giver - 任务给予者的名字。
Stage - 当前任务阶段的简短描述。
Location - 当前任务阶段的地点。
Quest description - 任务的整体描述。
Reward string - 完成任务后玩家能获得的奖励描述。

注意：
尽量简洁地填写文本，否则有可能会导致文本溢出或截断。
如果某些信息缺失，界面会显示为 "???"。
任务的阶段可以有多个，不必是线性阶段。
遇到问题怎么办？
如果你遇到问题，可以在资源帖的讨论区寻求帮助，或者通过 Discord 联系作者（ThatWelshOne_#3324）。