✦ 特性
- 战斗通行证进度 — 50 个可配置等级,每个等级包含多达 3 个奖励档位(侦察兵 / 老兵 / 军阀)
- 每日与每周任务系统 — 默认池中有 17 个每日任务和 14 个每周任务;每位玩家根据其状态档位获得随机子集。可在
rewards/quests.yml 中进行完全编辑
- 18 种任务类型 — 破坏方块、放置方块、击杀实体、钓鱼、消耗物品、销毁物品、合成物品、射箭、跳跃、附魔物品、酿造药水、村民交易、驯服动物、投掷鸡蛋、繁殖动物、鞘翅飞行、挤牛奶、装满桶
- 3 种战斗状态档位 — 侦察兵(免费)、老兵、军阀。每个档位解锁更多每日/每周任务以及更多等级。价格和任务数量均可配置
- 战斗平衡点 (✦) — 从等级奖励中获得的内部货币,在商店中使用
- 游戏内商店 — 可配置的物品和槽位,使用战斗平衡点购买。购买时执行控制台命令
- 完全支持翻译 — 所有面向玩家的字符串(聊天消息、GUI 标题、按钮名称、描述文本、命令输出)均位于
lang/en.yml 中。通过复制该文件即可添加任何语言
- 热重载 —
/bp reload 即时重新加载所有 6 个配置文件,包括菜单布局、任务池、奖励和语言
- 权限控制的命令 — 每个管理员子命令都有独立的权限节点
- 灵活的经济系统 — 支持 Vault(默认,兼容 EssentialsX / CMI / 任何经济插件)、CoinsEngine 或完全不使用经济系统
? 兼容性
| 平台 |
版本 |
| Bukkit |
1.20 – 26.1.2 |
| Spigot |
1.20 – 26.1.2 |
| Paper |
1.20 – 26.1.2 |
| Purpur |
1.20 – 26.1.2 |
需要 Java 17+。
不依赖 NMS,不对服务器内部进行反射调用 — 全程纯 Bukkit API。
? 依赖项
| 依赖项 |
类型 |
用途 |
| Vault |
软依赖(可选) |
经济提供商(默认)。需要兼容的经济插件(EssentialsX, CMI 等) |
| CoinsEngine |
软依赖(可选) |
替代经济提供商 |
插件可在没有上述任一依赖的情况下运行 — 在 config.yml 中设置 economy.provider: none 以完全禁用经济系统。战斗平衡点始终可用。
? 安装
- 将
rBattlePass-1.0.0.jar 放入你的 plugins/ 文件夹
- 重启服务器(或使用插件管理器)
- 编辑
plugins/rBattlePass/config.yml — 设置你的时区、经济提供商和状态价格
- 根据需要编辑
lang/、menus/ 和 rewards/ 中的文件
- 运行
/bp reload 应用更改而无需重启
⚙ 配置结构
plugins/rBattlePass/
├── config.yml — 核心设置:时区、经济、状态档位
├── lang/
│ └── en.yml — 所有消息、GUI 标题、命令输出
├── menus/
│ ├── main.yml — 按钮槽位、材质、描述文本、导航
│ └── shop.yml — 商店物品、槽位、价格、命令
└── rewards/
├── levels.yml — 每个状态档位的每级奖励
└── quests.yml — 每日和每周任务池
每个文件在首次启动时生成。删除文件即可从默认值重新生成。
? 命令
| 命令 |
权限 |
描述 |
/bp |
rbattlepass.use |
打开战斗通行证菜单 |
/bp shop |
rbattlepass.shop |
打开商店 |
/bp help |
rbattlepass.admin.help |
列出所有管理员命令 |
/bp lvl give <player> <amount> |
rbattlepass.admin.lvl.give |
给予玩家等级 |
/bp lvl set <player> <level> |
rbattlepass.admin.lvl.set |
设置玩家等级 |
/bp lvl reset <player> |
rbattlepass.admin.lvl.reset |
重置玩家等级及已领取的奖励 |
/bp exp give <player> <amount> |
rbattlepass.admin.exp.give |
给予玩家经验值 |
/bp exp set <player> <amount> |
rbattlepass.admin.exp.give |
设置玩家经验值 |
/bp quest reset <player|all|*> |
rbattlepass.admin.quest.reset |
重置任务(单个玩家或所有人) |
/bp status get <player> |
rbattlepass.admin.status.get |
查看玩家状态 |
/bp status set <player> <key> |
rbattlepass.admin.status.set |
强制设置玩家状态 |
/bp balance give <player> <amount> |
rbattlepass.admin.balance.give |
给予战斗平衡点 |
/bp balance set <player> <amount> |
rbattlepass.admin.balance.give |
设置战斗平衡点 |
/bp info <player> |
rbattlepass.admin.info |
查看玩家完整信息 |
/bp shop <player> |
rbattlepass.admin.shop.open |
为其他玩家打开商店 |
/bp reload |
rbattlepass.admin.reload |
重新加载所有配置文件 |
别名:/battlepass, /rbp
? 权限
| 权限 |
默认 |
描述 |
rbattlepass.use |
everyone |
打开战斗通行证菜单 |
rbattlepass.shop |
everyone |
打开商店 |
rbattlepass.admin |
OP |
所有管理员权限(父级) |
rbattlepass.admin.lvl.give |
OP |
给予等级 |
rbattlepass.admin.lvl.set |
OP |
设置等级 |
rbattlepass.admin.lvl.reset |
OP |
重置等级 |
rbattlepass.admin.exp.give |
OP |
给予/设置经验值 |
rbattlepass.admin.quest.reset |
OP |
重置任务 |
rbattlepass.admin.status.get |
OP |
查看玩家状态 |
rbattlepass.admin.status.set |
OP |
设置玩家状态 |
rbattlepass.admin.info |
OP |
查看玩家信息 |
rbattlepass.admin.shop.open |
OP |
为他人打开商店 |
rbattlepass.admin.balance.give |
OP |
给予/设置战斗平衡点 |
rbattlepass.admin.reload |
OP |
重新加载配置 |
rbattlepass.admin.help |
OP |
查看帮助 |
? 本地化
将 lang/en.yml 复制到 lang/ru.yml(或任何语言代码),翻译所有字符串,然后在 config.yml 中设置 language: "ru" 并运行 /bp reload。无需重启。
所有字符串均支持 & 颜色代码和 §x§R§R§G§G§B§B 十六进制颜色代码。
⚔ 默认战斗状态档位
| 状态 |
每日任务 |
每周任务 |
最高等级 |
价格 |
| Scout |
3 |
3 |
30 |
免费 |
| Veteran |
5 |
4 |
40 |
139,500 |
| Warlord |
7 |
5 |
50 |
239,500 |
所有数值、名称、价格和任务数量均可在 config.yml 中编辑。

