概述
QuestPath 允许你完全通过 config.yml 创建主线任务线和可选的支线任务。玩家通过一个简单的图形用户界面(GUI)追踪进度,而你可以完全掌控任务内容和奖励。
特性
主线任务路径
线性推进:每个任务解锁下一个任务。
支持自定义步骤数量;由你来设计整个路径。
支线任务
从可配置的池中随机分配。
使用 /getsidequest 获取或重新掷骰子选择支线任务。
内置任务类型
挖掘方块(支持 ANY_LOG)
合成物品
击杀实体
访问维度(主世界 / 下界 / 末地)
获取物品(拾取、合成、熔炉提取)
行走距离(方块数)
基于 GUI 的界面
/quest 打开一个简洁的菜单。
查看当前主线任务。
查看当前支线任务。
已完成的主线任务分页列表。
经济集成(可选)
支持 Vault 以提供金钱奖励。
在 config.yml 中设置全局默认奖励。
每个任务可单独覆盖奖励金额,以实现精细化的支付调整。
管理员工具
/questreset <player> 清除玩家的任務進度。
玩家数据存储在简单的 players.yml 文件中。
提供了示例任务但全部被注释掉,因此服务器启动时是一个空白状态,可以从头开始设计自己的任务。
命令与权限
/quest
打开任务 GUI。
权限:无(默认:所有人)。
/getsidequest
分配或重新掷骰子选择支线任务。
权限:无(可通过你的权限插件配置)。
/questreset <player>
重置玩家的任务进度。
权限:questpath.admin。
支持的版本
Minecraft:
专为 1.20.x 和 1.21.x(最新 Paper/Spigot)设计与测试。
服务器软件:
Paper 和 Spigot(以及 API 兼容的分叉版本)。
Java:
Java 21+(推荐用于现代服务器版本)。
配置
首次启动时,QuestPath 会生成一个最小的 config.yml:
economy 部分用于启用/禁用金钱奖励及默认金额。
quests.main 和 quests.side 初始为空。
底部包含一个带完整注释的示例任务部分作为模板;服务器所有者可以复制并调整这些示例来构建自己的任务线。
每个任务支持以下字段:
id – 唯一标识符。
type – 任务类型(例如 MINE_BLOCK, KILL_ENTITY, TRAVEL_DISTANCE 等)。
display / description – 在 GUI 和消息中显示。
根据类型的目标字段(target-block, target-item, target-entity, target-world)。
amount – 完成任务所需的进度值。
reward-money – 可选的单个任务奖励;如果省略则回退到全局默认值。
对于“任意原木”,请使用 target-block: ANY_LOG。
对于特定方块,请使用其 Bukkit 材料名称,例如:
target-block: OAK_LOG, target-block: DIAMOND_ORE 等。
Overview
QuestPath lets you create a main quest line and optional side quests entirely through config.yml. Players track their progress through a simple GUI, while you stay in full control of the quest content and rewards.
Features
Main quest path
Linear progression: each quest unlocks the next.
Supports a custom number of steps; you design the whole path.
Side quests
Randomly assigned from a configurable pool.
/getsidequest to get or reroll a side quest.
Quest types (out of the box)
Mine blocks (with support for ANY_LOG)
Craft items
Kill entities
Visit dimensions (Overworld / Nether / End)
Obtain items (pickup, crafting, furnace extract)
Travel distance (blocks walked)
GUI-based interface
/quest opens a clean menu.
View current main quest.
View current side quest.
Paginated list of completed main quests.
Economy integration (optional)
Vault support for money rewards.
Global default rewards in config.yml.
Per-quest reward-money overrides for fine-tuned payouts.
Admin tools
/questreset <player> to wipe a player’s quest progress.
Player data stored in a simple players.yml file.
Example quests are provided but fully commented out, so servers start with a blank slate and can design their own quests from scratch.
Commands & Permissions
/quest
Opens the quest GUI.
Permission: none (default: everyone).
/getsidequest
Assigns or rerolls a side quest.
Permission: none (configurable via your permissions plugin).
/questreset <player>
Resets a player’s quest progress.
Permission: questpath.admin.
Supported Versions
Minecraft:
Designed and tested for 1.20.x and 1.21.x (latest Paper/Spigot).
Server software:
Paper and Spigot (and forks that are API compatible).
Java:
Java 21+ (recommended for modern server versions).
Configuration
On first start, QuestPath generates a minimal config.yml:
economy section for enabling/disabling money rewards and default amounts.
quests.main and quests.side start empty.
A fully commented example quest section is included at the bottom as a template; server owners can copy and adapt these examples to build their own quest lines.
Each quest supports:
id – unique identifier.
type – quest type (e.g., MINE_BLOCK, KILL_ENTITY, TRAVEL_DISTANCE, etc.).
display / description – shown in the GUI and messages.
Target fields depending on type (target-block, target-item, target-entity, target-world).
amount – required progress to complete.
reward-money – optional per-quest reward; falls back to global defaults if omitted.
For “any log”, use target-block: ANY_LOG.
For a specific block, use its Bukkit material name, for example:
target-block: OAK_LOG, target-block: DIAMOND_ORE, etc.
评论 0
登录后参与评分
还没有评论,来抢沙发吧