BasicQuests
为玩家随机生成基础任务并提供奖励。
无需初始配置!
非常欢迎任何反馈、建议和新点子。您的评价对我们非常重要!
工作原理
每位玩家会获得一定数量的初始任务(默认:3)。
你可以使用 /quests list 或 /quests list rewards 查看你的活跃任务。
当玩家完成任务后,可以通过点击聊天中的奖励按钮或使用 /quests reward 领取奖励。
一旦任务奖励被领取,该任务将从列表中消失,并添加一个新生成的任务。
默认情况下,玩家每 24 小时可以使用 /quests skip 跳过一次任务。
某些任务要求玩家在生成前完成相应的进度。例如,下界的任务要求玩家必须完成 “钻石!” 进度。
此外,新生成任务的数量会随着玩家在服务器上的游戏时长按比例增加:新手玩家可能会收到像 “开采 32 个铁矿石” 这样的任务,而资深玩家则更可能收到类似 “开采 512 个铁矿石” 的任务。
此功能可以在 config.yml 中精确调整,也可以完全关闭。
有些任务极其罕见,但完成后承诺给予极高的奖励。每个任务根据其难度分配一定数量的星星(⭐)。通过完成任务收集星星,并使用 /quests leaderboard 查看排行榜与他人竞争。
任务类型
任务在 Basic Quests 中是随机生成的。
目前可用的任务类型及部分示例如下:
- 开采方块
- 击杀生物
- 收获方块
- 砍伐树木
- 附魔物品
- 寻找结构
- 与村民交易
- 提升等级
- 达到等级
- 破坏方块
- 钓鱼获取物品(新增)
- 提升属性(新增)
我正在考虑在未来实现的任务想法:
奖励
可能的奖励类型为 物品、金钱 或 经验值。你可以在 config.yml 中启用或禁用每种奖励类型。
默认情况下,仅启用物品奖励。若要使用金钱奖励,你需要通过 Vault 连接一个 经济插件。
如果启用了多种奖励类型,则在生成新任务时会随机选择一种——至少必须启用一种奖励类型,否则 BasicQuests 将无法工作。
奖励的价值与任务的价值成正比,并乘以 reward-factor(可在 config.yml 中调整)。
给定任务的价值由其生成过程中的多个因素决定。
虽然金钱和经验值奖励不言自明,但我将列出一些物品奖励的示例:
- 工具(铁 - 下界合金)(可能已附魔)
- 盔甲(链甲 - 下界合金)(可能已附魔)
- 锻造模板
- 附魔书
- 药水(仅限正面效果 - 延长版 (+) 和升级版 (II) 变体)
- 食物
- 资源(你在地下能找到的大多数贵重物品 - 从燧石到下界合金)
- 稀有物品(附魔金苹果、音乐唱片、鞍、...)
任务生成自定义
BasicQuest 允许管理员使用 quest_generation 目录中的一堆 yaml 文件来微调服务器上的任务生成。
这允许:
- 调整或移除各类任务的概率
- 调整或移除特定任务类型内具体任务的概率
- 使某些任务变得更有价值或更低价值。这将反映在奖励的价值上。
- 调整任务中出现的数量。
有关如何微调生成过程的更多信息,请查看 plugins/BasicQuests/quest_generation/README.md 中的 readme 文件
示例任务
你现在已经了解了可用的任务类型和奖励类型。
以下是一些随机生成的任务及其奖励示例。
请记住,有很多可能性可以在 config.yml 和 quest_generation 文件中调整任务和奖励的生成。
显示任务
开采 144 个煤矿石 (⭐⭐)
收获 32 个土豆 (⭐)
砍伐 160 根原木 (⭐⭐)
附魔一把钻石斧 (⭐)
钓取宝藏 (⭐⭐)
找到一个沼泽小屋 (⭐⭐⭐⭐⭐)
收获 48 个小麦 (⭐)
收获 16 个土豆 (⭐)
收获 14 个紫颂花 (⭐⭐⭐⭐⭐)
找到一个末地城 (⭐⭐⭐⭐⭐)
击杀 10 头牛 (⭐)
开采 48 个下界石英矿石 (⭐⭐⭐)
附魔一把带有击退 I+ 的钻石剑 (⭐⭐)
破坏 4 个紫水晶簇 (⭐⭐)
找到一个海洋纪念碑 (⭐⭐⭐⭐)
乘坐矿车行驶 600 米 (⭐⭐⭐⭐)
钓起 20 条鱼 (⭐⭐)
开采 4 个远古残骸 (⭐⭐⭐⭐)
收获 96 个胡萝卜 (⭐⭐)
骑马骑行 2 公里 (⭐⭐⭐⭐)
- 1 本附魔书:保护 IV
- 1 本附魔书:横扫 III
砍伐 64 根原木 (⭐)
播放一些音乐 (⭐⭐⭐⭐)
升级 40 次 (⭐⭐⭐)
奔跑 7.5 公里 (⭐⭐⭐⭐)
砍伐 160 根原木 (⭐⭐)
与皮革匠交易 4 次 (⭐⭐)
附魔一双带有疾行 I+ 的钻石靴 (⭐⭐⭐)
找到一个村庄 (⭐⭐⭐)
收获 40 个下界疣 (⭐⭐⭐)
收获 80 个甘蔗 (⭐⭐)
收获 112 个甜菜根 (⭐⭐)
找到一座海洋神殿 (⭐⭐⭐⭐)
收获 32 个甘蔗 (⭐)
与农民交易 2 次 (⭐⭐)
敲响钟 (⭐⭐⭐⭐)
为钻石胸甲附魔耐久 I+ (⭐⭐⭐)
找到一座海底废墟 (⭐⭐⭐)
找到一座沙漠神殿 (⭐⭐⭐)
与村民交易 8 次 (⭐⭐)
达到等级 45 (⭐⭐)
击杀 28 末影人 (⭐⭐⭐⭐⭐)
与石匠交易 8 次 (⭐⭐⭐)
找到一艘沉船 (⭐⭐⭐)
与牧师交易 4 次 (⭐⭐⭐)
挖掘 160 个煤矿石 (⭐⭐)
收获 48 个棕色蘑菇 (⭐⭐)
达到等级 45 (⭐⭐)
为钻石镐附魔效率 I+ (⭐⭐)
升级 40 次 (⭐⭐⭐)
- 1 附魔书:水下呼吸 III
- 1 锁链胸甲:弹射物保护 II
收获 40 个红色蘑菇 (⭐⭐)
找到一座沙漠神殿 (⭐⭐⭐)
附魔 6 本书 (⭐⭐)
与村民交易 12 次 (⭐⭐⭐)
破坏 6 个紫水晶簇 (⭐⭐)
骑马奔跑 11 公里 (⭐⭐⭐⭐⭐)
- 1 下界合金剑:抢夺 II
- 1 附魔书:火焰保护 IV
乘船旅行 2 公里 (⭐⭐⭐)
- 1 铁铲:效率 IV
- 1 音乐唱片 Pigstep
砍伐 64 段原木 (⭐)
奔跑 15 公里 (⭐⭐⭐⭐⭐)
与牧师交易 6 次 (⭐⭐⭐)
乘船旅行 1 公里 (⭐⭐)
为弩附魔穿透 III+ (⭐⭐⭐)
收获 48 个小麦 (⭐)
收获 32 个竹子 (⭐⭐)
收获 32 个甘蔗 (⭐)
找到一个村庄 (⭐⭐⭐)
收获 32 个甘蔗 (⭐)
找到一座下界要塞 (⭐⭐⭐⭐)
砍伐 160 段原木 (⭐⭐)
以下任务的生成使用了 quantity-factor 为 3.0,而非默认的 1.0
在矿车中行驶 5.5 公里 (⭐⭐⭐⭐⭐)
奔跑 62.5 公里 (⭐⭐⭐⭐⭐⭐⭐)
挖掘 9 个绿宝石矿石 (⭐⭐⭐⭐⭐)
收获 80 个下界疣 (⭐⭐⭐⭐)
砍伐 128 段原木 (⭐)
收获 96 个可可豆 (⭐⭐⭐)
击杀 60 末影人 (⭐⭐⭐⭐⭐⭐)
挖掘 688 个煤矿石 (⭐⭐⭐)
挖掘 272 个铁矿石 (⭐⭐⭐)
收获 336 个胡萝卜 (⭐⭐⭐)
与弓箭手交易 14 次 (⭐⭐)
击杀 51 岩浆怪 (⭐⭐⭐⭐⭐⭐)
砍伐 288 段丛林原木 (⭐⭐⭐)
为钻石胸甲附魔耐久 I+ (⭐⭐⭐)
收获 24 个棕色蘑菇 (⭐⭐)
占位符
BasicQuests 支持以下占位符:
%bquests% 玩家任务的多行列表(与 /quests list 输出相同)
%bquests_detail% 玩家任务及其奖励的多行列表(与 /quests list reward 输出相同)
%bquests_count% 玩家拥有的任务数量
%bquests_completed% 玩家已完成的任务数量
%bquests_top_<index>% 完成最多任务的玩家排行榜(逐行显示)
%bquests_<index>% 给定索引处的玩家任务
%bquests_<index>_title% 给定索引处玩家任务的标题
%bquests_<index>_progress% 给定索引处玩家任务的进度:"1/16" 或 "已完成!"
%bquests_<index>_left% 给定索引处玩家任务剩余的数量:"剩余 15"
%bquests_<index>_<linenumber>% 将特定任务拆分为适合告示牌显示的 4 行。(linenumber 可为 1 - 4,请参见下方示例)
%bquests_<index>_reward_<linenumber>% 将特定任务的奖励拆分为 2 行。非常适合记分板。(linenumber 可为 1 - 2,请参见下方示例)
占位符示例
显示示例
记分板
可以使用如 AnimatedScoreboard 等记分板插件在自定义记分板上显示任务。
下面展示了两个示例以及所使用的占位符。
带有奖励的任务:
任务:
%bquests_1%
%bquests_1_reward_1%
%bquests_1_reward_2%
%bquests_2%
%bquests_2_reward_1%
%bquests_2_reward_2%
%bquests_3%
%bquests_3_reward_1%
%bquests_3_reward_2%

