Cobblemon JEI & JourneyMap Integration

Cobblemon JEI & JourneyMap Integration is a high-performance client-side mod for Minecraft Java (NeoForge & Fabric 1.21.1), designed to seamlessly bridge the Cobblemon ecosystem with Just Enough Items (JEI) and JourneyMap.

It provides:

1. Comprehensive JEI Integration to look up natural spawn conditions (biomes, dimensions, weather, time windows, altitudes, contexts) and full evolution trees for any species.
2. Interactive JourneyMap Cartography showing explored spawn-eligible zones on both the minimap and fullscreen map, featuring 2D geometric chunk polygon merging and rarity-coded palettes.
3. Real-time Entity Radar & Global Shiny Sentry (passively scans and alerts you to any nearby wild Shiny Pokémon with visual announcements and audio fanfares).
4. Dynamic Structure Discovery automatically locating archaeological fossil dig sites and legendary monument shrines.
5. Immersive Floating HUD displaying tracked species stats, element types, and live detection counters directly below the fullscreen JourneyMap toolbar.

---

🌟 Key Features

1. 🔍 Just Enough Items (JEI) Integration

• Search by Cobblemon Species Ingredient: Look up any Pokémon by its translated name (EN/FR), National Pokédex number, or elemental types.
• Ultra-Detailed Spawn Cards:
  • Eligible dimensions (Overworld, Nether, End, plus modded dimensions such as The Aether).
  • Allowed biomes (with dynamic registry tag resolution like #minecraft:is_forest, #c:is_nether, etc.).
  • Environmental criteria: Weather (clear, rain, thunder), time of day (day, night, dawn, dusk), Y altitude bounds, and spawn contexts (ground, water, lava, underground, fishing).
  • Spawn weights, estimated rarity buckets, and level ranges.
• Evolution Tree Cards:
  • Level thresholds, evolution stones and items (linking cords, held items), trade conditions, friendship levels, and required time-of-day windows.

---

2. 🗺️ JourneyMap Mapping & Overlays

• Dedicated Fullscreen Toolbar Button: Custom Pokéball icon allowing instant searching and toggling of Pokémon species tracking.
• Geometric Chunk Polygon Merger (ChunkPolygonMerger):
  • Automatically merges contiguous eligible chunks into smooth, clean 2D polygon boundaries.
  • Eliminates interior grid lines and reduces graphical map overlay objects by up to 95% for fluid framerates.
• Rarity Color Palette (RarityColorPalette):
  • 🟢 Common: Emerald Green (#2ECC71)
  • 🔵 Uncommon: Lagoon Blue (#3498DB)
  • 🟣 Rare: Amethyst Purple (#9B59B6)
  • 🟠 Ultra-Rare: Neon Amber (#E67E22)
• 2-Tier Asynchronous Disk Scanner (JourneyMapDiskScanner):
  • Tier 1 (Instantaneous): Immediate rendering (< 15 ms) utilizing active RAM chunks and in-memory caches.
  • Tier 2 (Background Thread): Multi-threaded asynchronous scanning of on-disk explored world regions (.mca, .jmc, JourneyMap map tiles).
  • Full multi-dimension support (Overworld, Nether, End, modded dimensions).

---

3. ⚡ Real-Time Entity Radar & Global Shiny Sentry

• Permanent Global Shiny Sentry:
  • Passively scans for any wild Shiny Pokémon within range (~160 blocks horizontally, 64 blocks vertically), even when no Pokémon is currently selected or when tracking a different target.
  • Audio Fanfare: Plays a celebratory chime (UI_TOAST_CHALLENGE_COMPLETE).
  • Visual Notification: Golden highlight banner in the client Actionbar.
  • Dedicated Map Marker (MarkerOverlay): Sparkling golden Pokéball marker highlighting the Shiny's exact position with species name, level, and status tooltip.
• Active Target Radar:
  • Tracks live positions of the selected species and form in real-time.
  • Smooth marker movement on both the minimap and fullscreen map.
  • Automatic removal upon entity capture, defeat, or despawn.

---

4. 🏛️ Dynamic Structure Discovery: Fossils & Legendary Monuments

• Zero Hardcoded Registry Lists:
  • Inspects the game's Registries.STRUCTURE dynamically during world join.
  • Automatically indexes structures by namespaces (cobblemon, legendarymonuments) and data tags (#cobblemon:fossil, #cobblemon:legendary).
• Archaeological Fossil Sites (FossilStructureHandler):
  • Dedicated JourneyMap overlay category: "Cobblemon Fossils".
  • Detailed tooltips displaying resurrectable prehistoric species (Omanyte, Kabuto, Aerodactyl, Lileep, Anorith, Shieldon, Cranidos, Tirtouga, Archen, Tyrunt, Amaura, and Galar fossils).
  • Accurate spatial positioning pinpointing suspicious blocks (BrushableBlockEntity / suspicious sand and gravel).
• Legendary Monuments & Shrines (LegendaryStructureHandler):
  • Dedicated JourneyMap overlay category: "Legendary Monuments".
  • Distinctive shrine markers centered precisely over pedestal blocks (*_pedestal), altars, and sanctums in loaded chunks.
• Interactive Cross-Highlighter:
  • Selecting a fossil or legendary species in JEI or JourneyMap immediately illuminates its corresponding archaeological and monument sites.
• Asynchronous Disk Performance (StructureRegionScanner):
  • Multi-threaded asynchronous parsing of Anvil chunk headers (.mca) with persistent caching.

---

5. 🎴 Floating HUD & Live Statistics

• Modern floating information card integrated directly below the JourneyMap toolbar button:
  • 3D Pokémon model preview or official sprite icon.
  • Colored elemental type badges.
  • Pokedex # and estimated rarity indicator.
  • Animated progress indicator for asynchronous region scanning.
  • Live radar status ("X target(s) in range" / "★ SHINY Detected!").