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

Java 17+ required.
No NMS, no reflection on server internals — pure Bukkit API throughout.

---

📦 Dependencies

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

Aliases: /battlepass, /rbp

---

🔑 Permissions

---

🌐 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

All values, names, prices and quest counts are editable in config.yml.

---

📜 Quest types reference

---

🏆 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"