MCBBS纪念版 BBSPK晋级赛

[综合][PCD]Quests——经典的任务插件教程+汉化[1.8-1.15]

作者: 秋风残叶

时间: 2017-08-05 13:23:00 版块: 服务端插件

本帖最后由秋风残叶于 2020-4-25 16:01 编辑

欢迎收看：写教程写到心态爆炸

前几个站内搬运

http://www.mcbbs.net/thread-231713-1-1.html

http://www.mcbbs.net/thread-694594-1-1.html

要来了一个二搬许可

授权搬运证明

插件介绍

原帖插件介绍

原帖插件特性

In-game editor! You should never have to touch the file containing your Quests! Nearly everything can be configured via chat.
Helpful NPCs! Quests can be given by NPCs using Citizens 2! Players can also talk to, deliver items to, or kill, NPCs if you so desire.
Delicious rewards! Give items, experience, permissions, and/or perks from other plugins! Leaderboards are available should you decide to hand out Quest Points.
Get creative! Objectives range from item delivery and enchanting, to mob/player killing and reaching locations.
Unique events! Cause lightning strikes, potion effects, mob swarms, hunger, teleportation and more!
Attention grabbing! By default, NPCs show a particle effect above their heads when quests become available. Players can view those quests via inventory GUI, if configured.
Language support! You can edit nearly every written portion of Quests, down to the menu formatting. Anyone can contribute a translation via our Crowdin page!
Coders rejoice! Three different Quests APIs allow you to build your own requirements, rewards or objectives.

游戏内编辑！你甚至根本不需要去改动配置，几乎所有操作都可以通过聊天栏完成
NPC支持！Quests支持Citizens 2的各种NPC！玩家可以与NPC交谈，甚至给NPC提交物品，甚至击杀NPC
诱人的奖励！你可以将物品，经验，权限，或者其它插件提供的VIP专属特权作为任务奖励！
创造性！你可以把物品转交，附魔，击杀生物/玩家，甚至到达目标地点作为任务！
独特的事件！可以在任务中设置触发雷击，药水效果，怪物生成，饥饿值改变，传送，甚至更多事件！
吸引眼球！默认情况下有可接受任务的NPC可以在头顶显示粒子效果，玩家可点击NPC打开GUI来选取任务
多语言支持！你几乎可以编辑插件的所有可见语言，甚至包含菜单格式！你还可以通过Crowdin提交多语言！
开发者！三种不同的API来让开发者创建属于自己的任务需求，任务奖励和任务目标！

本插件是一个任务插件，让玩家可以完成各种丰富多彩的任务并获得奖励！任务可以是破坏/放置怪物，杀死生物/玩家，到达指定地点等等，甚至可以是回答出一道问题！

插件支持Citizens，可以让NPC作为任务的发布者，甚至以和NPC交谈或者杀死NPC作为任务！

支持多种插件作为前置，可以以杀死MythicMobs或者CustomMobs怪物作为任务，可以限制在某WorldGuard区域内接受任务，还可以以MCMMO技能经验作为任务奖励！

厌倦了繁琐的配置文件编辑任务？本插件让你在游戏内即可编辑任务！输入左侧的数字即可做出选择！

本插件提供了任务可能触发的一系列事件，这些事件也是可以游戏内编辑的！

如果你不喜欢游戏内编辑任务，本帖同样提供了配置编辑的方法，请参下文

↓↓↓以下内容是为喜欢用配置编辑的人准备的，喜欢游戏内编辑的人请直接跳过↓↓↓

使用教程-配置-quests.yml

打开配置文件中的quests.yml 本插件默认自带了4个任务
我们先从一个最简单的任务开始看起

这个任务的名字为“石头矿工”，玩家接受任务后首先看到的是提示语“挖10块石头”，玩家需要拥有一把木镐才能接受任务，否则会显示接受失败的提示语，玩家只要挖掘10块石头（stone:0）即为完成任务，完成任务后玩家将看到完成提示语“干得漂亮！请收下奖励！”，并得到1000金币+1任务点，本任务1800秒之后可以重新领取

配置的一级属性含义

name: 任务的名字，可以使用/quests take <任务名> 来接受任务
ask-message: 玩家接受任务后看到的第一句提示，通常用来作为任务描述
finish-mesage: 玩家完成任务后看到的提示语，通常用来作为祝贺以及描述奖励之用

