rBattlePass

--- ## ✦ 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 1. Drop `rBattlePass-1.0.0.jar` into your `plugins/` folder 2. Restart the server (or use a plugin manager) 3. Edit `plugins/rBattlePass/config.yml` — set your timezone, economy provider and status prices 4. Edit the files in `lang/`, `menus/` and `rewards/` to your taste 5. 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 /