GBattlePass

!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.