CobbleQuestBridge

CobbleQuestBridge is a Fabric client + server mod for Minecraft 1.21.1 that bridges Cobblemon Pokémon capture events with Minecraft custom statistics, scoreboards, and FTB Quests.

It allows fully automatic, reliable, and configurable quest progression based on Pokémon captures — without command hacks or manual syncing.

✨ Core Functionality

Each time a player captures a Pokémon, CobbleQuestBridge can update multiple counters depending on your configuration:

Total Pokémon captured
Unique Pokémon species captured (Pokédex-style)
Per-type capture counters (Fire, Water, Grass, etc.)
Shiny Pokémon captures
Specific Pokémon species tracking (Pikachu, Eevee, etc.)

All data is exposed in two different systems:

Minecraft Custom Stats
→ Used by FTB Quests (Stat task type)
Scoreboards
→ Usable for TAB list, sidebar display, commands, and logic

🧬 Unique Pokémon Counter (Pokédex Progression)

CobbleQuestBridge can track unique Pokémon species captured per player.

Each species is only counted once
Perfect for Pokédex-style progression
Ideal for quests such as:
- “Capture 10 different Pokémon”
- “Register 50 unique species”
- “Complete your first Pokédex entries”
This counter is automatically managed by the mod and exposed as:
- a custom Minecraft stat (FTB Quests compatible)
- a scoreboard objective (optional, for display)

🧩 FTB Quests Integration (Main Feature)

FTB Quests cannot read dummy scoreboards, but it can read Minecraft custom stats.

CobbleQuestBridge registers and updates custom stats (minecraft.custom:*) that:

Appear automatically in the Stat task dropdown
Update instantly when Pokémon are captured
Work in singleplayer and multiplayer

Example quests you can create:

Capture 10 Pokémon total
Capture 5 Fire-type Pokémon
Capture a Shiny Pokémon
Capture Pikachu (or any configured species)

No commands, no manual triggers — just pure gameplay.

🏆 Placeholder API Integration (Leaderboards)

When Placeholder API is installed on the server, CobbleQuestBridge provides Top 10 leaderboard placeholders.

Available leaderboards:

Total captures
Unique species (Pokédex)
Shiny Pokémon

Example placeholders:

%cobblequestbridge:unique_top_name_1%
%cobblequestbridge:unique_top_score_1%
%cobblequestbridge:total_top_name_3%

These can be used in:

Scoreboards
Signs
TAB list
Any mod supporting Placeholder API

⚠️ Server-side only — clients do not need Placeholder API installed.

⚙️ Configuration (JSON)

CobbleQuestBridge is fully configurable via a simple JSON file:

{
  "enableTotalCounter": true,
  "enableTypeCounters": true,
  "enableShinyCounter": true,
  "enableSpeciesTracking": true,
  "speciesTrackingMode": "increment",
  "trackedSpecies": [
    "pikachu",
    "eevee",
    "charmander",
    "bulbasaur",
    "squirtle"
  ],
  "totalObjective": "cqb_total",
  "shinyObjective": "cqb_shiny",
  "typePrefix": "cqb_type_",
  "speciesPrefix": "cqb_species_"
}

Main options:

enableTotalCounter – Total Pokémon capture counter
enableTypeCounters – Per-type capture counters
enableShinyCounter – Shiny Pokémon tracking
enableSpeciesTracking – Track specific Pokémon species
speciesTrackingMode
- increment → increases on every capture
- set_one → set to 1 on first capture only
trackedSpecies – List of Pokémon species to track
Objective names / prefixes – Customize scoreboard & stat IDs

🖥️ Client + Server Requirement (IMPORTANT)

CobbleQuestBridge must be installed on BOTH the server and the client.

Because the mod registers custom Minecraft stats, Fabric requires:

the same mod version
the same configuration file

on both sides.
If not, players will be disconnected due to registry mismatch.

➡️ Always ensure:

The mod JAR is installed on client and server
The config file is identical on both sides

🎯 Ideal Use Cases

Cobblemon-focused progression servers
Pokémon-based questlines
RPG / adventure modpacks using FTB Quests
Servers that want visible Pokémon stats in TAB or sidebar
Competitive Pokédex or shiny hunting leaderboards