Items Overview

The Cobblemon IV Candy mod introduces two main categories of items that work together to provide a comprehensive IV enhancement system for your Pokémon.

Table of contents

  1. Item Categories
    1. 🔮 IV Shards
    2. 🍬 IV Candies
    3. ⚡ IV Extractors
  2. How They Work Together
    1. The Enhancement Process
    2. Item Relationship Flow
    3. Compatibility System
  3. Quick Reference
    1. Drop Rates (Default)
    2. Crafting Overview
    3. Usage Limits
  4. Getting Started
    1. For New Players
    2. For Advanced Users
  5. Related Documentation
  6. Technical Overview
    1. Item Registry
    2. Data Storage
    3. Mod Integration

Item Categories

🔮 IV Shards

IV Shards are the raw materials used to craft IV Candies. They are obtained when Pokémon faint and serve as the foundation for the candy crafting system.

Key Features:

  • Dropped by defeated Pokémon
  • Multiple types based on species, elements, and special categories
  • Cannot be crafted manually
  • Used as crafting components for IV Candies

Types Available:

  • Species Shards: Specific to individual Pokémon species
  • Elemental Shards: Based on the 18 Pokémon types
  • Special Shards: From Legendary, Mythical, Ultra Beast, and Paradox Pokémon

Learn more about IV Shards →

🍬 IV Candies

IV Candies are consumable items that enhance a Pokémon’s Individual Values when used. They are crafted from IV Shards using specific recipes.

Key Features:

  • Crafted from IV Shards using recipes
  • Enhance Pokémon IVs when used
  • Available in targeted and random variants
  • Compatible with specific Pokémon based on candy type

Enhancement Types:

  • Targeted Candies: Improve specific IV stats (HP, Attack, Defense, etc.)
  • Random Candies: Improve a random non-maxed IV stat

Learn more about IV Candies →

⚡ IV Extractors

IV Extractors are specialized tools that harvest perfect Individual Values from Pokémon and convert them into IV Candies. They provide a way to redistribute IVs between Pokémon.

Key Features:

  • Extract perfect IVs (value 31) from Pokémon
  • Convert extracted IVs into targeted candies
  • Reduce extracted stats to minimum value (1)
  • Compatible with specific Pokémon types and categories

Extractor Types:

  • Elemental Extractors: Work on Pokémon matching elemental types
  • Special Category Extractors: Work on Legendary, Mythical, Ultra Beast, and Paradox Pokémon

Learn more about IV Extractors →

How They Work Together

The Enhancement Process

  1. 🔥 Battle Pokémon → Defeat wild or trainer Pokémon
  2. 💎 Collect Shards → Shards drop based on the defeated Pokémon’s characteristics
  3. ⚒️ Craft Items → Use shards to create IV Candies or IV Extractors
  4. 🍬 Enhance Pokémon → Use candies on your Pokémon to improve their IVs
  5. ⚡ Extract IVs → Use extractors to harvest perfect IVs and create more candies
  6. 📈 Repeat Process → Continue to maximize your team’s potential

Item Relationship Flow 

Battle → Shards → Candies → Enhanced Pokémon
                ↓
              Extractors → Harvest Perfect IVs → More Candies

Compatibility System

The compatibility between shards, candies, extractors, and Pokémon follows a logical system:

Species Shard → Species Candy → Works on that species line
Fire Shard → Fire Candy/Extractor → Works on Fire-type Pokémon
Legendary Shard → Legendary Candy/Extractor → Works on Legendary Pokémon

This system ensures that you need to engage with different types of Pokémon to enhance your entire team effectively.

Quick Reference

Drop Rates (Default)

| Pokémon Category | Drop Chance | Configurable | |——————|————-|————–| | Regular Species | 10% | ✅ | | Type Shards | 5% | ✅ | | Legendary | 100% | ✅ | | Mythical | 100% | ✅ | | Ultra Beast | 100% | ✅ | | Paradox | 100% | ✅ |

All drop rates can be customized in the configuration file.

Crafting Overview

| Recipe Type | Ingredients | Result | |————-|————-|——–| | Basic Candy | 3x Shard (top row) | Random IV Candy | | Super Candy | 8x Shard + 1x Stat Apricorn (center) | Targeted IV Candy | | IV Extractor | 1x Shard + 1x Blaze Rod + 1x Rare Candy | IV Extractor |

For detailed recipes, see the Recipes Guide.

Usage Limits

  • Maximum IV Value: 31 (Pokémon standard)
  • Enhancement per Use: +1 IV point
  • Stack Size: 64 items per stack
  • Compatibility: Must match Pokémon type/species/category

Getting Started

For New Players

  1. Start Simple: Focus on collecting Species Shards from common Pokémon
  2. Learn Basics: Craft Random IV Candies first to understand the system
  3. Experiment: Try different shard types and see how they work
  4. Read Details: Check out the detailed guides for Shards and Candies

For Advanced Users

  1. Optimize Drop Rates: Customize the configuration for your playstyle
  2. Plan Your Team: Use Species and Type candies strategically
  3. Target Builds: Craft Targeted candies for competitive Pokémon
  4. Farm Efficiently: Focus on Pokémon that drop the shards you need most
  • IV Shards - Complete guide to shard types and drop mechanics
  • IV Candies - Detailed candy usage and compatibility information
  • IV Extractors - Tools for harvesting and redistributing perfect IVs
  • Recipes - All crafting recipes for creating candies and extractors
  • Configuration - Customize drop rates and mod behavior
  • Commands - Useful in-game commands for testing and management

Technical Overview

Item Registry

Items are registered under the cobblemon_iv_candy namespace:

  • Shards: cobblemon_iv_candy:shard
  • Candies: cobblemon_iv_candy:candy
  • Extractors: cobblemon_iv_candy:iv_extractor

Data Storage

Items use custom data components to store:

  • Type Information: Species ID, elemental type, or special category
  • Visual Data: Custom model data for unique appearances
  • Compatibility Rules: Logic for determining valid usage

Mod Integration

Full integration with Cobblemon’s systems:

  • Pokémon Recognition: Automatically detects all Pokémon types and categories
  • IV System: Direct integration with Cobblemon’s IV mechanics
  • Save Compatibility: Items persist across world saves and server restarts

Table of contents