与其他插件并排的任务:
任务:
%bquests_1%
%bquests_2%
%bquests_3%
工作:
...

配置文件
显示 config.yml
# 这是 BasicQuests 的配置文件。
# 此配置是为版本 0.5 生成的
# 你可以删除此文件以在服务器重载时重新生成默认配置。
# 常规设置
# 玩家同时持有的任务数量
# 推荐值:最小值 = 3,最大值 = 6
quest-amount: 3
# 玩家每天允许跳过任务的次数。(每天重置)
skips-per-day: 1
# 当玩家完成任务时向所有人广播消息
broadcast-on-quest-complete: true
# 当玩家完成任务时播放音效(仅对玩家本人)
sound-on-quest-complete: true
# 禁用内置记分板(/quests scoreboard)
# 仅在因其他插件占用导致记分板无法正常工作时,才应将其设置为 true。
# 始终可以通过 PlaceholderAPI 在自定义记分板上显示任务。
disable-scoreboard: false
# 默认情况下为新玩家显示记分板
show-scoreboard-per-default: true
# 设置插件的语言环境。
# 如果您希望支持您的语言,请联系我。您可能需要协助进行翻译工作。
# 可用的语言环境:
# en: English, de: German, es: Spanish, ru: Russian
locale: en
# 是否应向管理员和控制台通告新更新。
# 除非新版本与您的服务器不兼容,否则始终建议更新至最新版本。
check-for-updates: true
# 玩家数据的保存间隔(分钟)
# 保存过程可能会在大服务器上引起卡顿。增加此参数以减少保存频率。
# 推荐值:min = 10
save-interval: 10
# 编辑以下列表以防止在具有给定名称的世界中进行任务进度。
# 注意不要破坏列表的格式。
banned-worlds:
- world_creative
- world_without_quest_progress
# 插件用于显示任务获得的星星的替代字符
# 替换默认字符。应为有效的 Unicode 字符。
# 取消注释以下行以启用替代字符。
# star-character: "*"
# 任务生成
# 奖励价值的系数
# 推荐值:min = 0.5, max = 3.0
reward-factor: 1.0
# 任务中数量的系数——例如,要击杀的僵尸数量
# 推荐值:min = 0.5, max = 3.0
quantity-factor: 1.0
# 根据玩家的游玩时间增加任务中的数量。
increase-quantity-by-playtime: true
# 玩家加入游戏时的系数
start-factor: 0.4
# 玩家达到 <max-amount-hours> 小时游玩时间时的系数
max-factor: 3.0
# 玩家在此游玩小时后收到具有最大数量的任务
max-amount-hours: 100
# 重复任务的几率 [0.0 - 1.0]
# 0.0: 不会出现重复任务(当 quest-amount 高于 4 时不建议使用)
# 1.0: 玩家活跃的任务对新生成任务的选择没有影响
duplicate-quest-chance: 0.3
# 奖励
# 选择您希望为任务生成的奖励类型
# 如果将多种类型设置为 true,则新任务将随机选择一种奖励类型
# 启用物品作为奖励
item-rewards: true
# 启用经验值作为奖励
xp-rewards: false
# 启用货币作为奖励(需要通过 Vault 挂钩经济插件)
money-rewards: false
# 经济
# 货币奖励的系数
# 根据您的服务器上的货币价值调整此值。
money-factor: 1.0
权限
显示权限
basicquests.use.list:
default: true
description: 允许玩家查看他们的任务
basicquests.use.scoreboard:
default: true
description: 允许玩家使用记分板来显示任务
basicquests.use.reward:
default: true
description: 允许玩家接收他们的奖励
basicquests.use.skip:
default: true
description: 允许玩家每天跳过有限数量的任务。数量可在 config.yml 中配置
basicquests.use.leaderboard:
default: true
description: 允许玩家查看排行榜
basicquests.admin.list:
default: op
description: 允许玩家列出其他人的任务
basicquests.admin.skip.unlimited:
default: op
description: 允许玩家无限跳过任务
basicquests.admin.skip.others:
default: op
description: 允许玩家替其他玩家跳过任务
basicquests.admin.reset:
default: op
description: 允许玩家重置任务
basicquests.admin.reset.others:
default: op
description: 允许玩家重置其他玩家的任务
basicquests.admin.reset.global:
default: op
description: 允许玩家一次性重置所有玩家的任务
basicquests.admin.complete:
default: op
description: 允许玩家通过命令完成任务
basicquests.admin.complete.others:
default: op
description: 允许玩家替其他玩家完成任务
basicquests.admin.update:
default: op
description: 允许玩家或控制台检查 BasicQuests 的更新
basicquests.admin.reload:
default: op
description: 允许玩家使用 reload 命令
许可证
Copyright (C) 2020-2024, Anton Stamme
BasicQuests 是自由软件:您可以根据自由软件基金会发布的 GNU 通用公共许可证(版本 3 或(由您选择的)任何更高版本)重新分发和/或修改它。
BasicQuests 的发布是为了希望它有用,
但没有任何保证;甚至没有隐含的适销性或特定用途适用性的保证。有关更多细节,请参阅
GNU 通用公共许可证。
您应该已经随 BasicQuests 收到了 GNU 通用公共许可证的副本。如果没有,请参见 。
BasicQuests
Randomly generated basic quests with rewards for players.
No initial configuration needed!
I would be very happy about any feedback, recommendations and new ideas. Reviews are very much appreciated!
How it works
Every player receives an initial number of quests (default: 3).
You can view your active quests by using /quests list or /quests list rewards.
When a player completes a quest, the reward can be received by clicking the reward button in the chat or by using /quests reward.
As soon as a quest's reward has been collected, the quest disappears from the list, and a newly generated quest will be added.
By default, a player is allowed to skip one quest every 24h by using /quests skip.
Some quests require the player to complete an advancement before they can be generated. Quests in the nether, for example, require the player to have completed the "Diamonds!" advancement.
Also, newly generated quests will increase in their quantities proportional to the players' playtime on the server: While a new player might receive a quest like "Mine 32 Iron Ore" a player with lots of playtime on the server would rather receive a quest like this "Mine 512 Iron Ore".
This feature can be precisely adjusted in the config.yml or be turned off entirely.
Some quests are incredibly rare but promise very high rewards once completed. Each quest is assigned a number of stars (⭐) based on its difficulty. Collect stars by completing quests and compete with others on the leaderboard which can be viewed using /quests leaderboard.
Quests
Quests are randomly generated in Basic Quests.
Currently available quest types along with some examples are listed below:
- Mine Block
- Kill Entity
- Harvest Block
- Chop Wood
- Enchant Item
- Find Structure
- Trade with Villager
- Gain Level
- Reach Level
- Break Block
- Fish Item (new)
- Increase Stat (new)
Quest ideas I am thinking about implementing in the future:
- Breed Animal
- Tame Animal
- Smelt Item
- Brew Potion
Rewards
Possible Rewards are either Items, Money or XP. You can enable or disable each of these reward types in the config.yml.
By default, only item-rewards are enabled. In order to use money-rewards you need to have an economy plugin connected via Vault.
If multiple reward types are enabled one will be chosen at random when a new quest is generated - at least one reward type must be enabled or BasicQuests will not work.
The value of a reward is proportional to the value of the quest and is multiplied by the reward-factor which can also be adjusted in the config.yml.
The value of a given quest is determined by a number of factors along its generation process.
While money and xp-rewards are self-explanatory I'll list some examples for item-rewards below:
- Tools (Iron - Netherite) (Maybe enchanted)
- Armor (Chainmail - Netherite) (Maybe enchanted)
- Smithing Templates
- Enchanted Books
- Potions (Only positive effects - extended (+) and upgraded (II) variants)
- Food
- Resources (Most of the valuable things you can find underground - From Flint to Netherite)
- Rare Items (Enchanted Golden Apple, Music Disks, Saddle, ...)
Quest Generation Customization
BasicQuest allows admins to fine-tune the quest generation on their servers using a bunch of yaml files in the quest_generation directory.
This allows for:
- adjusting or removing the probability of quest types
- adjusting or removing the probability of specific quests within a quest type
- making certain quests more or less valuable. This will be reflected in the value of the reward.
- adjusting the amounts that appear in quests.
For further information about how to fine tune the generation process check out the readme file at plugins/BasicQuests/quest_generation/README.md
Example Quests
You now know what type of Quests and Rewards are available.
Here are some examples of randomly generated Quests along with their Rewards.
Remember that there are a lot of possibilities to tweak the Quest and Reward generation in the config.yml and in the quest_generation files.
Show Quests
Mine 144 Coal Ore (⭐⭐)
Harvest 32 Potatoes (⭐)
- 4 Copper Ingot
- 1 Iron Hoe
Chop 160 Logs (⭐⭐)
Enchant a Diamond Axe (⭐)
Fish a treasure (⭐⭐)
- 1 Iron Pickaxe: Efficiency IV
Find a Swamp Hut (⭐⭐⭐⭐⭐)
Harvest 48 Wheat (⭐)
Harvest 16 Potatoes (⭐)
Harvest 14 Chorus Flowers (⭐⭐⭐⭐⭐)
Find an End City (⭐⭐⭐⭐⭐)
- 1 Trident: Unbreaking I
- 1 Enchanted Book: Infinity
Kill 10 Cows (⭐)
Mine 48 Nether Quartz Ore (⭐⭐⭐)
- 1 Iron Boots: Unbreaking III
Enchant a Diamond Sword with Knockback I+ (⭐⭐)
- 4 Splash Potion: Regeneration +
Break 4 Amethyst Clusters (⭐⭐)
Find an Ocean Monument (⭐⭐⭐⭐)
Drive 600m in a Minecart (⭐⭐⭐⭐)
- 1 Netherite Sword: Sweeping III
Catch 20 fish (⭐⭐)
Mine 4 Ancient Debris (⭐⭐⭐⭐)
- 6 Sea Lantern
- 48 Cooked Porkchop
Harvest 96 Carrots (⭐⭐)
- 3 Splash Potion: Water Breathing
Ride 2km on a Horse (⭐⭐⭐⭐)
- 1 Enchanted Book: Protection IV
- 1 Enchanted Book: Sweeping III
Chop 64 Logs (⭐)
- 1 Fishing Rod: Luck Of The Sea I
Play some Music (⭐⭐⭐⭐)
Level up 40 times (⭐⭐⭐)
- 1 Enchanted Book: Power V
Run 7,5km (⭐⭐⭐⭐)
Chop 160 Logs (⭐⭐)
Trade with a Leatherworker 4 times (⭐⭐)
Enchant a Diamond Boots with Swift Sneak I+ (⭐⭐⭐)
Find a Village (⭐⭐⭐)
Harvest 40 Nether Warts (⭐⭐⭐)
Harvest 80 Sugar Cane (⭐⭐)
Harvest 112 Beetroots (⭐⭐)
Find an Ocean Monument (⭐⭐⭐⭐)
Harvest 32 Sugar Cane (⭐)
- 1 Iron Leggings
- 1 Potion: Instant Health II
- 1 Iron Sword
Trade with a Farmer 2 times (⭐⭐)
Ring a Bell (⭐⭐⭐⭐)
Enchant a Diamond Chestplate with Unbreaking I+ (⭐⭐⭐)
Find an Ocean Ruin (⭐⭐⭐)
Find a Desert Pyramid (⭐⭐⭐)
- 1 Diamond Sword: Fire Aspect I
Trade with a Villager 8 times (⭐⭐)
Reach level 45 (⭐⭐)
- 1 Enchanted Book: Unbreaking III
Kill 28 Endermen (⭐⭐⭐⭐⭐)
Trade with a Mason 8 times (⭐⭐⭐)
- 1 Diamond Axe
- 6 Potion: Instant Health II
Find a Shipwreck (⭐⭐⭐)
Trade with a Cleric 4 times (⭐⭐⭐)
Mine 160 Coal Ore (⭐⭐)
Harvest 48 Brown Mushrooms (⭐⭐)
Reach level 45 (⭐⭐)
Enchant a Diamond Shovel with Fortune I+ (⭐⭐)
Level up 40 times (⭐⭐⭐)
- 1 Enchanted Book: Respiration III
- 1 Chainmail Chestplate: Projectile Protection II
Harvest 40 Red Mushrooms (⭐⭐)
Find a Desert Pyramid (⭐⭐⭐)
Enchant 6 Books (⭐⭐)
Trade with a Villager 12 times (⭐⭐⭐)
Break 6 Amethyst Clusters (⭐⭐)
Ride 11km on a Horse (⭐⭐⭐⭐⭐)
- 1 Netherite Sword: Looting II
- 1 Enchanted Book: Fire Protection IV
Travel 2km with a Boat (⭐⭐⭐)
- 1 Iron Shovel: Efficiency IV
- 1 Music Disc Pigstep
Chop 64 Logs (⭐)
Run 15km (⭐⭐⭐⭐⭐)
- 12 Amethyst Shard
- 1 Snout Armor Trim Smithing Template
Trade with a Cleric 6 times (⭐⭐⭐)
- 1 Dune Armor Trim Smithing Template
Travel 1km with a Boat (⭐⭐)
Enchant a Crossbow with Piercing III+ (⭐⭐⭐)
Harvest 48 Wheat (⭐)
- 4 Copper Ingot
- 1 Iron Pickaxe
Harvest 32 Bamboo (⭐⭐)
Harvest 32 Sugar Cane (⭐)
Find a Village (⭐⭐⭐)
Harvest 32 Sugar Cane (⭐)
Find a Nether Fortress (⭐⭐⭐⭐)
- 1 Enchanted Book: Protection IV
Chop 160 Logs (⭐⭐)
The following quests were generated with a quantity-factor of 3.0 instead of 1.0
Drive 5,5km in a Minecart (⭐⭐⭐⭐⭐)
Run 62,5km (⭐⭐⭐⭐⭐⭐⭐)
Mine 9 Emerald Ore (⭐⭐⭐⭐⭐)
Harvest 80 Nether Warts (⭐⭐⭐⭐)
Chop 128 Logs (⭐)
Harvest 96 Cocoa Beans (⭐⭐⭐)
Kill 60 Endermen (⭐⭐⭐⭐⭐⭐)
- 576 Arrow
- 18 Splash Potion: Instant Health II
Mine 688 Coal Ore (⭐⭐⭐)
Mine 272 Iron Ore (⭐⭐⭐)
Harvest 336 Carrots (⭐⭐⭐)
Trade with a Fletcher 14 times (⭐⭐)
Kill 51 Magma Cubes (⭐⭐⭐⭐⭐⭐)
Chop 288 Jungle Logs (⭐⭐⭐)
Enchant a Diamond Chestplate with Unbreaking I+ (⭐⭐⭐)
Harvest 24 Brown Mushrooms (⭐⭐)
Placeholder
BasicQuests supports the following placeholders:
%bquests% A (multiline) list of the players quests (same output as /quests list)
%bquests_detail% A (multiline) list of the players quests and rewards (same output as /quests list reward)
%bquests_count% The amount of quests the player has
%bquests_completed% The amount of quests the player has completed
%bquests_top_<index>% The leaderboard of players with most completed quests (line by line)
%bquests_<index>% The players quest at the given index
%bquests_<index>_title% The title of the players quest at the given index
%bquests_<index>_progress% The progress of the players quest at the given index: "1/16" or "Completed!"
%bquests_<index>_left% The amount left of the players quest at the given index: "15 left"
%bquests_<index>_<linenumber>% The title of a given quest split into 4 lines that fit on a sign. (linenumber can be 1 - 4, Check the example below)
%bquests_<index>_reward_<linenumber>% The reward of a given quest split into 2 lines. Handy for Scoreboards. (linenumber can be 1 - 2, Check the example below)
Placeholder Examples
Show Examples
Scoreboards
Scoreboard plugins like AnimatedScoreboard can be used to display quests on a custom scoreboard.
Two examples along with the used placeholders are shown below.
####Quests with rewards:
Quests:
%bquests_1%
%bquests_1_reward_1%
%bquests_1_reward_2%
%bquests_2%
%bquests_2_reward_1%
%bquests_2_reward_2%
%bquests_3%
%bquests_3_reward_1%
%bquests_3_reward_2%

