Description

CobbleLemon Gym League

CobbleLemon Gym League adds a full server-side gym league system for Cobblemon servers, with player challenges, badge tracking, seasons, leaderboards, Elite Four progression, Champion battles, and an in-game management GUI.

Players can open the Gym League menu with /gym or /gymgui to view active league staff, challenge Gym Leaders, track earned badges, check leaderboard standings, and follow their progress through the league. Gym Leaders, Elite Four members, and Champions can accept challenges, manage active matches, and use configured arena positions for clean battle starts.

Features

Gym Leader, Elite Four, Champion, and Challenger roles
Seasonal badge progression
Configurable badge definitions and required badge counts
/gym challenge <player> and /gym accept <player> challenge flow
Automatic Cobblemon PvP battle setup using Gen 9 singles
Configurable battle level, request timeout, result broadcasts, and challenge rules
Leaderboard based on badges, Elite Four progress, and Champion status
Admin GUI for roles, seasons, badges, arena setup, and config reloads
Arena teleport positions for challengers and league staff
Optional Exposure photograph previews for Gym Leaders
Optional CobbleLemon Trainer Hub integration for badge cosmetics, titles, and trainer card stats
Optional LuckPerms integration for syncing league groups

Why Use It?

This mod is built for Cobblemon servers that want a structured player-run league without tracking everything manually. It gives staff tools to run seasons, assign leaders, award badges, and manage progression while giving players a clear path from Gym battles to the Elite Four and Champion.

Commands

/gym - Open the Gym League GUI
/gymgui - Open the Gym League GUI
/gym challenge <player> - Challenge a Gym Leader, Elite Four member, or Champion
/gym accept <player> - Accept an incoming challenge
/gym badges - View your badge and Elite Four progress
/gym admin ... - Admin role, season, badge, and reload tools

Important Setup Notes

This mod is intended for Fabric Minecraft 1.21.1 with Cobblemon. Install it on the server and on clients that should use the GUI.

Required:

Fabric Loader
Fabric API
Cobblemon
Fabric Permissions API

Recommended:

LuckPerms, for role/group syncing
Exposure, for gym preview photographs
CobbleLemon Trainer Hub, for trainer card integration

Before running a public league, configure config/cobblelemon_gym_league/settings.json. Change the default admin password, set admin allow-list entries as needed, configure arena positions, and define your seasons and badges.