FCCombo - A Catch Combo & Shiny Enhancement System for Cobblemon 1.7.1 (Fabric 1.21.1)

FCCombo introduces a dynamic, customizable catch combo system for Cobblemon servers, rewarding players who repeatedly catch the same species with progressively boosted shiny odds, live combo tracking, and full server-side control.

Perfect for survival servers, shiny hunters, and progression-focused Cobblemon communities.

🎣 Features

⭐ Catch Combo System

• Tracks how many Pokémon of a single species a player has caught.
• Switching species resets the chain automatically.
• Clean, informative messages for combo milestones and interruptions.

⭐ Shiny Boosting

• Each combo step reduces shiny odds multiplicatively.
• Fully integrated with Cobblemon’s spawn logic.
• Boost applies only to Pokémon spawning near the player maintaining the chain.
• Optional per-species blacklist for no-boost Pokémon.

⭐ Action Bar Tracking

• Always-visible combo display (toggleable).
• Shows current species, combo count, and boosted shiny odds.
• Updates automatically on catches and server ticks.

⭐ Player-Friendly Controls

• Players can toggle catch combo chat messages on/off.
• Clean prefix and readable formatting for all plugin messages.
• All colors support vanilla § formatting via the config.

⭐ Admin & Server Capabilities

• Force-set player combos.
• Toggle the entire plugin on/off.
• Reload the config live — no restart needed.
• Server-side only: clients do not need the mod.

⭐ Persistence

• Player combos automatically save to disk.
• Fully restored on server restart.

⚙️ Configuration

All config files are located in:

• config/FCCombo/catchcombo_config.json

General Settings

• enabled Master on/off switch for the plugin.
• stepSize Number of catches required for each shiny odds boost.
• speciesExceptions Pokémon species that never receive shiny boosts.
• prefix Plugin prefix (e.g., §b[SoulCombo]).
• messageColor Color of all informational text (RGB supported).

Shiny Odds

• baseShinyOdds Starting shiny odds (default 8192).
• minShinyOdds Minimum achievable shiny odds (default 512).

Odds scale multiplicatively with each combo threshold, e.g.:

20 catches → 4096
40 catches → 2048
60 catches → 1024
etc.

⌨️ Commands

Player Commands

• /catchcombo Shows your current combo and shiny odds.
• /catchcombo chat Toggles personal combo messages on/off.

##Admin Commands

• /catchcombo set Force-sets a player’s combo.
• /catchcombo toggle Enables/disables the entire plugin.
• /catchcombo reload Reloads configuration files.
• /catchcombo actionbar Toggles the action bar display.

🛠️ Compatibility

Server-side only — clients do not need the mod.
Requires Cobblemon 1.7.1 (Fabric).

📥 Installation

Install Fabric Loader & Fabric API.

Install Cobblemon 1.7.1 (Fabric).

Drop SoulCombo into your server’s mods folder.

Start the server to generate config files.

Tweak configuration in config/FCCombo/ as desired.