CobbleQuestBridge

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