插件自带的颜色代码是像<yellow>这样的字段，但是我推荐大家用更方便的 § 符号，例如§e
不要使用&作为颜色代码符号！！！！！

redo-delay: 该任务多少秒以后可以重做
npc-giver-id: 该任务由哪个ID的NPC发布？玩家点击NPC即可接受任务，NPC ID请使用数字

需要安装Citizens前置，如果不清楚NPC的ID请使用指令/npc list

npc-giver-id: 0

复制代码

block-start: 玩家点击某世界某方块可以接受该任务，格式block-start: 世界名 X Y Z，例如

block-start: world <a href="tel:230 65 -180">230 65 -180</a>

复制代码

region: 玩家必须处于哪个WorldGuard区域内才能接受该任务，例如

region: Lobby

复制代码

gui-display: 输入指令/questadmin togglegui <NPC ID>可以设置NPC是以聊天的形式展示任务还是以GUI菜单的形式展示任务，若是以GUI形式，该任务会以什么物品显示（物品格式参下文）例如

gui-display: name-WOOD_PICKAXE:amount-1

复制代码

events: 玩家接受该任务后触发的“事件”，详参下文
requirements: 接受该任务的前提，详参下文
stage: 该任务的阶段，详参下文
rewards: 完成该任务的奖励，详参下文
[新] planners: 设置这个任务只能在某个现实的时间点完成，你需要设置任务的开始时间（start）,结束时间（end）,，时间的格式为：日:月:年:时:分:秒:时区，举例如下，该任务的可完成时间为2020年1月11号上午9点到下午17点，1天后可重复执行：

planner:
start: 11:1:2020:9:0:0:SystemV/EST5
end: 11:1:2020:17:0:0:SystemV/EST5
repeat: 86400
cooldown: 32400

复制代码

repeat的作用是重复，将此任务的可用时间不断向后重复，就拿上面的例子而言，设置的repeat是86400秒（1天）那么，在1月12号/13号/14号......的9点到17点都可以接受此任务（这个机制可以做出“每日任务”的效果）
cooldown的作用是设置玩家两次完成任务的最短冷却时间，防止玩家“卡零点”（例如晚上23:59分和凌晨0:01分把两天的每日任务都完成）
通过这个设置项，也可以做出一些特殊节日任务，比如设置每年12月25日完成圣诞节任务，同时repeat设置为31536000（1年）玩家即可每年完成这一任务

使用教程-配置-requirements

quests.yml中的requirements代表“接受该任务需要的前提”，格式如下

money: 领取该任务需要的金钱数量
quest-points: 领取该任务需要的任务点数量
permissions: 领取该任务需要的权限
quests: 只有完成了下列任务才能接受此任务
quest-blocks: 与上面那条相反，一旦完成了下列任务就禁止接受此任务
items: 领取该任务需要的物品，物品格式如下（不一定所有属性都用上）

- name-物品英文名:amount-数量:data-子ID:enchantment-附魔壹附魔等级:enchantment-附魔贰
- 附魔等级:displayname-物品显示的名字:lore-第一行:lore-第二行:lore-第三行

复制代码

以下提供一个示例

- name-DIAMOND_SWORD:amount-1:enchantment-Sharpness 3:enchantment-Looting 2

复制代码

remove-items: 上述物品在领取任务时是否扣除，可选true/false
mcmmo-skills: 和mcmmo-amounts: 领取该任务需要的MCMMO技能和经验必须一一对应！
fall-requirement-message: 当上述条件不满足任何一条时，显示该提示语

以上列出的是修改配置的方法，在游戏中配置更方便

（第一版汉化里我把“任务限制”翻译成了“任务方块”……日……）

使用教程-配置-stage

quests.yml中的stage部分代表任务的分段，你可以把一个大任务分成几个阶段来让玩家进行
当然，只设置一个阶段也是可以的，以下提供一个示例

这个任务被分为3个小阶段，分别是击杀3只猪，击杀2只僵尸，击杀1只骷髅

阶段中各属性含义

break-block-names:
break-block-amounts:
break-block-durability:

这三个属性代表完成该任务需要破坏方块的种类/数量/子ID，三者需要一一对应，格式如下

stages:
ordered:
'1':
break-block-names:
- STONE
- WOOL
break-block-amounts:
- 2
- 10
break-block-durability:
- 0
- 1

