G Battle Pass

A configurable seasonal battle pass system for Minecraft servers with Cobblemon integration.

What It Adds

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.

Core Features

Seasonal Progression

• Time-limited seasons with configurable start and end dates
• Players progress through levels by earning XP
• Automatic season rotation and reset
• Syncs across all players in real-time

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 per level - Each level can unlock several different rewards

Smart User Interface

• Modern, intuitive UI built with owo-lib
• Real-time progress bar showing XP toward next level
• Visual status indicators (locked, unlocked, claimable, claimed)
• Claim All Button - Batch claim all available rewards at once instead of clicking each individually
• Auto-scrolls to your current level
• Press [ to open (keybind configurable)

XP Integration with Cobblemon

• Earn XP from catching wild Pokémon
• Earn XP from defeating Pokémon in battle
• Earn XP when your Pokémon evolve
• Earn XP from defeating NPC trainers
• Fully configurable XP amounts per activity
• Custom XP events via API

Player Notifications

• Color-coded login alerts showing remaining season time
• Green (plenty of time) → Red (urgent)
• Shows exact time remaining in human-readable format
• Never miss important deadlines

Why Use This Mod?

✅ For Server Owners: Add seasonal gameplay goals, encourage player engagement, and create reward systems without plugins

✅ For Pokémon Servers: Distribute Pokémon rewards, tie progression to Cobblemon events, track seasonal goals

✅ Fully Configurable: Everything from XP amounts to reward items can be customized in JSON files, or using the admin UI panel inside the game

✅ Admin Tools: Commands and custom GUI (you need to setup the keybind by default is unbound) to manage player progress, xp, reload configs, and more

✅ Multiplayer Ready: Works seamlessly in multiplayer servers

Configuration

All settings are in config/gbattlepass/battlepass.json:

• Define season dates and properties
• Create custom levels with specific rewards
• Set XP requirements and progression curves
• Configure item quantities, commands, and Pokémon details