# CobblePass – The Ultimate Battle Pass for Cobblemon<\/p>\n
Welcome to the completely revamped CobblePass! This mod provides a deeply integrated and highly customizable battle pass system for your Cobblemon server. Engage your players with a rewarding progression system, complete with free and premium tracks, seasonal content, and a wide array of configurable rewards.<\/p>\n
<\/p>\n
## Features<\/p>\n
– **Seasons:** Create unique battle pass seasons with configurable durations and rewards.
\n– **Dual Reward Tracks:** Implement both `free` and `premium` reward tiers.
\n– **Dynamic GUI:** A clean, intuitive, and paginated GUI (`\/bp`) for players to view progress and claim rewards.
\n– **XP Progression:**
\n – Gain XP from various in-game actions: catching, defeating, evolving, hatching, and trading Pok\u00e9mon.
\n – Two XP progression models:
\n – **`FORMULA`:** XP required per level increases based on a configurable multiplier.
\n – **`MANUAL`:** Manually define the exact XP required for each level.
\n– **Diverse Reward Types:**
\n – **`ITEM`:** Grant any item from Minecraft or other mods, with full NBT support.
\n – **`POKEMON`:** Reward players with specific Pok\u00e9mon, including level, shininess, and other attributes.
\n – **`COMMAND`:** Execute any server command as a reward, with placeholders for player name and UUID.
\n– **Admin Management:**
\n – A full suite of commands for managing seasons, players, and configurations.
\n – Create, start, stop, and delete seasons.
\n – Modify player XP, levels, and premium status on the fly.
\n – Reload configurations without a server restart.
\n– **Economy Integration:** Charge for the premium pass using any Impactor-compatible economy plugin.
\n– **Highly Configurable:** Tweak everything from XP values to reward templates and season settings through intuitive JSON files.
\n– **Data Integrity:** Player data is saved reliably and includes safeguards against corruption.<\/p>\n
## Dependencies<\/p>\n
CobblePass requires the following mods to be installed on your server:<\/p>\n
– **Fabric API**
\n– **Cobblemon** (v1.6+)
\n– **Impactor** (For economy features)
\n– **GooeyLibs**<\/p>\n
## Installation<\/p>\n
1. Ensure you have a Fabric server running Minecraft 1.21.1 or later.
\n2. Download the latest versions of CobblePass and all required dependencies.
\n3. Place the `.jar` files into your server’s `mods` folder.
\n4. Start your server. CobblePass will generate its default configuration files in the `config\/cobblepass\/` directory.<\/p>\n
—<\/p>\n
## Getting Started: Your First Season<\/p>\n
Setting up a new Battle Pass is easy with the in-game creation tool.<\/p>\n
**Step 1: Create the Battle Pass**
\n– As an operator, run the command: `\/battlepass create`
\n– This will open a GUI where you can set:
\n – **Duration:** The length of the season in days.
\n – **Max Level:** The highest level players can achieve.
\n – **Premium Toggle:** Whether this season will have a premium track.
\n– Click “Create Battle Pass”. This generates `config.json` and `tiers.json` files and resets all player progress for a fresh start.<\/p>\n
**Step 2: Configure Your Rewards**
\n– Open `config\/cobblepass\/tiers.json`.
\n– By default, it’s filled with placeholder rewards (Apples). Customize each level’s `freeReward` and `premiumReward`. See the detailed **[tiers.json Configuration](#tiersjson)** section below for examples of Item, Pok\u00e9mon, and Command rewards.
\n– This is where you can also define reusable reward `templates`!<\/p>\n
**Step 3: Configure Settings**
\n– Open `config\/cobblepass\/config.json`.
\n– Adjust XP gain values (`catchXP`, `defeatXP`, etc.), the cost of the premium pass (`premiumCost`), and the XP progression model (`xpProgression`). See the **[config.json Configuration](#configjson)** section for more details.<\/p>\n
**Step 4: Reload the Configuration**
\n– Once you’ve saved your changes to the JSON files, run the command: `\/battlepass reload`
\n– This will load all your new settings and rewards into the server without needing a restart.<\/p>\n
**Step 5: Start the Season!**
\n– When you’re ready for the season to begin, run: `\/battlepass season start`
\n– The timer will start, and players can now begin earning XP!<\/p>\n
—<\/p>\n
## Commands<\/p>\n
The base command is `\/battlepass` with aliases `\/bp` and `\/pass`.<\/p>\n
### Player Commands<\/p>\n
| Command | Description | ### Admin Commands (Permission Level 4)<\/p>\n | Command | Description | —<\/p>\n ## Configuration Files<\/p>\n All configuration is located in the `config\/cobblepass\/` directory.<\/p>\n ### `config.json`<\/p>\n This file controls the core mechanics of the Battle Pass.<\/p>\n “`json **XP Values (catchXP, defeatXP, etc.):** The amount of Battle Pass XP granted for each action.<\/p>\n **premiumCost:** The price for the premium pass, using your server’s economy.<\/p>\n **seasonDurationDays:** The length of a season in days, set via `\/bp create`.<\/p>\n **currentSeason, seasonStartTime, seasonEndTime:** These are managed automatically by the `\/bp season` and `\/bp create` commands. Do not edit manually.<\/p>\n **enablePermissionNodes:** Set to `true` to use a permissions plugin for command access.<\/p>\n **premiumMode:** Set to `true` to enable the premium track for the current season.<\/p>\n **xpProgression:**<\/p>\n – **mode:** Either `”FORMULA”` or `”MANUAL”`. ### `tiers.json`<\/p>\n The heart of your Battle Pass, where all rewards are defined.<\/p>\n “`json – **templates:** (Optional) Define reusable rewards here. Give a template a name (e.g., “rare_candy_stack”) and then reference it in a tier using `”$template”: “rare_candy_stack”`. This is great for recurring rewards. ### Player Data<\/p>\n Player progress is stored individually in `config\/cobblepass\/players\/ “`json A battle pass side-mod for Cobblemon 1.6+<\/p>\n","protected":false},"featured_media":41958,"template":"","meta":{"_minecraft_slug":"cobble-pass","_minecraft_project_id":"kwczGJ3m","_minecraft_author":"Turiddu","_minecraft_license":"MIT","_minecraft_downloads":16858,"_minecraft_follows":26,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"cobble-pass.zip","_minecraft_size_bytes":425654,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-15T18:45:22.695899Z","_minecraft_date_created":"2025-01-03T05:13:37.819299Z","_minecraft_date_modified":"2025-12-03T16:48:28.448417Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/cobble-pass","_minecraft_icon_attachment_id":41958,"_minecraft_imported_at":"2026-06-01T23:20:33+00:00","_minecraft_import_hash":"bde44c98fc341ebd19df930cefe42974","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,97,89],"mod_loader":[99],"minecraft_version":[37],"class_list":["post-41957","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-fabric","mod_category-game-mechanics","mod_loader-fabric","minecraft_version-1-21-1"],"yoast_head":"\n
\n| :— | :— |
\n| `\/bp` | Opens the main Battle Pass GUI to view progress and claim rewards. |
\n| `\/bp premium` | Shows information about the premium pass, including cost and status. |
\n| `\/bp premium buy` | Purchases the premium pass if `premiumMode` is enabled and the player has enough funds. |
\n| `\/bp claim
\n| :— | :— |
\n| `\/bp create` | Opens a GUI to create a new Battle Pass season from scratch. |
\n| `\/bp delete confirm` | **Deletes all Battle Pass files** (`config.json`, `tiers.json`, and all player data). This is irreversible. |
\n| `\/bp season start` | Starts the currently configured season. |
\n| `\/bp season stop` | Stops the active season, pausing the timer. |
\n| `\/bp reload` | Reloads `config.json` and `tiers.json` from the disk. Player data is unaffected. |
\n| `\/bp addxp
\n| `\/bp addlevels
\n| `\/bp premiumanage add
\n| `\/bp premiumanage remove
\n{
\n “catchXP”: 50,
\n “defeatXP”: 25,
\n “evolveXP”: 100,
\n “hatchXP”: 75,
\n “tradeXP”: 50,
\n “premiumCost”: 1000,
\n “seasonDurationDays”: 30,
\n “currentSeason”: 1,
\n “seasonStartTime”: 1729898400000,
\n “seasonEndTime”: 1732490400000,
\n “enablePermissionNodes”: true,
\n “premiumMode”: true,
\n “xpProgression”: {
\n “mode”: “FORMULA”,
\n “xpPerLevel”: 1000,
\n “xpMultiplier”: 1.05,
\n “manualXpValues”: {}
\n }
\n}
\n“`<\/p>\n
\n– If `FORMULA`: uses `xpPerLevel` as the base and `xpMultiplier` to increase the requirement each level. (e.g., Level 2 needs 1000 XP, Level 3 needs 1000*1.05=1050 XP, etc.)
\n– If `MANUAL`: uses the `manualXpValues` map to define XP for each level specifically.
\n “`json
\n “manualXpValues”: {
\n “2”: 500,
\n “3”: 550,
\n “4”: 600
\n }
\n “`<\/p>\n
\n{
\n “templates”: {
\n “rare_candy_stack”: {
\n “type”: “ITEM”,
\n “data”: { “id”: “cobblemon:rare_candy”, “Count”: 5 }
\n },
\n “greeting_command”: {
\n “type”: “COMMAND”,
\n “command”: “tellraw %player% {“text”:”Thanks for supporting the server!”,”color”:”gold”}”,
\n “data”: { “id”: “minecraft:paper”, “display_name”: “\u00a76Server Thank You” }
\n }
\n },
\n “tiers”: [
\n {
\n “level”: 1,
\n “freeReward”: {
\n “type”: “ITEM”,
\n “data”: { “id”: “cobblemon:poke_ball”, “Count”: 10 }
\n }
\n },
\n {
\n “level”: 5,
\n “freeReward”: {
\n “$template”: “rare_candy_stack”
\n },
\n “premiumReward”: {
\n “type”: “POKEMON”,
\n “data”: {
\n “species”: “eevee”,
\n “level”: 5,
\n “shiny”: true
\n }
\n }
\n },
\n {
\n “level”: 10,
\n “premiumReward”: {
\n “$template”: “greeting_command”
\n }
\n }
\n ]
\n}
\n“`<\/p>\n
\n– **tiers:** A list of tier objects. Each object must have a `level`.
\n– **Reward Objects:** Can be `freeReward` or `premiumReward`.
\n – **type:** `ITEM`, `POKEMON`, or `COMMAND`.
\n – **data:**
\n – For `ITEM`: The `id` of the item and its `Count`. You can add any other NBT data here too.
\n – For `POKEMON`: The `species` is required. You can also specify `level`, `shiny`, `ability`, and more. The display item in the GUI will be a sprite of that Pok\u00e9mon.
\n – For `COMMAND`: The `id` specifies which item to display in the GUI. You can also add a custom `display_name`.
\n – **command:** (Only for `COMMAND` type) The command string to execute. Use `%player%` for the player’s name and `%uuid%` for their UUID.<\/p>\n
\n{
\n “version”: “1.0”,
\n “level”: 5,
\n “xp”: 250,
\n “isPremium”: true,
\n “claimedFreeRewards”: [
\n 1,
\n 2,
\n 3,
\n 4,
\n 5
\n ],
\n “claimedPremiumRewards”: [
\n 5
\n ]
\n}<\/p>\n","protected":false},"excerpt":{"rendered":"