BetonQuest 插件文档

这个是BetonQuest的官方文档，由kjiang，Afry，MycroftCooper翻译改编。
原始英文文档请参阅https://github.com/Co0sh/BetonQuest/wiki

BetonQuest是一个先进的Bukkit/Spigot任务插件。它提供功能强大的类RPG NPC对话和非常灵活的任务系统。除了基本的打怪奖励外，BetonQuest还允许你随意控制在什么条件（conditions）下，触发什么样的事件（events），以此来达到什么目标（objectives）。你的任务可以脱离传统“打怪-升级-奖励”这样的无聊套路，利用BetonQuest，你可以创建更复杂的多线剧情、更丰富的NPC对话、更扑朔迷离的多结局，让你的玩家乐在其中。

本插件由作者Co0sh以及多位GitHub社区成员共同开发维护。BetonQuest是一个遵循GPLv3的开源项目，如果你有意参与此插件的开发，源代码和项目可在这个GitHub页面找到。

• 安装和配置 Installation and Configuration
• 命令和权限 Commands and Permissions
• 快速教程 Quick Start Tutorial
• 基本概念参考 Reference
  • 对话脚本 Conversations
  • 条件 Conditions
  • 事件 Events
  • 目标 Objectives
  • 脚本包 Packages
  • 统一坐标格式 Unified Location Formating
  • 全局变量 Global Variables
  • 取消任务 Canceling Quests
  • 全局位置 Global Locations
  • 静态事件 Static Events
  • 任务日志 Journal
  • 标签 Tags
  • 积分 Points
  • NPCs
  • 物品 Items
  • 背包 Backpack
  • 团队 Party
  • 方块选择 Block Selectors
• 列表
  • 条件列表 Conditions
  • 事件列表 Events
  • 任务目标列表 Objectives
  • 变量列表 Variables
• 关联插件 Compatibility
• 高级技巧 Tips and Tricks
• 常见问题 FAQ
• 开发信息 Info for Developers
• 参与开发 Contributing
• 通知提示 Notifications

• 支持1.9、1.10、1.11和1.12等多个Minecraft版本
• 可实现多个选项分支的NPC对话系统，并提供文字或GUI等形式。
• 强大的事件（events）系统：可以实现你能想到的任何事件
• 更强大的条件（conditions）控制：由你来决定该在什么情况下发生
• 用书本直接查阅任务日志和进度。
• 控制玩家背包和任务奖励
• 先进的物品控制，连书本里的字都可以自定义
• 团队系统，允许玩家组队刷任务
• 自定义各种积分（points）和等级
• 根据坐标和区域自定义事件（events）
• 设计日常任务，或每日奖励
• 各种变量，个性化的对话内容，让NPC告诉玩家他还缺具体多少个东西
• 按目录分类整理各种任务
• 支持Citizens2 NPC
• 和这些插件联动：
• 多语言和翻译支持，根据玩家的语言设置显示不同翻译
• 你还可以利用API接口开发你自己的events、conditions、objectives
• 支持SQLite和MySQL
• 这是一个活跃、并开源的项目，还有随时更新的每日构建供你下载

试想一下，当你和NPC对话（conversation）的时候，你可以选择多个对话分支，然后NPC可以根据你的选项作出不同的反应。例如当你向NPC询问一些打杂任务的时候，他会让你去砍几棵树并把木头带回给他。当你接受这个任务的时候，一个让你去获取木头的任务目标（objective）就此启动了。同时被启动的还有某个事件（event）这个事件会把你标记（tag）为正在执行这个砍树任务。从现在开始，这个NPC会根据你的这个标记，改变和你的对话内容，催促你快点完成任务：“树砍完了吗？把木头带给我吧”。

当你完成这个任务目标（objective）之后，则会启动另一个事件（event）。这个事件会把你标记（tag）为完成了某个任务的人。当你跟NPC再次对话（conversation）的时候，会根据你的新标记，告诉你他会看你的背包是否满足条件（objective），具有他想要的木头。如果你有他想要的东西，那么他就会给予你一些奖励。（编者注：这个任务作为标准模板，会在第一次安装BetonQuest之后出现在插件配置文件夹里）

在这个任务中，你看不到任何“任务”，有的只是一连串你和NPC之间的对话，所有事件/目标/条件都通过对话实现。而这里的目标（objective）不能单独作为“任务”本身，这个目标只是在你达成一定条件的时候给你一个新的标签（tag）而已。所有这一切共同组成整个“砍树任务”。至于最后那个对话（conversation），它可以给予你奖励，也可以给你分配另一个新的“任务”叫你去挖矿石，所以对话也不是“任务”本身。

如果你觉得“砍树”或“挖矿石”这些任务太简单了，实际上BetonQuest可以创建更复杂多样的任务。为了方便解释，上面只提供了一个简化的例子。你可以在适当的时间，往玩家的任务日志书（journal）里写入任务提示，还可以编写多线对话内容，或者在玩家进入某个坐标的时候启动一个随机任务。你可以建立新的等级系统、创造各种自定义物品、书本等等。你还可以根据单个玩家，甚至多个玩家的选择或行动，设计出多维度、错综复杂、丰富多彩的任务和剧情。

实际上BetonQuest不仅仅只是个任务插件。借助对话和NPC，你还可以实现诸如传送员、引导新手、介绍服务器等等等等新奇玩法。在这里唯一的限制就只有脑洞大不大而已！

本wiki由随便MC～多人游戏社区根据Co0sh的wiki文档翻译整理。翻译初衷是为了方便参与建设随便MC～服务器的管理员和建筑师能更好地利用BetonQuest，并创造出更多好玩的原创内容。

为方便阅读理解，部分内容与原文相比略有改动。

参与翻译整理人员有：

• Afry
• kjiang
• MycroftCooper
• JohnHo
• Nchyn

如果你对我们社区感兴趣，欢迎加入随便MC～大家庭：玩家群392455229、310714680，设计群177987017。