复制代码

damage-block-names:
damage-block-amounts:
damage-block-durability:

这三个属性代表完成该任务需要撸的方块的种类/次数/子ID，也就是鼠标左键点击方块，三者一一对应，格式同上

place-block-names:
place-block-amounts:
place-block-durability:

这三个属性代表完成该任务需要放置的方块的种类/数量/子ID，三者一一对应，格式同上

use-block-names:
use-block-amounts:
use-block-durability:

这三个属性代表完成该任务需要“使用”的方块的种类/次数/子ID，例如开关门，按按钮等等，三者一一对应，格式同上

cut-block-names:
cut-block-amounts:
cut-block-durability:

这三个属性代表完成该任务需要手持剪刀“剪”的方块种类/数量/子ID，可以是任何方块，三者一一对应，格式同上

fish-to-catch: 代表完成该任务需要钓鱼的数量，格式如下

fish-to-catch: 5

复制代码

players-to-kill: 代表完成该任务需要击杀的玩家数量，格式如下

players-to-kill: 5

复制代码

enchantments:
enchantment-item-names:
enchantment-amounts:

这三个属性代表完成该任务需要附魔出的属性/被附魔的物品/附魔的次数，三者一一对应，例如钻石胸甲，附魔保护属性1次，物品名称建议使用数字ID而非英文名称，格式如下

enchantments:
- 保护
- 火焰保护
enchantment-item-names:
- 311
- 313
enchantment-amounts:
- 1
- 1

复制代码

items-to-deliver:
npc-delivery-ids:
delivery-messages:

这三个属性代表要转交给NPC的物品/转交NPC的ID/转交后NPC说的话，三者一一对应，需要安装Citizens前置，物品格式请参上方requirements-items部分，格式如下

items-to-deliver:
- name-FISHING_ROD:amount-1
npc-delivery-ids:
- 0
delivery-messages:
- 货物已经安全送到了吗？太感谢你了！

复制代码

npc-ids-to-talk-to: 代表完成该任务需要与之交谈的NPC ID，“交谈”即右键点击NPC即可，格式如下

npc-ids-to-talk-to:
- 0

复制代码

npc-ids-to-kill:
npc-kill-amounts:

这两个属性代表完成该任务要击杀的NPC ID以及击杀次数，二者一一对应，格式如下

npc-ids-to-kill:
- 0
npc-kill-amounts:
- 1

复制代码

mobs-to-kill:
mob-amounts:
locations-to-kill:
kill-location-radii:
kill-location-names:

这五个属性代表完成该任务需要击杀的怪物种类/击杀数量/击杀位置/击杀位置半径/击杀位置名称，五者一一对应，“击杀位置”的格式为“世界名 X Y Z”，“击杀位置半径”代表以击杀位置为中心多少格内的击杀算有效击杀，格式如下

mobs-to-kill:
- Pig
mob-amounts:
- 1
locations-to-kill:
- world -201.0 65.0 203.0
kill-location-radii:
- 3
kill-location-names:
- 击杀点

复制代码

locations-to-reach:
reach-location-radii:
reach-location-names:

这三个属性代表完成该任务需要到达的位置/位置半径/位置名称，三者一一对应，“到达位置”的格式为“世界名 X Y Z”，“位置半径”代表以到达位置为中心玩家进入多少格内即算成功到达，格式如下

locations-to-reach:
- world -201.0 65.0 203.0
reach-location-radii:
- 2
reach-location-names:
- 到达点

复制代码

mobs-to-tame:
mob-tame-amounts:

这两个属性代表完成该任务需要驯服的生物种类/次数，二者一一对应，格式如下

mobs-to-tame:
- Wolf
mob-tame-amounts:
- 1

复制代码

sheep-to-shear:
sheep-amounts:

这两个属性代表完成该任务需要剪羊毛的颜色/数量，二者一一对应，剪羊毛颜色属性请务必使用英文单词而非中文汉字，格式如下

sheep-to-shear:
- white
- yellow
sheep-amounts:
- 5
- 5

复制代码

password-displays:
password-phrases:

这两个属性代表完成该任务需要回答的问题/问题的答案，二者一一对应，格式如下

password-displays:
- Vexview插件的作者是谁？
password-phrases:
- LK520

复制代码

同样你可以给一个问题设置多个答案，每个答案请使用竖杠 | 隔开，例如

