KartaBattlePass
KartaBattlePass 是一款灵活且功能丰富的 Battle Pass 插件,适用于基于 Spigot 的 Minecraft 服务器。它允许服务器管理员创建季节性或持续性的 Battle Pass,支持自定义等级、经验来源以及强大的奖励系统。
特性
- 升级系统: 玩家获得 XP 并提升 Battle Pass 等级。
- 顺序任务系统: 玩家按顺序完成分类任务。这提供了一个结构化的进度系统。
- 灵活的奖励系统:
- 在专用的
rewards.yml 中为每个等级定义复杂的奖励。
- 多种奖励类型:物品、命令、金钱(通过 Vault)和权限(通过 Vault)。
- 支持独立的
free(免费)和 premium(高级)奖励轨道。
- 交互式 GUI:
/bp 打开主菜单以导航到其他 GUI。
/bp rewards:一个用户友好的 GUI,供玩家查看和领取已获得的奖励。
/bp quests:一个 GUI,用于查看任务类别及其中的任务,并显示当前进度。
/bp top:排行榜,查看谁拥有最高等级。
- 自动发放或手动领取: 选择是在升级时自动发放奖励,还是由玩家手动领取。
- PlaceholderAPI 支持: 集成占位符以显示 Battle Pass 信息。
- 管理命令: 强大的命令用于管理玩家进度和重新加载插件。
- 离线玩家支持: 玩家数据保存和加载可靠。
依赖项
配置
等级进度
你可以使用 battlepass.exp-per-level-base 设置来控制升级所需的经验量。使用的公式为 EXP Required = current_level * exp-per-level-base。
例如,如果 exp-per-level-base 为 100:
- 从 Level 1 到 Level 2,你需要
1 * 100 = 100 EXP。
- 从 Level 10 到 Level 11,你需要
10 * 100 = 1000 EXP。
quests.yml
# Define your categories here.
# The 'quests' list under each category defines the sequence.
quest-categories:
mining:
display-name: "&b⛏ Mining Quests"
display-item: "DIAMOND_PICKAXE"
quests:
- "mine_stone"
- "mine_coal"
- "mine_diamonds"
combat:
display-name: "&c⚔ Combat Quests"
display-item: "DIAMOND_SWORD"
quests:
- "kill_zombies"
- "kill_skeletons"
# Define the individual quests here.
# The IDs must match the ones used in the categories above.
quests:
mine_stone:
type: "block-break"
target: "STONE"
amount: 64
exp: 50
display-name: "&7Mine 64 Stone"
rewards:
- "eco give %player% 100"
kill_zombies:
type: "kill-mob"
target: "ZOMBIE"
amount: 10
exp: 25
display-name: "&2Kill 10 Zombies"
rewards:
- "minecraft:give %player% minecraft:iron_sword 1"
# ... and so on for all other quests
命令
/battlepass, /bp - 主命令别名。
/bp rewards - 打开奖励领取 GUI。
/bp quests - 打开任务类别 GUI。
/bp top - 打开排行榜 GUI。
/bp progress [player] - 检查你或另一名玩家的进度。
/bp help - 显示帮助消息。
管理命令
/bp reload - 重新加载插件配置。
/bp setxp <player> <amount> - 设置玩家的 XP。
/bp addxp <player> <amount> - 给玩家增加 XP。
/bp setlevel <player> <level> - 设置玩家的等级。
权限
kbattlepass.admin - 授予所有管理命令的访问权限。
kbattlepass.open - 允许打开 Battle Pass GUI。
kbattlepass.claim - 允许领取奖励。
kbattlepass.progress.others - 允许查看其他玩家的进度。
kartabattlepass.premium - 授予高级奖励轨道的访问权限。
占位符
%kartabattlepass_level% - 玩家当前的 Battle Pass 等级。
%kartabattlepass_exp% - 玩家当前的 XP。
%kartabattlepass_exp_required% - 下一级所需的 XP。
%kartabattlepass_unclaimed_rewards% - 玩家尚未领取的奖励数量。
%kartabattlepass_next_reward_level% - 下一个有奖励的等级。
KartaBattlePass
KartaBattlePass is a flexible and feature-rich Battle Pass plugin for Spigot-based Minecraft servers. It allows server owners to create seasonal or ongoing Battle Passes with customizable levels, experience sources, and a powerful reward system.
Features
- Leveling System: Players earn XP and level up their Battle Pass.
- Sequential Quest System: Players complete quests in ordered categories. This provides a structured progression system.
- Flexible Reward System:
- Define complex rewards for each level in a dedicated
rewards.yml.
- Multiple reward types: Items, Commands, Money (via Vault), and Permissions (via Vault).
- Support for separate
free and premium reward tracks.
- Interactive GUIs:
/bp opens a main menu to navigate to other GUIs.
/bp rewards: A user-friendly GUI for players to view and claim their earned rewards.
/bp quests: A GUI to view quest categories and the quests within them, showing current progress.
/bp top: A leaderboard to see who is the highest level.
- Auto-Grant or Manual Claim: Choose whether rewards are granted automatically on level-up or if players must claim them manually.
- PlaceholderAPI Support: Integrated placeholders to display Battle Pass information.
- Admin Commands: Powerful commands for managing player progress and reloading the plugin.
- Offline Player Support: Player data is saved and loaded reliably.
Dependencies
Configuration
Level Progression
You can control how much experience is required to level up using the battlepass.exp-per-level-base setting. The formula used is EXP Required = current_level * exp-per-level-base.
For example, if exp-per-level-base is 100:
- To get from Level 1 to Level 2, you need
1 * 100 = 100 EXP.
- To get from Level 10 to Level 11, you need
10 * 100 = 1000 EXP.
quests.yml
# Define your categories here.
# The 'quests' list under each category defines the sequence.
quest-categories:
mining:
display-name: "&b⛏ Mining Quests"
display-item: "DIAMOND_PICKAXE"
quests:
- "mine_stone"
- "mine_coal"
- "mine_diamonds"
combat:
display-name: "&c⚔ Combat Quests"
display-item: "DIAMOND_SWORD"
quests:
- "kill_zombies"
- "kill_skeletons"
# Define the individual quests here.
# The IDs must match the ones used in the categories above.
quests:
mine_stone:
type: "block-break"
target: "STONE"
amount: 64
exp: 50
display-name: "&7Mine 64 Stone"
rewards:
- "eco give %player% 100"
kill_zombies:
type: "kill-mob"
target: "ZOMBIE"
amount: 10
exp: 25
display-name: "&2Kill 10 Zombies"
rewards:
- "minecraft:give %player% minecraft:iron_sword 1"
# ... and so on for all other quests
Commands
/battlepass, /bp - Main command alias.
/bp rewards - Opens the reward claiming GUI.
/bp quests - Opens the quest category GUI.
/bp top - Opens the leaderboard GUI.
/bp progress [player] - Checks your or another player's progress.
/bp help - Shows the help message.
Admin Commands
/bp reload - Reloads the plugin configuration.
/bp setxp <player> <amount> - Sets a player's XP.
/bp addxp <player> <amount> - Adds XP to a player.
/bp setlevel <player> <level> - Sets a player's level.
Permissions
kbattlepass.admin - Grants access to all admin commands.
kbattlepass.open - Allows opening the Battle Pass GUI.
kbattlepass.claim - Allows claiming rewards.
kbattlepass.progress.others - Allows viewing other players' progress.
kartabattlepass.premium - Grants access to the premium reward track.
Placeholders
%kartabattlepass_level% - The player's current Battle Pass level.
%kartabattlepass_exp% - The player's current XP.
%kartabattlepass_exp_required% - The XP required for the next level.
%kartabattlepass_unclaimed_rewards% - The number of rewards the player has not yet claimed.
%kartabattlepass_next_reward_level% - The next level that has a reward.
评论 0
登录后参与评分
还没有评论,来抢沙发吧