Configuration

The Cobblemon IV Candy mod provides extensive configuration options to customize drop rates and amounts for different types of Pokémon. This allows server administrators and players to fine-tune the mod to their preferences.

Table of contents

  1. Configuration File Location
  2. Configuration Options
    1. Species Drop Settings
    2. Type Drop Settings
    3. Legendary Pokémon Settings
    4. Mythical Pokémon Settings
    5. Ultra Beast Settings
    6. Paradox Pokémon Settings
  3. Example Configuration
  4. How to Edit Configuration
  5. Drop Mechanics
    1. How Drops Work
    2. Drop Priority
    3. Multiple Type Pokémon
  6. Configuration Validation
  7. Troubleshooting
    1. Configuration Not Loading
    2. Backup Files
    3. Default Values Reset
  8. Advanced Configuration Tips
    1. Balanced Gameplay
    2. Server Performance
    3. Economy Integration

Configuration File Location

The configuration file is automatically created when the mod first runs and is located at:

config/cobblemon_iv_candy.json

This file is in JSON format and can be edited with any text editor. The mod will automatically create this file with default values if it doesn’t exist.

Configuration Options

Species Drop Settings

Controls the drop rates and amounts for regular (non-special) Pokémon.

Setting Default Description
pokemon_species_drop_chance 10 Percentage chance (0-100) for regular Pokémon to drop Species IV Shards
pokemon_species_drop_amount 1 Number of Species IV Shards dropped when triggered

Type Drop Settings

Controls the drop rates and amounts for elemental/type-specific IV Shards from all Pokémon.

Setting Default Description
pokemon_type_drop_chance 5 Percentage chance (0-100) for Pokémon to drop Type IV Shards based on their types
pokemon_type_drop_amount 1 Number of Type IV Shards dropped when triggered

Legendary Pokémon Settings

Controls drops from Legendary Pokémon, which have guaranteed drops by default.

Setting Default Description
pokemon_legendary_drop_chance 100 Percentage chance (0-100) for Legendary Pokémon to drop IV Shards
pokemon_legendary_drop_amount 1 Number of IV Shards dropped from Legendary Pokémon

Mythical Pokémon Settings

Controls drops from Mythical Pokémon, which have guaranteed drops by default.

Setting Default Description
pokemon_mythical_drop_chance 100 Percentage chance (0-100) for Mythical Pokémon to drop IV Shards
pokemon_mythical_drop_amount 1 Number of IV Shards dropped from Mythical Pokémon

Ultra Beast Settings

Controls drops from Ultra Beast Pokémon, which have guaranteed drops by default.

Setting Default Description
pokemon_ultra_beast_drop_chance 100 Percentage chance (0-100) for Ultra Beast Pokémon to drop IV Shards
pokemon_ultra_beast_drop_amount 1 Number of IV Shards dropped from Ultra Beast Pokémon

Paradox Pokémon Settings

Controls drops from Paradox Pokémon, which have guaranteed drops by default.

Setting Default Description
pokemon_paradox_drop_chance 100 Percentage chance (0-100) for Paradox Pokémon to drop IV Shards
pokemon_paradox_drop_amount 1 Number of IV Shards dropped from Paradox Pokémon

Example Configuration

Here’s an example of a complete configuration file with custom values:

{
  "pokemon_species_drop_chance": 15.0,
  "pokemon_species_drop_amount": 2.0,
  "pokemon_type_drop_chance": 8.0,
  "pokemon_type_drop_amount": 1.0,
  "pokemon_legendary_drop_chance": 100.0,
  "pokemon_legendary_drop_amount": 3.0,
  "pokemon_mythical_drop_chance": 100.0,
  "pokemon_mythical_drop_amount": 3.0,
  "pokemon_ultra_beast_drop_chance": 100.0,
  "pokemon_ultra_beast_drop_amount": 2.0,
  "pokemon_paradox_drop_chance": 100.0,
  "pokemon_paradox_drop_amount": 2.0
}

How to Edit Configuration

  1. Stop your Minecraft server (if running on a server)
  2. Navigate to the config folder in your Minecraft installation directory
  3. Open cobblemon_iv_candy.json with any text editor
  4. Modify the values according to your preferences
  5. Save the file
  6. Restart your Minecraft server or reload the mod

Important: All percentage values must be between 0 and 100. The mod will automatically validate these values and reset invalid ones to defaults.

Drop Mechanics

How Drops Work

  • Species Drops: All non-special Pokémon (regular, non-legendary/mythical/ultra beast/paradox) can drop Species IV Shards
  • Type Drops: All Pokémon can drop Type IV Shards based on their primary and secondary types
  • Special Drops: Legendary, Mythical, Ultra Beast, and Paradox Pokémon drop their respective special shards

Drop Priority

When a Pokémon is defeated, the mod checks for drops in this order:

  1. Special category drops (Legendary/Mythical/Ultra Beast/Paradox) - these override species drops
  2. Type-specific drops - checked for all Pokémon regardless of category
  3. Species drops - only for regular (non-special) Pokémon

Multiple Type Pokémon

Pokémon with dual types have separate chances to drop shards for each of their types. For example, a Fire/Flying type Pokémon can potentially drop both Fire IV Shards and Flying IV Shards in a single encounter.

Configuration Validation

The mod automatically validates configuration values when loading:

  • Percentage values are clamped between 0 and 100
  • Invalid configurations are backed up and reset to defaults
  • Missing values are filled in with default values
  • Validation errors are logged for troubleshooting

Troubleshooting

Configuration Not Loading

If your configuration changes aren’t taking effect:

  1. Check the game/server logs for validation errors
  2. Ensure the JSON syntax is correct (use a JSON validator if needed)
  3. Verify file permissions allow reading/writing
  4. Check if a backup file was created (indicates corrupted JSON)

Backup Files

If the mod detects a corrupted configuration file, it will:

  1. Create a backup with timestamp: cobblemon_iv_candy.json.backup.{timestamp}
  2. Generate a new default configuration
  3. Log the issue for review

Default Values Reset

If you see your custom values reset to defaults, check the logs for validation errors. Common issues:

  • Percentage values outside 0-100 range
  • Invalid JSON syntax
  • Non-numeric values in numeric fields

Advanced Configuration Tips

Balanced Gameplay

For balanced gameplay, consider these guidelines:

  • Keep regular Pokémon drop chances low (5-15%) to maintain resource scarcity
  • Special Pokémon (Legendary/Mythical) can have higher rates since they’re rarer
  • Adjust drop amounts based on your server’s economy and progression speed

Server Performance

Higher drop chances don’t significantly impact performance, but consider:

  • Very high drop amounts may flood inventory quickly
  • Frequent drops may increase item entity counts temporarily

Economy Integration

If using economy mods, consider:

  • Lower drop rates for more valuable progression
  • Higher drop amounts if items will be traded frequently
  • Balance against other resource-gathering mechanics