password-displays:
- 你们是不是应该给秋风残叶的帖子评个人气？
password-phrases:
- Yes|当然|是的|一定|那肯定的啊

复制代码

start-event: 任务开始时触发的事件，请参下文
finish-event: 任务结束时触发的事件，请参下文
disconnect-event: 玩家突然掉线触发的事件，一般设置为任务失败，请参下文
death-event: 玩家死亡触发的事件，一般设置为任务失败，请参下文

chat-event-triggers:
chat-events:

这两个属性代表玩家在聊天栏发送哪些内容会触发事件/触发的事件名，二者一一对应，格式如下

chat-event-triggers:
- 我要篡位
chat-events:
- 篡位剧情

复制代码

delay: 该阶段任务结束后，要冷却多少秒才能开始下一个阶段
delay-message: 任务冷却中的提示语，格式如下

delay: 1
delay-message: 还在冷却中！

复制代码

start-message: 该阶段任务开始时的提示语
complete-message: 该阶段任务完成时的提示语

【附属：MythicMobs Quests Module】

该附属可将击杀MythicMobs怪物作为任务要求

需要先安装MythicMobs4.1.0以上版本以及下载MythicMobs Quests Module原帖，然后将附属放入plugins/Quests/modules文件夹，重启服务器

你可以在游戏里编辑任务，简单方便，如果你想用配置编辑任务，以下提供一个示例

name: Kill MythicMobs Objective 这个不要改
count: 击杀生物的数量
Mob Level: 怪物的等级，使用0代表不限等级
Mob Faction: 怪物的派系，使用ANY代表不限派系
Objective Name: 在任务中显示的怪物名称，这个随意填
Internal Mobnames: 怪物在mm配置文件里的名字，也就是你用/mm mobs list看到的名字
Notifier enabled: 每杀一只怪物是否开启提示语（很奇怪居然不是布尔值数据）
Notifier msg: 每杀一只怪物的提示语 %c%代表已经击杀的量 %s%代表总量

【附属：CustomMobs Quests Module】

该附属可将击杀CustomMobs怪物作为任务要求

需要先安装CustomMobs4.0以上版本以及下载CustomMobs Quests Module原帖，然后将附属放入plugins/Quests/modules文件夹，重启服务器

你可以在游戏里编辑任务，简单方便，如果你想用配置编辑任务，以下提供一个示例

name: Kill CustomMobs 这个不要改
count: 击杀生物的数量
KillNames: 生物的名称
ObjectiveNames: 在任务中显示的怪物名称，这个随便填

附属不是插件，不应该放在plugins文件夹！！

问问题前请仔细阅读帖子！！

你可以在这里看到和Quests有关的更多附属

使用教程-配置-events

events部分本身代表“事件”，即在接受任务到完成任务之间触发的一系列事件

events的各配置在events.yml文件中，以下是一个例子

当这个名叫ExampleEvent的事件被触发时，玩家会看见消息：你获得了药水效果! 同时获得速度IV100秒以及跳跃III25秒

事件中各属性含义

message: 该事件被触发后玩家看到的消息，可加以§开头的彩色代码，不要使用&开头的彩色代码
items: 该事件被触发后玩家获得的物品物品格式参上方requirements-items部分，格式如下

items:
- name-DIAMOND_PICKAXE:amount-1:data-2

复制代码

potion-effect-types:
potion-effect-durations:
potion-effect-amplifiers:

这三个属性代表该事件被触发后玩家获得的药水效果种类/时长/等级，格式见本部分最上方例子

explosions: 该事件被触发后在某世界某坐标产生一次爆炸，格式如下

explosions:
- world -261.0 64.0 134.0

复制代码

lightning-strikes: 该事件被触发后在某世界某坐标产生一次雷击，格式如下

lightning-strikes:
- world -1.0 127.0 59.0

复制代码

commands: 该事件被触发后执行的控制台指令，可使用<player>变量指代执行任务的玩家

请注意是控制台指令，不是OP指令也不是玩家指令！某些只能由玩家执行的指令可能无法执行！

commands:
- eco give <player> 1000

复制代码

teleport-location: 该事件被触发后将玩家传送至某世界某坐标，格式如下

teleport-location: world 8.0 127.0 59.0

复制代码

health: 该事件被触发后设置玩家的血量值
hunger: 该事件被触发后设置玩家的饥饿值

