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.
