沉浸式矿床扫描仪

🧭⛏️ 沉浸式矿床扫描器 🛢️🗺️

沉浸式矿床扫描器（Immersive Deposit Scanner），简称 IDS，是一款为 Minecraft NeoForge 打造的附加模组，专为与 沉浸工程（Immersive Engineering）、沉浸石油（Immersive Petroleum） 和 旅行地图（JourneyMap） 配合使用的工业探索而设计。

IDS 会自动追踪通过有效岩心样本发现的矿物矿床和石油储层，然后使用清晰的路标和可选的区块覆盖层，将这些发现直接显示在 旅行地图 上。🧭📍

此模组专为希望更好地进行工业规划、规划更清晰的钻井路线、资源测绘以及适合服务器的探索而设计——不涉及透视、隐藏扫描或不公平的矿物探测。⚙️⛏️🛢️

---

✨ 主要特性

• ⛏️ 追踪 沉浸工程 的矿物矿床
• 🛢️ 追踪 沉浸石油 的流体储层
• 🧭 自动添加 旅行地图路标
• 🗺️ 可选 区块边界覆盖层
• 📍 在地图上直接显示发现的矿床
• 🔷 将矿物和石油的发现分开显示
• 🧱 支持同一个区块内的多个追踪矿床
• 💾 在服务器上保存发现记录
• 🌐 支持多人游戏同步
• 👤 支持个人发现追踪
• 🏭 支持全服发现共享
• 🔁 允许手动重新同步
• 🧪 允许扫描手持的岩心样本
• 🧹 允许移除追踪条目
• 🛠️ 专为工业模组包和生存工程世界设计

---

📦 必要依赖

IDS 需要安装以下所有模组才能运行：

• 🧭 旅行地图（JourneyMap）
• ⚙️ 沉浸工程（Immersive Engineering）
• 🛢️ 沉浸石油（Immersive Petroleum）
• 🔧 NeoForge
• 🧱 Minecraft 1.21.1
• ☕ Java 21

⚠️ 重要提示：
如果缺少 旅行地图、沉浸工程 或 沉浸石油，IDS 将无法加载。

此模组是必需的集成附加组件，并非独立的追踪模组。🧩

---

🧪 工作原理

当玩家获得或使用有效的岩心样本时，IDS 会读取由 沉浸工程 和 沉浸石油 暴露的矿床信息。🔍

如果发现有效数据，IDS 会在服务器上保存该发现，并将其同步到客户端。然后，旅行地图会以路标或区块覆盖层的形式显示该发现。🗺️📍

标记可以出现在：

• 📌 精确的样本位置（如果可用）；
• 🧱 相关区块的中心（当精确位置数据不可用时）。

IDS 不会 扫描世界寻找矿物。
IDS 不会 使用透视逻辑。
IDS 不会 揭示隐藏方块。
IDS 仅记录由有效的工业岩心样本合法揭示的信息。✅

---

🧭 旅行地图集成

IDS 使用旅行地图以视觉化、清晰的方式显示发现。🗺️✨

旅行地图条目可包括：

• 📍 矿物矿床路标
• 🛢️ 石油储层路标
• 🧱 区块边界覆盖层
• 🎨 针对 IE 和 IP 的独立标记样式
• 🏷️ 带有矿床名称的可读标签
• 📊 可选的剩余百分比信息
• 🧹 移除条目时自动清理

默认旅行地图分组：

• ⛏️ Immersive Deposit Scanner / Immersive Engineering
• 🛢️ Immersive Deposit Scanner / Immersive Petroleum

这使得规划挖掘机、抽油泵、钻机、管道、采矿前哨站和资源路线变得更加容易。🏭🚧

---

⛏️ 沉浸工程支持

IDS 可以追踪通过沉浸工程岩心样本发现的矿物矿床。⚙️⛏️

追踪信息可能包括：

• 🧱 维度
• 🗺️ 区块位置
• 📍 样本位置
• ⛏️ 矿物矿床名称
• 🔗 矿物标识符
• 👤 发现玩家
• 🕒 发现时间
• 🔁 最后更新时间

这有助于玩家更有效地规划采矿作业和工业处理设施。🏭

---

🛢️ 沉浸石油支持

IDS 还可以追踪来自沉浸石油数据的石油储层信息。🛢️🔥

追踪信息可能包括：

• 🧱 维度
• 🗺️ 储层区块
• 🛢️ 储层类型
• 💧 流体或资源类型
• 📊 剩余量
• 📈 容量或最大量
• ⚠️ 枯竭状态
• 👤 发现玩家
• 🕒 发现或更新时间

这对于规划抽油泵位置、油田、精炼链和长距离流体物流非常有用。🚧🛢️🏭

---

🗺️ 区块覆盖层

IDS 可以选择在旅行地图上绘制区块覆盖层。🧱🗺️

