---

📝 Patch Notes — Cobblemon Cards 1.0.2

This release contains various features, balance adjustments, and bug fixes for both Fabric and NeoForge.

---

✨ Features & Content Updates

Dynamax & Gigantamax Support in Card Workshop

• Form Sprites: Added all existing Gigantamax, G-Max, and Eternamax form sprites to the Card Workshop Screen selection list.
• Improved Resolution: Improved base-species resolution in both the card rendering system (CardItemRenderer) and commands (GiveCardCommand). This ensures form-specific sprites (e.g., charizard_gigantamax or gengar_gmax) from the mod's textures are correctly resolved and render on cards instead of displaying missing.png.

Fakemon Card Drop Whitelist (Datapack & Resource Pack)

• Custom Datapack Whitelists: Modpack creators can now selectively enable card drops and booster pack inclusion for specific Fakemon species by creating JSON files under: data/cobblemon-cards/fakemon_cards/your_whitelist.json Format:

{
  "replace": false,
  "species": [
    "my_fakemon_id", 
    "another_one"
  ]
}

• Dynamic Reloading: Changes to whitelist datapacks take effect immediately in-game using the /reload command. Cache invalidation is handled automatically.
• Resource Pack Integration: Textures for whitelisted Fakemon are loaded dynamically from: assets/cobblemon-cards/textures/item/cards/pokemon/regular/{species_name}.png (and .../shiny/{species_name}.png).

Species-Aware Rarity System (SpeciesRarityManager)

• Natural Rarity Distribution: Integrated a smart weighting system so that card generation feels more organic. Instead of all Pokémon being equally likely in every slot, species now lean toward card rarities that match their lore and strength (e.g., starters and fossils lean Rare, Legendaries lean Legendary, basic forms lean Common).
• Cross-Platform System Configuration: Generates a new file config/cobblemon-cards-species-rarity.json upon launch, allowing server owners to enable/disable the system, adjust weights, or override individual Pokémon rules (setting minimum/maximum card rarities).
• Species-Aware Capture Drops: Capturing or defeating a Legendary/Mythic species now skews card drops toward higher rarities instead of using standard uniform probabilities.

---

⚙️ Configuration Updates

Default Exclude for Fakemon

• New Entry: Introduced a new configuration entry: allowFakemonCards (defaults to false).
• Behavior: When set to false, species with a National Pokédex number outside 1–1025 (addon-added Fakemon) are automatically excluded from card drops and booster packs, preventing immersion breaks due to missing sprites.
• In-Game Toggle: Toggleable in-game via the MidnightConfig menu without requiring a server reboot.

---

🐛 Bug Fixes

Binder & Card Cabinet Storage Expansion (Data Loss & Crash Fix)

• Unlimited Storage: Fixed a critical server crash (java.lang.IllegalArgumentException: Got 291 items, but maximum is 256) that occurred when binders contained more than 256 cards. Card list storage has been moved to a custom, unlimited BINDER_CONTENTS component.
• Seamless Crafting Upgrades: Fixed a bug where upgrading binders (e.g., Leather -> Master Album) or crafting a Card Cabinet from a Master Album resulted in losing all stored cards due to a vanilla container item 256-cap. Both Binders and Card Cabinets now use the unlimited data structure when crafted.
• NeoForge Mixin Load Fix: Resolved an issue where recipe data copy mixins did not load in NeoForge development environments by officially declaring the mixin config under the [[mixins]] key in neoforge.mods.toml.
• Legacy Save Migration: Seamlessly migrates card container data from legacy vanilla components to the new unlimited format when opening legacy binders.

huge thanks to Nothh888 for the SpeciesRarityManager !