BeautyQuests - 美观任务系统

BeautyQuests 是一款允许你通过基于 Minecraft 库存系统创建的图形界面（GUI）轻松制作任务的插件。除了少数管理员命令外，几乎无需使用聊天栏。该插件设计精美，旨在为玩家简化任务体验。

💡版本兼容性

• 最新版 BeautyQuests 仅支持 1.17 及以上 的服务器版本。
• 对于 1.8 至 1.16 的版本，请使用 BeautyQuests 1.0.5。

🎮核心特性

• 丰富的任务阶段类型：击杀生物、与 NPC 对话、向 NPC 提交物品、寻找区域（WorldGuard）、挖掘/放置方块、在聊天中发言、与方块交互、合成物品、寻找地点、装满水桶、钓鱼、游玩指定时长等。
• 与 NPC 的对话系统（玩家也可以发言）。
• 多种奖励：物品、经验、权限、金钱（需 Vault）、传送等。
• NPC 头顶可配置的粒子效果（在需要时显示）。
• 计分板，用于显示任务进度。
• 任务菜单：为玩家展示已完成、未开始和进行中的任务。
• 分支系统：支持多选项的任务线。
• 两种数据存储方式：每个玩家的 YAML 文件，或 SQL 数据库（MySQL/MariaDB/PostgreSQL）。
• 烟花效果！
• 开发者 API：包含自定义事件、工具类、自定义阶段类型、要求、奖励、命令以及可自定义的任务数据（“任务选项”）。Javadoc 已包含在 .jar 文件中。
• 更新检查器：在有可用更新时通知管理员。
• PlaceholderAPI 支持：可在翻译文件或对话中使用占位符。
• 全息显示支持：与 HolographicDisplays、DecentHolograms 或 CMI 配合，可在 NPC 提供任务时显示精美的文本和物品。
• 在线地图标记：可在 Dynmap 或 BlueMap 上显示任务标记。

版本支持说明

• 完全支持 1.9 及以上（含）的所有版本。
• 在 1.8 版本上功能不完全支持（任务书、计分板和粒子效果将无法工作）。

🔧配置与文件

• config.yml：主配置文件。
• data.yml：用于保存玩家数据（如果未使用数据库）。
• scoreboard.yml：计分板配置文件。
• quests/ 文件夹：用于保存所有任务数据。
• 多语言支持：默认包含 en_US, fr_FR, de_DE, zh_CN 等语言文件，可在 config.yml 的 lang 选项中切换。
• 原版翻译系统（1.13及以上）：使用命令 /quests downloadTranslationsFile 下载翻译文件，以实现游戏内方块、物品等名称的自动本地化。

❓扩展与资源

• Premium Expansion（付费扩展）：为任务系统添加许多独特功能，例如任务点数或目标追踪。
• BQ BossBars 插件：由 @Warner322 制作的优秀插件，可在屏幕顶部以独立 Boss 血条显示所有任务。
• 官方 Wiki（部分内容可能过时）
• 问题反馈与翻译：你可以在 GitHub 上提交问题或帮助翻译本插件。
• 开发构建版本：可在此处获取。

✨可选依赖

以下插件均为**可选**依赖，用于扩展特定功能

• Citizens
• WorldGuard
• MythicMobs
• Vault
• PlaceholderAPI
• SkillAPI
• HolographicDisplays / DecentHolograms / CMI
• Jobs Reborn
• Factions
• AccountsHook
• dynmap / BlueMap
• mcMMO
• McCombatLevel
• MiniaturePets
• GPS
• Boss
• AdvancedSpawners
• LevelledMobs
• WildStacker

提示：有关完整的命令、权限和占位符列表，请查看插件页面上的“文档”选项卡。

BeautyQuests 是一款功能强大的任务插件，允许你为服务器创建、管理和运行丰富的任务系统。以下是其安装、配置与使用指南。

💡安装方法

• 下载 BeautyQuests 插件，将 JAR 文件放入服务器的 /plugins 文件夹。
• 你可以在本页面顶部点击蓝色按钮下载“稳定”版本。
• 你也可以在此处下载包含最新实验性功能的开发构建版本！请访问 Discord 服务器获取更多信息和持续更新的日志。
• 启动你的 Minecraft 服务器。检查控制台/日志，确保插件加载时没有错误。
• 现在即可使用 /quests create 命令开始创建任务！

配置文件

如需进一步配置（例如更改语言或数据库设置），请编辑 /plugins/BeautyQuests/config.yml 文件。保存文件后，请务必重启服务器。

🎮占位符

以下占位符可用于支持 PlaceholderAPI 的插件中。

• %beautyquests_total_amount%：显示任务总数。
• %beautyquests_player_inprogress_amount%：显示玩家正在进行中的任务数量。
• %beautyquests_player_finished_amount%：显示玩家已完成的任务数量。
• %beautyquests_player_finished_total_amount%：显示玩家已完成的任务总数（包含重复完成的任务）。
• %beautyquests_started_ordered%：按顺序逐个显示每个任务的进度。切换时间可在配置文件中设置。
• %beautyquests_started_ordered_X%：将任务进度拆分到多行显示（X 为行数）。
• %beautyquests_advancement_X%：显示任务 ID 为 X 的进度。
• %beautyquests_advancement_X_raw%：以单一数字形式显示任务 ID 为 X 的进度：
• -1：玩家尚未开始此任务。
• -2：玩家处于任务结束阶段（例如分支选择中）。
• ≥0：玩家当前所在的任务阶段 ID。
• %beautyquests_player_quest_finished_X%：显示玩家完成任务 ID 为 X 的次数。
• %beautyquests_started_id_list%：返回玩家当前正在进行中的任务 ID 列表，ID 之间用 ; 分隔。

🔧权限节点

• beautyquests.*：授予 BeautyQuests 的完全访问权限。
• beautyquests.start：授予玩家开始任务的权限。
• beautyquests.start.X：授予玩家最多同时开始 X 个任务的权限（这将覆盖配置文件中的 maxLaunchedQuests 选项）。
• beautyquests.command：仅授予使用 /quests 命令的权限，不包括子命令。
• beautyquests.command.*：授予所有子命令的使用权限。
• beautyquests.command.[sub-command]：授予特定子命令的使用权限（例如 create, edit 等）。
• beautyquests.command.listplayer：授予访问任务菜单（/quests）的权限。

❓命令列表

主命令为 `/quests`，可使用以下子命令

/quests

> 注意：请勿使用 reload 命令，它仅用于调试目的。

⭐数据迁移（从 YAML 存储迁移到数据库存储）

如果你希望将任务数据从 YAML 文件迁移到数据库，请按以下步骤操作：

• 在 config.yml 中，设置好“database”部分（如果你的文件中没有此部分，请参考下方说明添加），但保持 enabled 参数为 false。
• 重启服务器，待所有内容加载完毕后，使用命令 /quests migrateDatas（此过程可能需要一些时间，建议在此期间禁止玩家加入）。
• 如果一切顺利，你将收到成功消息。关闭服务器，将 config.yml 中的 database.enabled 设置为 true。
• 启动服务器，现在 BeautyQuests 将基于 SQL 数据库系统运行！