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%