effects:
effect-locations:

这两个属性代表该事件被触发后听到的音效/音效被播放的坐标，二者一一对应，格式如下

effects:
- GHAST_SHOOT
effect-locations:
- world -267.0 64.0 125.0

复制代码

clear-inventory: 该事件被触发后是否清空玩家背包，谨慎使用，可选true/false
fail-quest: 该事件被触发后是否任务失败，一般和death-event:连用，即“玩家死亡，任务失败”，可选true/false

storm-world:
storm-duration:

这两个属性代表该事件被触发后某世界开始下雨以及下雨的时长，时长单位是tick，格式如下

storm-world: world
storm-duration: 40

复制代码

thunder-world:
thunder-duration:

这两个属性代表该事件被触发后某世界开始雷雨以及雷雨的时长，时长单位是tick，格式如下

thunder-world: world
thunder-duration: 60

复制代码

mob-spawns: 该事件被触发以后生成怪物，属性较多，请参下方配置格式

[3.x新增] timer: 任务限时秒，超时即主任务失败（而非任务阶段失败），一般和start-event:连用，即“任务开始，计时开始”，格式如下

timer: 40

复制代码

[3.x新增] cancel-timer: 任务计时取消，即不再限时，一般和finish-event:连用，即“阶段达成，计时取消”，可选true/false

使用教程-配置-rewards

quests.yml中的rewards代表完成全部阶段任务获得的奖励，以下是一个例子

money: 金钱奖励
quest-points: 任务点奖励
exp: 经验奖励
items: 物品奖励物品格式参上文
commands: 完成任务后执行的控制台指令
permissions: 完成任务后给玩家添加的权限
mcmmo-skills:
mcmmo-levels: 这两项是MCMMO技能名称以及相应的经验奖励，二者一一对应，如果把技能名称设置为ALL代表所有技能

↑↑↑以上内容是为喜欢用配置编辑的人准备的，喜欢游戏内编辑的人请忽略上文↑↑↑

指令&权限

/quests 玩家指令帮助
/questadmin 管理员指令帮助

指令帮助内容已全部汉化，不在本帖赘述

本插件权限系统已经默认配置好，不需要做其他更改

config参数

更多帮助请参这里

常见问题

汉化

800多行汉化……可能会有翻译不准确的地方
例如我可能把霸气的“鸦翔式”翻译成难听的“乌鸦坐飞机”，这都是可能存在的
所以我在考虑要不要把汉化重完善一下

请把汉化文件放入plugins/Quests/lang/zh-CN文件夹

strings.yml (45.99 KB, 下载次数: 2289, 售价: 15 粒金粒)

汉化文件对应版本3.7.8（2019.09.05）

安装汉化后请重启服务器，而非重载插件

搬运者没有及时更新汉化怎么办？

示例任务[当前 2 个]

我随便写几个示例任务好了，供你们参考，可能更新也可能不更新
示例任务中提到的服务器名剧情名地名人名均为虚构

以下任务涉及到的事件events.yml

《任务一》

任务描述：请在60秒内击杀邪恶的BOSS（来自MythicMobs）
任务奖励：1000金币 100经验
任务备注：如果中途死亡/掉线/超时则任务失败
备注：需要安装MythicMobs以及添加相应附属

《任务二》

任务描述：PCD组长夜幕病了请去镇子外面寻找药草找到后请把药草转交给组长夜幕
任务奖励：成为OP
备注：需要安装Citizens前置

下载地址

本插件已不再支持1.7

支持原作者，请至原帖下载

更新记录

[groupid=1330]PluginsCDTribe[/groupid]

回复:

eerr12

谢谢更新～～

2017-08-05 13:41:00

Krito

欢迎汉化王子先生，你的汉化无处不在，不知道你能不能汉化下，PhatLoots随机箱子插件呢，
这个插件是目前配合非lore属性的 RPG插件掉落使用，
啊跑题了，
感谢你的汉化

2017-08-05 13:45:00

ouAuAuo

二搬许可的图是挂了么.....

秋风dalao搬运真是厉害呢
（默默下载插件安装中....）

2017-08-05 13:58:00

[综合][PCD]Quests——经典的任务插件 教程+汉化[1.8-1.15]

回复:

[综合][PCD]Quests——经典的任务插件教程+汉化[1.8-1.15]