? 任务类型参考
| 类型 |
触发条件 |
BLOCK_BREAK |
破坏指定方块 |
BLOCK_PLACE |
放置指定方块 |
ENTITY_KILL |
击杀指定实体 |
FISH_CATCH |
钓鱼 |
ITEM_CONSUME |
食用指定食物 |
ITEM_BREAK |
破坏工具/武器 |
ITEM_CRAFT |
合成指定物品 |
ARROW_SHOOT |
射击箭矢 |
JUMP |
跳跃 |
ITEM_ENCHANT |
附魔物品 |
BREW_POTION |
酿造药水 |
VILLAGER_TRADE |
与村民交易 |
ANIMAL_TAME |
驯服动物 |
EGG_THROW |
投掷鸡蛋 |
BREED_ANIMAL |
繁殖动物 |
ELYTRA_FLY |
开始鞘翅飞行 |
MILK_COW |
挤牛奶 |
FILL_BUCKET |
填充桶 |

? 等级奖励
每个等级(1–50)可为每种状态阶层设置奖励。奖励字段说明:
10:
scout:
battle-balance: 200 # 授予战斗平衡值 (✦)
economy-reward: 0 # 授予外部经济货币
commands: # 控制台命令(使用 %player% 作为玩家占位符)
- "give %player% diamond 5"
veteran:
battle-balance: 400
economy-reward: 0
commands:
- "give %player% diamond 10"
warlord:
battle-balance: 800
economy-reward: 0
commands:
- "give %player% netherite_ingot 2"

