BattlePass
一款适用于 Paper 服务器的赛季通行证插件,支持从 1.21.x 一直到 26.2 的版本。
功能特性
进度与奖励
- 默认每个赛季包含 50 个层级(可配置),设有面向所有人的免费轨道和面向通行证持有者的高级轨道
- 奖励可以是物品、控制台命令或通过 Vault 获得的货币
- Oraxen 和 ItemsAdder 的自定义物品开箱即用。附魔、描述文本、属性和 NBT 数据均会完整保留。
- 赛季按既定计划自动轮换,你可以自定义每个赛季的持续时间
任务
玩家通过执行服务器上已有的行为来赚取经验值:挖掘和放置方块、击杀生物和玩家、合成、钓鱼、附魔、动物繁殖以及与村民交易。此外,你还可以设置任务为可重复完成,或编写完全自定义的任务。
管理工具
- 游戏内层级编辑器。手持物品即可直接将其添加到某个层级,包括自定义物品。
- 通过命令设置玩家的 XP 或层级,并授予或移除高级权限
/bpadmin stats 一目了然地显示缓存和保存状态的健康情况
- 无需重启服务器即可重载配置文件
安装方法
- 将
.jar 文件放入 plugins 文件夹
- 启动(或重启)服务器
- 根据需要调整
config.yml、quests.yml 和 rewards.yml
- 运行
/bpadmin reload,即可开始使用
命令
玩家命令
| 命令 |
功能 |
/bp 或 /battlepass |
打开 BattlePass 菜单 |
/bp quests |
显示你的当前任务 |
/bp info |
显示你的进度和统计数据 |
管理员命令
| 命令 |
功能 |
/bpadmin reload |
重载所有配置文件 |
/bpadmin setexp <player> <amount> |
设置玩家的 XP |
/bpadmin settier <player> <tier> |
设置玩家的层级 |
/bpadmin givepremium <player> |
授予高级权限 |
/bpadmin removepremium <player> |
移除高级权限 |
/bpadmin editor [tier] |
打开层级编辑器 |
/bpadmin stats |
显示缓存和性能统计信息 |
/bpadmin forcesave |
立即保存所有待处理的数据 |
权限
| 权限节点 |
描述 |
默认值 |
battlepass.use |
使用 BattlePass |
所有人 |
battlepass.admin |
管理员命令 |
op |
battlepass.premium |
访问高级奖励 |
无人 |
配置
所有内容被拆分到三个文件中,以便于查找:
config.yml:赛季设置、每层级所需 XP、消息提示
quests.yml:任务、其要求及 XP 奖励
rewards.yml:每个层级提供的奖励
示例赛季设置
season:
name: "Season 1 - Autumn 2026"
max-tier: 50
exp-per-tier: 1000
兼容性
- 服务端: Paper 1.21.x – 26.2(Purpur 等 Paper 分支也应兼容)
- Java: 1.21.x 需要 Java 21+,26.x 需要 Java 25
- 可选依赖: Oraxen, ItemsAdder, Vault
Bug 报告
请在 Discord 上提交工单,并包含以下信息:
- 你的服务端软件及版本(例如 Paper 26.2)
- 你正在使用的 BattlePass 版本
- 你做了什么操作以及发生了什么问题
- 控制台的任何错误日志
提供的细节越多,修复速度越快。
由 ResistanceCore 制作。如果 BattlePass 对你的服务器有用,关注或在其他服务器所有者之间分享将大有帮助。谢谢!
BattlePass
A season pass plugin for Paper servers, from 1.21.x all the way up to 26.2.
Features
Progression and rewards
- 50 tiers per season by default (configurable), with a free track for everyone and a premium track for pass holders
- Rewards can be items, console commands, or money through Vault
- Custom items from Oraxen and ItemsAdder work out of the box. Enchants, lore, attributes and NBT are kept intact.
- Seasons rotate on their own schedule, and you pick how long each one lasts
Quests
Players earn XP by doing things they already do on your server: mining and placing blocks, killing mobs and players, crafting, fishing, enchanting, breeding animals and trading with villagers. On top of that you can make quests repeatable, or write fully custom ones.
Admin tools
- An in-game tier editor. Hold an item and add it straight to a tier, custom items included.
- Set a player's XP or tier, and grant or remove premium, all from commands
/bpadmin stats shows cache and save health at a glance
- Reload configs without restarting the server
Installation
- Drop the
.jar into your plugins folder
- Start (or restart) the server
- Tweak
config.yml, quests.yml and rewards.yml to your liking
- Run
/bpadmin reload and you're good to go
Commands
Player commands
| Command |
What it does |
/bp or /battlepass |
Opens the BattlePass menu |
/bp quests |
Shows your active quests |
/bp info |
Shows your progress and stats |
Admin commands
| Command |
What it does |
/bpadmin reload |
Reloads all config files |
/bpadmin setexp <player> <amount> |
Sets a player's XP |
/bpadmin settier <player> <tier> |
Sets a player's tier |
/bpadmin givepremium <player> |
Gives premium access |
/bpadmin removepremium <player> |
Removes premium access |
/bpadmin editor [tier] |
Opens the tier editor |
/bpadmin stats |
Shows cache and performance stats |
/bpadmin forcesave |
Saves all pending data right now |
Permissions
| Permission |
Description |
Default |
battlepass.use |
Use the BattlePass |
everyone |
battlepass.admin |
Admin commands |
op |
battlepass.premium |
Access to premium rewards |
nobody |
Configuration
Everything is split across three files so it stays easy to find:
config.yml: season settings, XP per tier, messages
quests.yml: quests, their requirements and XP rewards
rewards.yml: what each tier gives out
Example season setup
season:
name: "Season 1 - Autumn 2026"
max-tier: 50
exp-per-tier: 1000
Compatibility
- Server: Paper 1.21.x – 26.2 (Paper forks like Purpur should work too)
- Java: 21+ for 1.21.x, Java 25 for 26.x
- Optional: Oraxen, ItemsAdder, Vault
Bug reports
Please make a ticket on discord and include:
- Your server software and version (e.g. Paper 26.2)
- The BattlePass version you're on
- What you did and what happened
- Any errors from the console
The more detail you give me, the faster I can fix it.
Made by ResistanceCore. If BattlePass is useful on your server, a follow or a share with other server owners helps a lot. Thanks!
评论 0
登录后参与评分
还没有评论,来抢沙发吧