Cobblemon JEI & JourneyMap Integration

是一个面向 Minecraft Java 版（NeoForge 与 Fabric 1.21.1）的高性能客户端模组，旨在将 Cobblemon 生态与 JEI物品管理器（JEI） 和 旅行地图 无缝衔接。

它提供：

1. 全面的 JEI 集成，可查询任意物种的自然生成条件（生物群系、维度、天气、时间窗口、高度、生成情境）以及完整的进化树。
2. 交互式旅行地图制图，在小地图与全屏地图上显示已探索的可生成区域，具备 2D 几何区块多边形合并与稀有度配色方案。
3. 实时实体雷达与全局闪光哨戒（被动扫描并在附近出现野生闪光宝可梦时通过视觉提示与音效号角提醒你）。
4. 动态结构发现，自动定位考古化石挖掘点与传说纪念碑神龛。
5. 沉浸式浮动 HUD，在全屏旅行地图工具栏正下方直接显示所追踪物种的统计数据、属性类型与实时探测计数。

🌟 主要特性

1. 🔍 JEI物品管理器（JEI）集成

• 按 Cobblemon 物种成分搜索：可通过译名（英文/法文）、全国图鉴编号或属性类型查询任意宝可梦。
• 超详细生成卡片：
  • 可用维度（主世界、下界、末地，以及天境等模组维度）。
  • 允许的生物群系（支持 #minecraft:is_forest、#c:is_nether 等动态注册表标签解析）。
  • 环境条件：天气（晴朗、降雨、雷暴）、一天中的时段（白天、夜晚、黎明、黄昏）、Y 高度范围以及生成情境（地面、水中、熔岩、地下、钓鱼）。
  • 生成权重、预估稀有度档位与等级范围。
• 进化树卡片：
  • 等级阈值、进化石与物品（连接绳、携带物品）、交易条件、亲密度等级以及所需的时间窗口。

2. 🗺️ 旅行地图制图与叠加层

• 专用全屏工具栏按钮：自定义精灵球图标，可即时搜索并切换宝可梦物种追踪。
• 几何区块多边形合并（ChunkPolygonMerger）：
  • 自动将相邻的可用区块合并为平滑、整洁的 2D 多边形边界。
  • 消除内部网格线，并将地图叠加图形对象减少多达 95%，从而实现流畅帧率。
• 稀有度配色方案（RarityColorPalette）：
  • 🟢 常见：翠绿色（#2ECC71）
  • 🔵 少见：泻湖蓝（#3498DB）
  • 🟣 稀有：紫水晶紫（#9B59B6）
  • 🟠 超稀有：霓虹琥珀色（#E67E22）
• 两级异步磁盘扫描器（JourneyMapDiskScanner）：
  • 第一级（即时）：利用活跃的 RAM 区块与内存缓存立即渲染（< 15 毫秒）。
  • 第二级（后台线程）：对磁盘上已探索的世界区域（.mca、.jmc、旅行地图地图瓦片）进行多线程异步扫描。
  • 完整的多维度支持（主世界、下界、末地、模组维度）。

3. ⚡ 实时实体雷达与全局闪光哨戒

• 常驻全局闪光哨戒：
  • 被动扫描范围内的任意野生闪光宝可梦（水平约160格，垂直64格），即使当前未选择任何宝可梦或正在追踪其他目标时也会生效。
  • 音频号角：播放庆祝音效（UI_TOAST_CHALLENGE_COMPLETE）。
  • 视觉通知：客户端动作栏中显示金色高亮横幅。
  • 专用地图标记（MarkerOverlay）：闪烁的金色精灵球标记，精确高亮闪光宝可梦的位置，并附带物种名称、等级和状态提示信息。
• 活动目标雷达：
  • 实时追踪所选物种和形态的实时位置。
  • 在小地图和全屏地图上平滑移动标记。
  • 实体被捕获、击败或消失时自动移除。

4. 🏛️ 动态结构发现：化石与传说纪念碑

• 零硬编码注册表列表：
  • 在加入世界时动态检查游戏的Registries.STRUCTURE。
  • 按命名空间（cobblemon、legendarymonuments）和数据标签（#cobblemon:fossil、#cobblemon:legendary）自动索引结构。
• 考古化石遗址（FossilStructureHandler）：
  • 专用 JourneyMap 叠加层分类："Cobblemon Fossils"。
  • 详细提示信息显示可复活的史前物种（菊石兽、化石盔、化石翼龙、触手百合、太古羽虫、盾甲龙、头盖龙、原盖海龟、始祖小鸟、宝宝暴龙、冰雪龙和伽勒尔化石）。
  • 精确定位可疑方块（BrushableBlockEntity / 可疑的沙子和可疑的沙砾）。
• 传说纪念碑与神龛（LegendaryStructureHandler）：
  • 专用 JourneyMap 叠加层分类："Legendary Monuments"。
  • 独特的 shrine 标记精确居中于已加载区块中的基座方块（*_pedestal）、祭坛和圣所上方。
• 交互式交叉高亮器：
  • 在 JEI 或 JourneyMap 中选择化石或传说物种时，立即照亮其对应的考古和纪念碑地点。
• 异步磁盘性能（StructureRegionScanner）：
  • 多线程异步解析 Anvil 区块头（.mca）并持久缓存。

5. 🎴 浮动 HUD 与实时统计

• 现代浮动信息卡直接集成在 JourneyMap 工具栏按钮下方：
  • 3D 宝可梦模型预览或官方精灵图标。
  • 彩色元素属性徽章。
  • 图鉴编号和估计稀有度指示器。
  • 异步区域扫描的动画进度指示器。
  • 实时雷达状态（“范围内有 X 个目标” / “★ 检测到闪光！”）。