NewGuidance

插件功能​
​
任务创建与配置​

功能描述：创建新的任务，并为任务配置详细的传送点、药水效果、标题显示、任务目标 执行指令等。



配置文件：每个任务的配置文件以 ID.yml 的形式存储在 plugins/newGuidance/guidebook/ 目录下。​
​
传送点设置​
功能描述：管理员使用命令设置任务的传送点位置，并保存到对应的任务配置文件中。​
​
任务开始​
功能描述：玩家可以使用命令开始任务，插件会根据任务配置文件中的设置进行传送、添加药水效果、显示标题等。​
​
配置重载​
功能描述：管理员可以使用命令实时重载插件的配置文件，无需重启服务器。​
​
任务目标​
功能描述：支持设置任务目标，如提交物品等，玩家完成任务目标后会触发相应的奖励。​
​
安装步骤​
下载插件文件：将插件文件 newGuidance.jar 放入服务器的 plugins/ 目录。
重启服务器：支持版本：1.16.5 - 1.20.1，其他版本自测。
检查控制台输出：确认插件是否加载成功。​
​
命令列表​
命令​
权限​
描述​
/newg create <ID>​

op​
创建一个新的任务配置文件​
/newg set <ID> <number>​

op​
设置任务的传送点位置​
/newg start <ID>​

所有玩家​
开始执行任务​
/newg reload​

op​
重载插件配置​
/newg help​

所有玩家​
显示帮助信息​
​
​
示例​
设置出生点位置​
# 设置任务传送点位置

/newg <ID> set 1​

重载配置文件​
# 重载插件配置

/newg reload​

显示帮助信息​
# 显示帮助信息

/newg help​



功能详解​
1. 任务创建与配置​
功能描述：管理员可以创建新的任务，并为任务配置详细的传送点、
药水效果、标题显示、任务目标等。

配置文件：每个任务的配置文件以 ID.yml 的形式存储在 plugins/newGuidance/guidebook/ 目录下。​
2. 传送点设置​
步骤：
1.管理员在游戏内输入 /newg set <ID><number> 命令。
2.插件会将当前玩家的位置（包括世界名称、坐标、朝向等）保存到对应的 ID.yml 文件中。


示例：
# 设置任务传送点位置

/newg set abc 1


提示：设置传送点时，确保玩家处于目标位置。
​
​
3. 配置文件​
文件位置：插件会在 plugins/newGuidance/guidebook/ 目录下生成 ID.yml 文件。

​
YAML：
配置格式：
# 玩家需要的权限

Permission: "newg.id"

# 玩家能执行这个任务的次数

How_many_times_can_it_be_completed: 1

# 任务传送点配置

Spawn1:
# 世界的名字

world: world
# 坐标以及指向

x: 0.0
y: 0.0
z: 0.0
yaw: 0.0
pitch: 0.0

# 药水效果开关

Effect: true
# 药水效果类型

potioneffect: "blindness"
# 药水效果时间（单位：秒）

effecttime: 10

# 显示标题开关

Title: true
# 显示的大标题

spreadhead: "显示的大标题在屏幕中间"
# 显示的小标题

subtitle: "显示的小标题在屏幕中间"
# 显示时间（单位：秒）

titletime: 5

# 任务目标开关

Objective: true
# 任务目标类型（目前支持 items）

type: "items"
# 检测玩家背包物品的描述（支持 & 或 §）

lore: ""
# 物品数量

quantity: 64
# 完成任务后的标题

spreadhead: "显示的大标题在屏幕中间"
subtitle: "显示的小标题在屏幕中间"
titletime: 5
# 完成任务后执行的指令

commandonfront: true
 command:
- "money give %player% 1000"

​
​
4. 实时重载配置​
功能描述：管理员可以使用 /newg reload 命令实时重载插件的配置文件，无需重启服务器。


示例：
重载插件配置
/newg reload​


5. 任务目标​

功能描述：支持设置任务目标，如提交物品等，玩家完成任务目标后会触发相应的奖励。
配置：在 ID.yml 文件中设置 Objective: true 可启用任务目标功能。​

常见问题​

Q1: 玩家进入游戏后没有被传送到出生点​
检查玩家是否拥有 newg.id 权限。
确认 ID.yml 中的出生点配置是否正确。
确保插件已正确加载。​
Q2: 传送点设置失败​
确保管理员在设置传送点时处于目标位置。
检查 ID.yml 文件是否已正确生成。​
Q3: 任务目标未触发​
确认 ID.yml 中的 Objective 设置为 true。
确保玩家背包中有符合要求的物品。​