====== BetonQuest 插件文档 ====== ---- ===== 说明 ===== //这个是BetonQuest的官方文档，由kjiang，Afry，MycroftCooper翻译改编。\\ 原始英文文档请参阅[[https://docs.betonquest.org/RELEASE/|https://docs.betonquest.org/RELEASE/]]// BetonQuest是一个先进的Bukkit/Spigot任务插件。它提供功能强大的类RPG NPC对话和非常灵活的任务系统。除了基本的打怪奖励外，BetonQuest还允许你随意控制在什么//条件（conditions）//下，触发什么样的//事件（events）//，以此来达到什么//目标（objectives）//。你的任务可以脱离传统“打怪-升级-奖励”这样的无聊套路，利用BetonQuest，你可以创建更复杂的多线剧情、更丰富的NPC对话、更扑朔迷离的多结局，让你的玩家乐在其中。 本插件由作者[[https://github.com/Co0sh|Co0sh]]以及多位GitHub社区成员共同开发维护。BetonQuest是一个遵循GPLv3的开源项目，如果你有意参与此插件的开发，源代码和项目可在[[https://github.com/Co0sh/BetonQuest|这个GitHub页面]]找到。 ===== 目录 ===== * [[插件手册:betonquest:安装和配置|安装和配置 Installation and Configuration]] * [[插件手册:betonquest:命令和权限|命令和权限 Commands and Permissions]] * [[插件手册:betonquest:快速教程|快速教程 Quick Start Tutorial]] * [[插件手册:betonquest:基本概念|基本概念参考 Reference]] * [[插件手册:betonquest:基本概念#对话脚本_conversations|对话脚本 Conversations]] * [[插件手册:betonquest:基本概念#条件_conditions|条件 Conditions]] * [[插件手册:betonquest:基本概念#事件_events|事件 Events]] * [[插件手册:betonquest:基本概念#任务目标_objectives|任务目标 Objectives]] * [[插件手册:betonquest:基本概念#脚本包_packages|脚本包 Packages]] * [[插件手册:betonquest:基本概念#统一坐标格式_unified_location_formating|统一坐标格式 Unified Location Formating]] * [[插件手册:betonquest:基本概念#全局变量_global_variables|全局变量 Global Variables]] * [[插件手册:betonquest:基本概念#取消任务_canceling_quests|取消任务 Canceling Quests]] * [[插件手册:betonquest:基本概念#全局位置_global_locations|全局位置 Global Locations]] * [[插件手册:betonquest:基本概念#静态事件_static_events|静态事件 Static Events]] * [[插件手册:betonquest:基本概念#任务日志_journal|任务日志 Journal]] * [[插件手册:betonquest:基本概念#标签_tags|标签 Tags]] * [[插件手册:betonquest:基本概念#积分_points|积分 Points]] * [[插件手册:betonquest:基本概念#npcs|NPCs]] * [[插件手册:betonquest:基本概念#物品_items|物品 Items]] * [[插件手册:betonquest:基本概念#背包_backpack|背包 Backpack]] * [[插件手册:betonquest:基本概念#团队_party|团队 Party]] * [[插件手册:betonquest:基本概念#方块选择_block_selectors|方块选择 Block Selectors]] * 列表 * [[插件手册:betonquest:条件列表|条件列表 Conditions]] * [[插件手册:betonquest:事件列表|事件列表 Events]] * [[插件手册:betonquest:任务目标|任务目标列表 Objectives]] * [[插件手册:betonquest:变量列表|变量列表 Variables]] * [[插件手册:betonquest:关联插件|关联插件 Compatibility]] * [[插件手册:betonquest:高级技巧|高级技巧 Tips and Tricks]] * [[插件手册:betonquest:常见问题|常见问题 FAQ]] * [[插件手册:betonquest:开发信息|开发信息 Info for Developers]] * [[插件手册:betonquest:参与开发|参与开发 Contributing]] * [[插件手册:betonquest:通知提示|通知提示 Notifications]] ===== 特性与功能 Features ===== * 支持**1.9**、**1.10**、**1.11**和**1.12**等多个Minecraft版本 * 可实现**多个选项分支**的NPC对话系统，并提供文字或GUI等形式。 * **强大的事件（events）系统**：可以实现你能想到的任何事件 * 更**强大的条件（conditions）控制**：由你来决定该在什么情况下发生 * 用书本直接查阅**任务日志**和进度。 * 控制玩家**背包**和任务奖励 * 先进的物品控制，连书本里的字都可以自定义 * **团队系统**，允许玩家组队刷任务 * 自定义各种**积分（points）**和等级 * 根据坐标和区域自定义事件（events） * 设计**日常任务**，或每日奖励 * 各种变量，个性化的对话内容，让NPC告诉玩家他还缺具体多少个东西 * 按目录分类整理各种任务 * 支持**Citizens2 NPC** * 和这些插件联动： * 多语言和翻译支持，根据玩家的语言设置显示不同翻译 * 你还可以利用API接口开发你自己的events、conditions、objectives * 支持SQLite和**MySQL** * 这是一个**活跃、并开源**的项目，还有随时更新的[[https://betonquest.pl|每日构建]]供你下载 ===== 简介 ===== 试想一下，当你和NPC//对话//（conversation）的时候，你可以选择多个对话分支，然后NPC可以根据你的选项作出不同的反应。例如当你向NPC询问一些打杂任务的时候，他会让你去砍几棵树并把木头带回给他。当你接受这个任务的时候，一个让你去获取木头的任务目标（objective）就此启动了。同时被启动的还有某个事件（event）这个事件会把你标记（tag）为正在执行这个砍树任务。从现在开始，这个NPC会根据你的这个标记，改变和你的//对话//内容，催促你快点完成任务：“树砍完了吗？把木头带给我吧”。 当你完成这个任务目标（objective）之后，则会启动另一个事件（event）。这个事件会把你标记（tag）为完成了某个任务的人。当你跟NPC再次//对话//（conversation）的时候，会根据你的新标记，告诉你他会看你的背包是否满足条件（objective），具有他想要的木头。如果你有他想要的东西，那么他就会给予你一些奖励。（编者注：这个任务作为标准模板，会在第一次安装BetonQuest之后出现在插件配置文件夹里） 在这个任务中，你看不到任何“任务”，有的只是一连串你和NPC之间的对话，所有事件/目标/条件都通过对话实现。而这里的//目标//（objective）不能单独作为“任务”本身，这个//目标//只是在你达成一定条件的时候给你一个新的//标签//（tag）而已。所有这一切共同组成整个“砍树任务”。至于最后那个//对话//（conversation），它可以给予你奖励，也可以给你分配另一个新的“任务”叫你去挖矿石，所以//对话//也不是“任务”本身。 如果你觉得“砍树”或“挖矿石”这些任务太简单了，实际上BetonQuest可以创建更复杂多样的任务。为了方便解释，上面只提供了一个简化的例子。你可以在适当的时间，往玩家的任务日志书（journal）里写入任务提示，还可以编写多线对话内容，或者在玩家进入某个坐标的时候启动一个随机任务。你可以建立新的等级系统、创造各种自定义物品、书本等等。你还可以根据单个玩家，甚至多个玩家的选择或行动，设计出多维度、错综复杂、丰富多彩的任务和剧情。 实际上BetonQuest不仅仅只是个任务插件。借助对话和NPC，你还可以实现诸如传送员、引导新手、介绍服务器等等等等新奇玩法。在这里唯一的限制就只有脑洞大不大而已！ ===== 翻译说明 Translation Info ===== 本wiki由[[https://evermc.com|随便MC～多人游戏社区]]根据Co0sh的wiki文档翻译整理。翻译初衷是为了方便参与建设//随便MC～服务器//的管理员和建筑师能更好地利用BetonQuest，并创造出更多好玩的原创内容。 为方便阅读理解，部分内容与原文相比略有改动。 参与翻译整理人员有： * Afry * kjiang * MycroftCooper * JohnHo * Nchyn 如果你对我们社区感兴趣，欢迎加入随便MC～大家庭：玩家群392455229、310714680，设计群177987017。