CobbleBattleRewards

CobbleBattleRewards

CobbleBattleRewards is a configurable Fabric mod for rewarding players during Cobblemon battles and captures. Rewards can be edited in-game with a GUI reward editor or configured manually through the config file.

Create rewards for battle wins, losses, forfeits, captures, out-of-battle catches, and wild Pokémon kills. Rewards can give items, run commands, use economy plugins, target specific Pokémon, and apply filters for species, forms, aspects, types, labels, levels, dimensions, and more.

Dependencies

• Fabric API
• Fabric Language Kotlin
• Cobblemon
• E-Utils

Features

• In-Game Reward Editor: Create, edit, move, and delete rewards through /cbr gui.
• Multiple Reward Triggers: Reward battle wins, losses, forfeits, captures, out-of-battle captures, and wild Pokémon kills.
• Item and Command Rewards: Give item stacks or run server commands, including economy commands.
• Pokemon Targeting: Select Pokémon, forms, aspects, shiny variants, labels, and scanned conditions through the GUI.
• Allow/Block Filter Modes: Use filters as requirements or exclusions for Pokémon, labels, and scanned conditions.
• Battle Type Support: Configure rewards for wild, NPC, and PvP battles.
• Priority System: Higher priority rewards run first, and rewards can block lower-priority rewards with excludedRewards.
• Cooldowns and Chance: Add per-reward cooldowns and chance rolls.
• Dimension and Level Filters: Limit rewards to specific dimensions or Pokémon level ranges.
• Safe Config Migration: Older configs are migrated forward automatically.

Commands

| Command | Permission | Description |
| :— | :— | :— |
| /cbr gui | cobblebattlerewards.gui | Opens the in-game reward editor GUI. |
| /cbr editgui | cobblebattlerewards.gui | Also opens the reward editor GUI. |
| /cbr reload | cobblebattlerewards.reload | Reloads the config from disk without a server restart. |
| /cbr listrewards | cobblebattlerewards.list | Lists configured rewards in chat. |
| /cbr listconditions | cobblebattlerewards.list_conditions | Lists available Pokémon condition data for advanced filtering. |

GUI Reward Editor

The GUI editor is the recommended way to manage rewards.

With /cbr gui, you can:

• Add command rewards.
• Add item rewards by placing an item into the GUI.
• Change reward category.
• Edit reward chance, priority, message, command, and item payload.
• Select Pokémon, forms, aspects, and shiny variants.
• Select Cobblemon form labels.
• Scan Pokémon data for advanced condition filters.
• Toggle allow/block modes for each filter group.
• Enable out-of-battle capture or wild kill rewards.
• Delete rewards safely from the GUI.

Configuration

CobbleBattleRewards stores its config at:

config/cobblebattlerewards/config.jsonc

Most users should use the GUI editor, but manual config editing is still supported.

The config has four main reward categories:

• battleWonRewards
• battleLostRewards
• battleForfeitRewards
• captureRewards

Common reward settings:

| Setting | Description |
| :— | :— |
| type | "item" gives an item. "command" runs a server command. |
| chance | Percentage chance from 0.0 to 100.0. |
| message | Message sent to the player when the reward is given. |
| command | Command to run for command rewards. Do not include /. |
| itemStack | JSON item stack data for item rewards. |
| battleTypes | Supported battle types: "wild", "npc", "pvp". |
| conditions | Pokémon/species/form/aspect filters, usually managed by the GUI. |
| disallowedLabels | Label filters selected through the GUI. |
| exclusionConditions | Advanced scanned condition filters selected through the GUI. |
| pokemonConditionsBlacklist | Makes Pokémon filters act as block filters. |
| labelConditionsBlacklist | Makes label filters act as block filters. |
| scannedConditionsBlacklist | Makes scanned condition filters act as block filters. |
| rewardOutOfBattleCapture | Allows capture rewards from normal out-of-battle catches. |
| rewardOutOfBattleKill | Allows battle-won rewards from wild Pokémon kills outside battle. |
| minLevel / maxLevel | Level range required for the reward. |
| order | Reward priority. Higher numbers run first. |
| excludedRewards | Reward IDs blocked if this reward is given. |
| cooldown | Seconds before the player can receive this reward again. |
| allowedDimensions | Dimension IDs where the reward can trigger. Empty means all dimensions. |

Placeholders

Messages and commands support:

• %player%
• %pokemon%
• %level%
• %battleType%
• %chance%
• %coords%
• %trigger%
• %time%