rBattlePass

插件

· 作者 rodya61

一个完全可配置、为赛季准备的 Battle Pass 插件,适用于 Bukkit · Spigot · Paper · Purpur。 所有的任务、奖励、菜单按钮、消息和价格都存在于一个配置文件中。

0 本站下载 0 关注 更新于 5 个月前

最新 1.0.1 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

✦ 特性

  • 战斗通行证进度 — 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 以完全禁用经济系统。战斗平衡点始终可用。


? 安装

  1. 将 rBattlePass-1.0.0.jar 放入你的 plugins/ 文件夹
  2. 重启服务器(或使用插件管理器)
  3. 编辑 plugins/rBattlePass/config.yml — 设置你的时区、经济提供商和状态价格
  4. 根据需要编辑 lang/、menus/ 和 rewards/ 中的文件
  5. 运行 /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 中编辑。

status


? 任务类型参考

类型 触发条件
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 填充桶

quests


? 等级奖励

每个等级(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"

levels

玩家只能领取当前状态及以下阶层的奖励。


? 商店配置

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"

shop

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源