玩家只能领取当前状态及以下阶层的奖励。
? 商店配置
menus/shop.yml 中的物品配置:
items:
- slot: 22 # 背包槽位(从 0 开始索引,总大小 = 45)
material: ELYTRA
name: "&x&F&F&D&6&6&D&lElytra"
price: 2000 # 战斗平衡值 ✦ 的消耗
lore:
- "&7一对完美的翅膀。"
- "&x&F&F&F&2&B&0价格: &f2,000 ✦"
commands:
- "give %player% elytra 1"

✦ Features
- Battle Pass progression — 50 configurable levels, each with up to 3 reward tiers (Scout / Veteran / Warlord)
- Daily & weekly quest system — 17 daily and 14 weekly quests in the default pool; each player gets a random subset based on their status tier. Fully editable in
rewards/quests.yml
- 18 quest types — Block Break, Block Place, Entity Kill, Fish Catch, Item Consume, Item Break, Item Craft, Arrow Shoot, Jump, Item Enchant, Brew Potion, Villager Trade, Animal Tame, Egg Throw, Breed Animal, Elytra Fly, Milk Cow, Fill Bucket
- 3 Battle Status tiers — Scout (free), Veteran, Warlord. Each tier unlocks more quests per day/week and more levels. Prices and quest counts are configurable
- Battle Balance (✦) — internal currency awarded from level rewards, spent in the shop
- In-game shop — configurable items at configurable slots, purchased with Battle Balance. Runs console commands on purchase
- Fully translatable — every player-facing string (chat messages, GUI titles, button names, lore, command output) is in
lang/en.yml. Add any language by copying the file
- Hot-reload —
/bp reload reloads all 6 config files instantly, including menu layouts, quest pools, rewards and language
- Permission-gated commands — every admin subcommand has its own permission node
- Flexible economy — supports Vault (default, works with EssentialsX / CMI / any economy plugin), CoinsEngine, or no economy at all
? Compatibility
| Platform |
Versions |
| Bukkit |
1.20 – 26.1.2 |
| Spigot |
1.20 – 26.1.2 |
| Paper |
1.20 – 26.1.2 |
| Purpur |
1.20 – 26.1.2 |
Java 17+ required.
No NMS, no reflection on server internals — pure Bukkit API throughout.
? Dependencies
| Dependency |
Type |
Purpose |
| Vault |
Soft (optional) |
Economy provider (default). Needs a compatible economy plugin (EssentialsX, CMI, etc.) |
| CoinsEngine |
Soft (optional) |
Alternative economy provider |
The plugin runs without either — set economy.provider: none in config.yml to disable economy entirely. Battle Balance always works.
? Installation
- Drop
rBattlePass-1.0.0.jar into your plugins/ folder
- Restart the server (or use a plugin manager)
- Edit
plugins/rBattlePass/config.yml — set your timezone, economy provider and status prices
- Edit the files in
lang/, menus/ and rewards/ to your taste
- Run
/bp reload to apply changes without restarting
⚙ Configuration structure
plugins/rBattlePass/
├── config.yml — core settings: timezone, economy, status tiers
├── lang/
│ └── en.yml — all messages, GUI titles, command output
├── menus/
│ ├── main.yml — button slots, materials, lore, navigation
│ └── shop.yml — shop items, slots, prices, commands
└── rewards/
├── levels.yml — per-level rewards for each status tier
└── quests.yml — daily and weekly quest pool
Every file is generated on first start. Delete a file to regenerate it from defaults.
? Commands
| Command |
Permission |
Description |
/bp |
rbattlepass.use |
Open the Battle Pass menu |
/bp shop |
rbattlepass.shop |
Open the shop |
/bp help |
rbattlepass.admin.help |
List all admin commands |
/bp lvl give <player> <amount> |
rbattlepass.admin.lvl.give |
Give levels to a player |
/bp lvl set <player> <level> |
rbattlepass.admin.lvl.set |
Set a player's level |
/bp lvl reset <player> |
rbattlepass.admin.lvl.reset |
Reset a player's level and claimed rewards |
/bp exp give <player> <amount> |
rbattlepass.admin.exp.give |
Give EXP to a player |
/bp exp set <player> <amount> |
rbattlepass.admin.exp.give |
Set a player's EXP |
/bp quest reset <player|all|*> |
rbattlepass.admin.quest.reset |
Reset quests (one player or everyone) |
/bp status get <player> |
rbattlepass.admin.status.get |
View a player's status |
/bp status set <player> <key> |
rbattlepass.admin.status.set |
Force-set a player's status |
/bp balance give <player> <amount> |
rbattlepass.admin.balance.give |
Give Battle Balance |
/bp balance set <player> <amount> |
rbattlepass.admin.balance.give |
Set Battle Balance |
/bp info <player> |
rbattlepass.admin.info |
View full player info |
/bp shop <player> |
rbattlepass.admin.shop.open |
Open shop for another player |
/bp reload |
rbattlepass.admin.reload |
Reload all config files |
Aliases: /battlepass, /rbp
? Permissions
| Permission |
Default |
Description |
rbattlepass.use |
everyone |
Open the Battle Pass menu |
rbattlepass.shop |
everyone |
Open the shop |
rbattlepass.admin |
OP |
All admin permissions (parent) |
rbattlepass.admin.lvl.give |
OP |
Give levels |
rbattlepass.admin.lvl.set |
OP |
Set level |
rbattlepass.admin.lvl.reset |
OP |
Reset level |
rbattlepass.admin.exp.give |
OP |
Give / set EXP |
rbattlepass.admin.quest.reset |
OP |
Reset quests |
rbattlepass.admin.status.get |
OP |
View player status |
rbattlepass.admin.status.set |
OP |
Set player status |
rbattlepass.admin.info |
OP |
View player info |
rbattlepass.admin.shop.open |
OP |
Open shop for others |
rbattlepass.admin.balance.give |
OP |
Give / set Battle Balance |
rbattlepass.admin.reload |
OP |
Reload config |
rbattlepass.admin.help |
OP |
View help |
? Localization
Copy lang/en.yml to lang/ru.yml (or any language code), translate every string, then set language: "ru" in config.yml and run /bp reload. No restart needed.
All strings support & color codes and §x§R§R§G§G§B§B hex colors.
⚔ Default Battle Status tiers
| Status |
Daily quests |
Weekly quests |
Max level |
Price |
| Scout |
3 |
3 |
30 |
Free |
| Veteran |
5 |
4 |
40 |
139,500 |
| Warlord |
7 |
5 |
50 |
239,500 |
All values, names, prices and quest counts are editable in config.yml.