####Quests next to other plugins:
Quests:
%bquests_1%
%bquests_2%
%bquests_3%
Jobs:
...

Config
Show config.yml
# This is the config file for BasicQuests.
# This config was generated for version 0.5
# You can delete this file to regenerate the default config on server reload.
# GENERAL
# amount of quests a player holds at a time
# recommended values: min = 3, max = 6
quest-amount: 3
# times a player is allowed to skip a quest. (resets every day)
skips-per-day: 1
# broadcasts a message to everyone if a player completes a quest
broadcast-on-quest-complete: true
# plays a sound when a quest has been completed (only for the player)
sound-on-quest-complete: true
# disable the inbuilt scoreboard (/quests scoreboard)
# should only be set to true if the scoreboard does not work correctly because of another plugin using it.
# quests can always be displayed on custom scoreboards using the PlaceholderAPI.
disable-scoreboard: false
# show the scoreboard per default for new players
show-scoreboard-per-default: true
# set the locale for the plugin.
# contact me if you would like to have your language supported. you might need to help with translations.
# available locales:
# en: English, de: German, es: Spanish, ru: Russian
locale: en
# whether new updates should be announced to admins and in the console.
# updating to the newest version is always recommended unless the new version is not compatible with your server.
check-for-updates: true
# save interval for player data in minutes
# the saving process can cause lag on large servers. Increase this parameter to make savings less frequent.
# recommended values: min = 10
save-interval: 10
# edit the following list to prevent quest progress in worlds with the given names.
# watch out to not mess up the list's format.
banned-worlds:
- world_creative
- world_without_quest_progress
# an alternative character the plugin should use to display stars earned by quests
# replaces the default character. should be a valid unicode character.
# uncomment the following line to enable alternative character.
# star-character: "*"
# QUEST GENERATION
# factor for the value of rewards
# recommended values: min = 0.5, max = 3.0
reward-factor: 1.0
# factor for the quantities in a quest - e.g., the numbers of zombies to kill
# recommended values: min = 0.5, max = 3.0
quantity-factor: 1.0
# Increase the quantities in quests according to a players play time.
increase-quantity-by-playtime: true
# factor when a player joins the game
start-factor: 0.4
# factor when a player reaches <max-amount-hours> hours of playtime
max-factor: 3.0
# hours of play time at which a player receives quests with max quantities
max-amount-hours: 100
# chance of duplicate quests [0.0 - 1.0]
# 0.0: no duplicate quests will appear (not recommended when quest-amount is above 4)
# 1.0: players active quests have no influence on the generation of new quests
duplicate-quest-chance: 0.3
# REWARDS
# choose what type of reward you would like to be generated for quests
# if multiple types are set to true new quests will have a reward type chosen randomly
# enable items as rewards
item-rewards: true
# enable xp as a reward
xp-rewards: false
# enable money as a reward (requires an economy plugin to be hooked up via Vault)
money-rewards: false
# ECONOMY
# factor for money rewards
# adjusts this to the value of money on your server.
money-factor: 1.0
Permissions
Show permissions
basicquests.use.list:
default: true
description: Lets players view their quests
basicquests.use.scoreboard:
default: true
description: Lets players use the scoreboard to display quests
basicquests.use.reward:
default: true
description: Lets players receive their rewards
basicquests.use.skip:
default: true
description: Lets players skip a limited number of quests per day. Number can be configured in config.yml
basicquests.use.leaderboard:
default: true
description: Lets players view the leaderboard
basicquests.admin.list:
default: op
description: Lets players list quests of others
basicquests.admin.skip.unlimited:
default: op
description: Lets players skip unlimited quests
basicquests.admin.skip.others:
default: op
description: Lets players skip quests for other players
basicquests.admin.reset:
default: op
description: Lets players reset quests
basicquests.admin.reset.others:
default: op
description: Lets players reset quests for others
basicquests.admin.reset.global:
default: op
description: Lets players reset quests for all players at once
basicquests.admin.complete:
default: op
description: Lets players complete quests via command
basicquests.admin.complete.others:
default: op
description: Lets players complete quests for others true
basicquests.admin.update:
default: op
description: Lets players or the console to check for BasicQuests updates
basicquests.admin.reload:
default: op
description: Lets players use the reload command
License
Copyright (C) 2020-2024, Anton Stamme
BasicQuests is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
BasicQuests is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with BasicQuests. If not, see .
评论 0
登录后参与评分
还没有评论,来抢沙发吧