道具寻找器

道具寻找器

一个用于快速定位附近容器中物品并提供视觉引导的模组。

🔍 物品查找器

再也不会找不到你的物品了。 物品查找器让你可以在附近所有存储容器中搜索任意物品:按下一个按键,选择物品,模组就会告诉你它确切的位置,在世界中高亮显示,并用粒子轨迹为你指引方向。


📸 截图

搜索界面 按一次键即可打开搜索界面,游戏在后台继续运行

物品网格 输入“stone”,即可看到 93 个匹配物品的图标。点击其中一个进行扫描,或按回车立即搜索

高亮与粒子轨迹 找到的容器发出黄色光芒。粒子流向它们。HUD 显示每个容器的名称和距离

配置面板 一切都可以在游戏内配置,无需编辑配置文件


🎬 工作原理

  1. 按 Y 打开搜索界面
  2. 输入关键词,匹配物品的网格会立即出现
  3. 点击一个物品以扫描该确切物品,或按回车无需使用鼠标即可搜索,或按“扫描全部匹配”来查找所有包含该关键词物品的容器
  4. 结果显示在 GUI 中,也可选择显示在聊天栏中
  5. 匹配的容器会在世界中发出黄色光芒
  6. 粒子轨迹从你流向每个容器
  7. 打开一个高亮的容器,它会自动从列表中清除

✨ 功能

🔎 智能搜索

两种搜索模式:

  • 精确选择:从可视化网格中点击一个物品图标以进行精确匹配
  • 扫描全部匹配:按关键词一次性搜索所有容器,当你只记得部分名称时非常完美(输入 oak 可一次性找到橡木原木、木板和台阶)

回车键快捷方式:可配置按下回车时的行为:

  • 关闭:回车不做任何事,正常使用鼠标
  • 选择第一个结果:无需点击即可立即扫描网格中最顶部的物品
  • 扫描全部匹配:立即对所有容器执行关键词扫描

搜索语言切换:按英文物品 ID 或你的游戏显示语言进行搜索

📦 支持所有存储类型

容器 ✅
箱子 ✅
陷阱箱 ✅
木桶 ✅
潜影盒 ✅
末影箱 ✅
熔炉 ✅
烟熏炉 ✅
高炉 ✅
漏斗 ✅
发射器 ✅
投掷器 ✅
运输矿车 ✅
运输船 ✅

🟡 容器高亮

  • 匹配的容器会在世界中获得发光的黄色轮廓
  • 脉冲动画(可切换)
  • 在可配置的持续时间后自动淡出

✨ 粒子轨迹

  • 粒子从你的位置流向每个找到的容器
  • 最近的容器会获得更强、更亮的轨迹
  • 8 种粒子类型:火焰 · 附魔 · 末地烛 · 灵魂火 · 女巫 · 龙息 · 传送门 · 快乐村民

📋 HUD 叠加层

  • 高亮激活时,右上角的面板显示容器名称和距离
  • 显示结果是来自服务器(实时)还是缓存(本地)
  • 高亮过期后自动消失

💾 本地缓存(无需服务器模组的多人游戏)

当在未在服务器端安装该模组的服务器上游玩时,物品查找器会回退到本地缓存:

  • 你打开的每个容器,其内容都会保存在本地
  • 缓存是持久的,几周前的数据仍会被记住
  • 每个服务器都有自己独立的缓存文件
  • 结果显示数据的新旧程度(例如 3d ago),以便你了解其新鲜度
  • 当结果来自缓存时,始终会显示警告

⚙️ 配置

在搜索界面中按 ⚙ 配置,或通过 Mod Menu 访问。

设置 描述 默认值
扫描半径 搜索多少格远 50
高亮持续时间 光芒保持的时间(秒) 10
高亮脉冲 为轮廓添加动画 开
排序方式 最近优先或物品最多优先 最近
发送到聊天栏 在聊天栏中打印结果 开
粒子轨迹 显示通往容器的粒子路径 开
粒子类型 使用哪种粒子效果 END ROD
搜索语言 英文 ID 或游戏显示语言 英文
回车键 按下回车的作用:关闭 / 选择第一个 / 扫描全部 选择第一个结果

关闭配置面板时,所有设置会自动保存。


⌨️ 键盘控制

操作 默认按键
打开物品查找器 Y
搜索 / 确认 回车(可配置行为)
返回 / 关闭 ESC

在 选项 → 控制 → 按键绑定 → 物品查找器 中更改打开按键。


🎮 手柄支持

物品查找器可通过 Controllify(需单独安装)支持手柄。

安装 Controllify 后,在其设置中映射以下内容:

操作 建议按键
打开物品查找器 Y(Xbox)/ 三角(PlayStation)
确认 / 回车 A(Xbox)/ 叉(PlayStation)
返回 / 关闭 B(Xbox)/ 圆圈(PlayStation)

提示:在物品查找器配置中将回车键设置为“选择第一个结果”或“扫描全部匹配”,这样你就可以完全不用鼠标进行搜索,只需打开、输入,然后在手柄上按确认即可。


🖥️ 服务器支持

场景 是否可用? 模式
单人游戏 ✅ 实时扫描
对局域网开放(你是主机) ✅ 实时扫描
服务器有模组 + 你的客户端有模组 ✅ 实时扫描
服务器无模组 + 你的客户端有模组 ✅ 缓存模式
你的客户端没有模组 ❌ —

致服务器所有者:将模组 .jar 安装到服务器的 mods/ 文件夹中。同样拥有该模组的玩家将获得实时准确的结果。没有该模组的玩家完全不受影响。

缓存模式说明:只有你亲自打开过的容器才可被搜索。如果其他人在你上次访问后更改了内容,数据可能会过时。当结果来自缓存时,始终会显示警告。


📥 安装

  1. 为你的 Minecraft 版本安装 Fabric Loader
  2. 下载 Fabric API 并将其放入你的 mods/ 文件夹
  3. 下载物品查找器(从版本选项卡中选择与你的 Minecraft 版本匹配的文件)并将其放入 mods/
  4. 使用 Fabric 配置文件启动 Minecraft

可选但推荐:

支持的 Minecraft 版本和所需的 Fabric Loader 版本列在版本选项卡中。


🌐 语言

已完整翻译为 15 种语言,自动跟随你的 Minecraft 语言设置。

英语 · 印度尼西亚语 · 马来语 · 简体中文 · 德语 · 日语 · 葡萄牙语(巴西)· 俄语 · 西班牙语 · 法语 · 意大利语 · 韩语 · 荷兰语 · 波兰语 · 土耳其语

在 选项 → 语言 中更改。


⚠️ 已知限制

  • 在缓存模式下,只有你亲自打开过的容器才可被搜索
  • 如果其他玩家更改了容器内容,缓存数据可能会过时
  • 你物品栏中的潜影盒不会被扫描——只有放置在世界中的才会
  • 末影箱只显示你自己的物品
  • 你已加载区块半径之外的容器无法被检测到

📜 许可证

本项目基于 MIT 许可证授权。

你可以自由使用、修改本项目并将其包含在整合包中。 署名将不胜感激。


🐛 问题与反馈

发现错误或有建议?在 GitHub 上提交问题。 请包含你的 Minecraft 版本、模组版本以及重现步骤。