? Quest types reference
| Type |
Trigger |
BLOCK_BREAK |
Breaking specified blocks |
BLOCK_PLACE |
Placing specified blocks |
ENTITY_KILL |
Killing specified entities |
FISH_CATCH |
Catching fish |
ITEM_CONSUME |
Eating specified food |
ITEM_BREAK |
Breaking a tool/weapon |
ITEM_CRAFT |
Crafting specified items |
ARROW_SHOOT |
Shooting arrows |
JUMP |
Jumping |
ITEM_ENCHANT |
Enchanting items |
BREW_POTION |
Brewing potions |
VILLAGER_TRADE |
Trading with villagers |
ANIMAL_TAME |
Taming animals |
EGG_THROW |
Throwing eggs |
BREED_ANIMAL |
Breeding animals |
ELYTRA_FLY |
Starting elytra flight |
MILK_COW |
Milking cows |
FILL_BUCKET |
Filling buckets |

? Level rewards
Each level (1–50) can have a reward for each status tier. Reward fields:
10:
scout:
battle-balance: 200 # awarded Battle Balance (✦)
economy-reward: 0 # awarded external economy currency
commands: # console commands (use %player%)
- "give %player% diamond 5"
veteran:
battle-balance: 400
economy-reward: 0
commands:
- "give %player% diamond 10"
warlord:
battle-balance: 800
economy-reward: 0
commands:
- "give %player% netherite_ingot 2"

Players can only claim tiers at or below their current status.
? Shop configuration
Items in menus/shop.yml:
items:
- slot: 22 # inventory slot (0-indexed, size = 45)
material: ELYTRA
name: "&x&F&F&D&6&6&D&lElytra"
price: 2000 # cost in Battle Balance ✦
lore:
- "&7A pristine pair of wings."
- "&x&F&F&F&2&B&0Cost: &f2,000 ✦"
commands:
- "give %player% elytra 1"

评论 0
登录后参与评分
还没有评论,来抢沙发吧