矿石探测器

【标题】
《星露谷物语》矿石/梯子/洞穴实时追踪 MOD 使用指南

【核心介绍】
实时显示当前矿井层级中可开采矿石的数量（当前值/最大值），并用线条精准指向所有梯子与洞穴，支持高度自定义显示位置、颜色与样式。

【安装指南】

1. 下载文件：从 GitHub 仓库获取最新版本「Ore-Detector」；
2. 安装路径：将解压后的文件夹整体复制到游戏根目录 `/mods` 文件夹内；
3. 启用模组：启动游戏后，在「Mods」菜单中勾选「Ore-Detector」即可生效——缺一不可。

【功能详情】
✅ 已优化：

• 实时显示当前矿井层级中所有可开采矿石的「当前值」与「最大值」；
• 支持 4 种预设显示位置（玩家上方 / 左上角 / 光标旁 / 自定义坐标）；
• 可绘制彩色线条指向当前层级全部「梯子」与「洞穴」（不穿透上方方块）；
• 提供文本背景色开关，提升低对比度矿井（如火山岛火山地形）的可读性；
• 支持缩放调节与多种字体/颜色/透明度自定义；
• 内置黑名单功能，可手动隐藏指定矿石类型。
  ❌ 未修改：
• 游戏原版矿井生成逻辑、矿石掉落率、梯子/洞穴生成规则；
• 其他 UI 元素（如生命值、工具栏、背包）的布局与行为。
  ✨ 额外调整：
• 原生兼容「火山岛」地图中的特殊火山地形；
• 新增多套UI样式模板，一键切换简洁/高对比/半透明等风格。

【使用要求】

• 必需：游戏本体为 Stardew Valley v1.6+；
• 必需：已安装最新版 SMAPI（v4.0+）；
• 推荐：显示器分辨率 ≥ 1280×720（保障自定义UI正常渲染）。

【兼容性说明】

• 兼容范围：所有官方内容包（含「内容包：火山岛」「内容包：姜岛」）及主流 UI 类模组（如「CJB Item Spawner」「Tractor Mod」）；
• 不兼容模组：「Realistic Mining」（因同时重写矿石检测逻辑，会导致数值冲突）；
• 兼容补丁：暂未推出。

【注意事项】

• 梯子/洞穴连线默认仅指向「当前可见层级」内的目标，不会跨层追踪；
• 黑名单设置需在游戏内按 `F1` 打开设置界面后手动配置，首次启用后需重启模组生效；
• 在极少数自定义矿井地图（非官方）中，洞穴坐标识别可能存在微小偏移，不影响正常使用。

【更新日志】

• 2024 年 5 月 12 日 新增火山岛地形适配支持；
• 2024 年 4 月 3 日 增加文本背景开关与 3 套预设 UI 样式；
• 2024 年 3 月 8 日 开放坐标微调功能，支持像素级定位。