GBattlePass

is a configurable seasonal battle pass system for Minecraft servers with Cobblemon integration. It introduces a seasonal progression system that gives players meaningful goals and rewards. It's perfect for servers looking to add long-term engagement, seasonal events, or a competitive progression system without relying on external plugins.

---

Features

*Seasonal Progression* * Time-Limited Seasons - Configurable start and end dates with automatic season rotation and reset. * Real-Time Sync - Players progress through levels by earning XP, which syncs across all players in real-time. * Player Notifications - Color-coded login alerts (Green = plenty of time, Red = urgent) showing the exact time remaining in a human-readable format so you never miss important deadlines.

*Flexible Reward System* * Item Rewards - Grant players items with custom quantities. * Command Rewards - Execute commands when rewards are claimed (perfect for custom effects, permissions, etc.). * Pokémon Rewards - Grant specific Pokémon with configurable levels and shiny rates (Cobblemon integration). * Multiple Rewards - Each level can unlock several different rewards at the same time.

*Smart User Interface* * Modern UI - Intuitive interface built with owo-lib, featuring visual status indicators (locked, unlocked, claimable, claimed) and a real-time progress bar. * Claim All Button - Batch claim all available rewards at once instead of clicking each individually. * Easy Access - Auto-scrolls to your current level. Press `[` to open (keybind configurable).

*XP Integration with Cobblemon* * Activity XP - Earn fully configurable amounts of XP from catching wild Pokémon, defeating Pokémon in battle, evolving your Pokémon, or defeating NPC trainers. * Custom Events - Custom XP events available via API.

*Admin Tools & Configuration* * In-Game Admin Panel - Custom GUI (keybind unbound by default) and commands to manage player progress, XP, and reload configs.

* JSON Config - Everything from season dates, custom levels, XP requirements, progression curves, and reward details can be customized in `config/gbattlepass/battlepass.json`.

*Made For* * Server Owners - Add seasonal gameplay goals, encourage player engagement, and create reward systems without plugins. * Pokémon Servers - Distribute Pokémon rewards, tie progression to Cobblemon events, and track seasonal goals. * Multiplayer - Works seamlessly in multiplayer servers.

Dependencies: * Cobblemon (required, for Pokémon integration and XP events) * owo-lib (required, for the modern UI) * Fabric API (required)

Server-Side & Client-Side - Requires installation on both the server and client to sync the UI, rewards, and progression seamlessly.