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.