Gbattlepass-logo

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.

Player BattlePass View

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.

Admin Config Panel

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.

GBattlePass

oωo (owo-lib)