这些覆盖层有助于显示与已发现矿床或储层关联的确切区域。

适用于：

• 🏭 钻井布局规划
• ⛏️ 挖掘机放置
• 🛢️ 抽油泵放置
• 🚧 工业基地扩张
• 🌐 多人游戏资源协调
• 🧭 避免重复探索

如果同一个区块内同时存在矿物矿床和石油储层，IDS 会将两个条目分开保存。✅

---

🌐 多人游戏支持

IDS 采用服务器权威模式。💾🛡️

这意味着服务器控制着发现数据库，并向客户端发送有效条目。

根据配置，发现可以是：

• 👤 每个玩家私有的；
• 🏭 整个服务器共享的。

这使得 IDS 既适用于私人生存世界，也适用于大型工业多人游戏服务器。🌐⚙️

---

💻 命令

主命令：

/ids

可用的或计划中的子命令：

• 📋 /ids list
• ⛏️ /ids list ie
• 🛢️ /ids list ip
• 🧱 /ids list currentchunk
• 🔁 /ids resync
• 🧪 /ids scanheld
• 🗑️ /ids remove currentchunk
• 🧹 /ids clear mine
• 🛠️ /ids debug heldsample

根据服务器配置，某些命令可能需要管理员权限。🔐

---

⚙️ 配置

IDS 可以针对不同的游戏风格和服务器规则进行配置。🛠️

可能的配置选项包括：

• 👤 个人或全服发现共享
• ⛏️ 启用或禁用沉浸工程追踪
• 🛢️ 启用或禁用沉浸石油追踪
• 🧭 启用或禁用旅行地图路标
• 🧱 启用或禁用区块覆盖层
• 📊 显示或隐藏剩余百分比
• 🏷️ 自定义旅行地图分组名称
• 🎨 自定义覆盖层颜色
• 🔍 启用调试日志

这允许模组包创建者和服务器拥有者根据他们的游戏进度风格调整 IDS。📦⚙️

---

🏭 推荐用途

IDS 推荐用于：

• ⚙️ 沉浸工程世界
• 🛢️ 沉浸石油装置
• 🏭 工业模组包
• 🧭 旅行地图探索
• ⛏️ 以采矿为中心的生存世界
• 🌐 多人工程服务器
• 🚧 大型基地规划
• 🧪 岩心样本管理
• 📍 矿床测绘
• 🧱 基于区块的资源规划

---

🚫 IDS 不会做什么

IDS 不是一个透视模组。❌

IDS 不会：

• ❌ 扫描世界寻找隐藏矿石
• ❌ 揭示地形的方块
• ❌ 在没有有效样本数据的情况下定位资源
• ❌ 修改沉浸工程的矿床
• ❌ 修改沉浸石油的储层
• ❌ 创建虚假资源位置
• ❌ 取代旅行地图
• ❌ 取代沉浸工程或沉浸石油

IDS 仅记录和显示已合法发现的信息。✅

---

🧼 洁净室声明

沉浸式矿床扫描器是一个原创的洁净室实现。🧼

此模组不包含从以下项目复制的代码、纹理、标志、资源或文件：

• 矿物追踪器（Mineral Tracker）
• 制图（Cartography）
• 旅行地图（JourneyMap）
• 沉浸工程（Immersive Engineering）
• 沉浸石油（Immersive Petroleum）

IDS 仅通过正常运行期间暴露的公共行为、支持的 API 以及兼容的数据与必要的外部模组进行集成。🧩

---

🙏 鸣谢与归属

特别感谢 LordFokas，矿物追踪器 的创建者，感谢他最初提出的基于地图的矿物追踪的公开概念。IDS 不是一个直接的移植版本，也没有使用矿物追踪器的代码或资源。🧭

感谢 techbrew 和 旅行地图 项目为 IDS 提供了地图平台。🗺️

感谢 BluSunrize、Damien Hazard 以及 沉浸工程 团队制作了沉浸工程。⚙️

感谢 Flaxbeard、TwistedGate 以及 沉浸石油 团队制作了沉浸石油。🛢️

所有引用的模组均为其各自作者和团队所有。IDS 是一个非官方的附加模组，除非明确说明，否则与这些项目没有关联，也未得到它们的认可。📜

---

📌 简短摘要

追踪沉浸工程的矿物矿床和沉浸石油的石油储层，然后通过路标和区块覆盖层在旅行地图上显示它们。🧭⛏️🛢️

---

🧱 目标版本

• 🧱 Minecraft：1.21.1
• 🔧 加载器：NeoForge
• ☕ Java：21
• 🧭 必需：旅行地图
• ⚙️ 必需：沉浸工程
• 🛢️ 必需：沉浸石油

---

🏷️ 标签

JourneyMap Immersive Engineering Immersive Petroleum Core Sample Mineral Tracking Oil Reservoir NeoForge Industrial Mapping Exploration