Find My Villager

<img

src=”https://cdn.modrinth.com/data/cached_images/2df5ae65196aa7a4a0aef20e208c0005ff06471f.png”
alt=”Modrinth profile”
style=”image-rendering: pixelated;”
/>

<img

src=”https://cdn.modrinth.com/data/cached_images/14bb5f6380dbf0e9a0bc20179ef4d9728b0f88d9.png”
alt=”GitHub profile”
style=”image-rendering: pixelated;”
/>

Find My Villager

按 Ctrl+F，快速找到你的交易大厅。
查找任何曾见过的村民交易，直接导航到村民身边，再也不会弄丢好用的图书管理员。

打开村民或流浪商人的交易界面后，Find My Villager 会记住他们的交易。之后，按 V 即可按物品、附魔、职业、村民名称、位置或已保存的交易详情搜索已记录的村民。

选中搜索结果后，模组会通过 HUD 指南针和实时距离显示，指引你找到对应的村民。村民进入视野后会发光，方便你在拥挤的交易大厅里认出正确的那位。

无需命令，无需手动标记，也无需在服务器安装。
只需像平常一样打开村民的交易界面，模组就会在本地记录他们的信息。

想了解更多详情？

请阅读常见问题，了解文件名称、隐私、多人游戏支持、已保存数据、导入、备份、在线分享和常见疑问。

---

功能介绍

交易大厅很快就会变得杂乱起来。

你可能记得某处有一位拥有经验修补交易的图书管理员，却想不起是哪位村民。你可能在不同的世界和服务器中记录了几十位农民、盔甲匠、牧师、图书管理员或流浪商人。

Find My Villager 正是为了解决这个问题而制作的。

模组不会改变村民的行为。你仍然像平常一样打开交易界面来查看交易。模组只是帮你记住已经见过的交易，并提供简洁的搜索方式，方便日后查找。

---

功能

• 按物品、附魔、职业、村民名称、位置或已保存的交易数据搜索村民
• 指定某项交易，并跟随 HUD 指南针找到对应村民
• 前往目标时查看实时距离
• 选中的村民进入视野时会发光高亮
• 将重要村民设为收藏，让他们优先显示
• 为已保存的村民添加自定义名称
• 查看交易详情、村民等级进度、库存状态、位置和最近出现时间
• 导出、导入、备份、重置和管理本地数据库
• 可选择在线分享指定村民数据
• 纯客户端运行，无需在服务器安装任何内容

---

使用方法

1. 打开村民或流浪商人的交易界面。
2. 按 V 打开 Find My Villager。
3. 搜索物品、附魔、职业、村民名称或位置。
4. 点击要定位的交易或村民。
5. 跟随 HUD 指南针前往目标。
6. 村民进入视野后，留意发光高亮。
7. 将重要村民标记为收藏，方便以后查找。

---

数据管理器

Find My Villager 为已保存的数据库提供了数据管理器界面。

你可以将当前世界或服务器的数据库导出为 JSON、导入其他数据库、创建备份、查看数据库统计信息、重置当前数据库，并安全合并导入的数据。

如果你更换启动器、迁移世界、测试多个 Minecraft 版本，或者只是在修改前想备份数据，这些功能都会很实用。

---

客户端与本地数据

Find My Villager 是纯客户端模组。

它不会自动进行交易，不会修改村民行为，也不需要在服务器端安装。

正常本地使用时，已保存的数据会保留在你的电脑上。

已保存的数据目前存放在：

config/tradecompass/

世界和服务器数据库目前存储在：

config/tradecompass/worlds/

出于与旧版本模组的兼容性考虑，tradecompass文件夹名称仍会保留。

未来版本可能会将此文件夹重命名或迁移至：

config/find-my-villager/

如进行迁移，我们会尽力安全地保留现有存档数据。

---

在线分享与隐私

Find My Villager 提供可选的在线分享功能。

在线分享默认关闭。接收分享邀请也默认关闭。

普通的村民搜索、收藏、指南针定位、发光高亮、导入、导出、备份和本地数据库管理功能，无需在线中继服务器即可使用。

请在此阅读完整的隐私声明：

在线分享隐私声明

使用在线分享时，模组会连接至官方中继服务器：

https://findmyvillagershare.earlystream.workers.dev

---

支持的版本

| Minecraft 版本 | Fabric | Forge | NeoForge |
| ——— | :—-: | :—: | :——: |
| 1.21.1 | 是 | 是 | 是 |
| 1.21.4 | 是 | 是 | 是 |
| 1.21.8 | 是 | 是 | 是 |
| 1.21.11 | 是 | 是 | 是 |
| 26.1 | 是 | 否 | 否 |
| 26.1.1 | 是 | 是 | 是 |
| 26.1.2 | 是 | 是 | 是 |
| 26.1.x | 是 | 否 | 否 |

---

构建

请使用各版本文件夹中的 Gradle wrapper 单独构建，或在包含的构建项目可用时使用根目录下的 wrapper。

| 加载器 | 源码文件夹 |
| —— | ————- |
| Fabric | versions/ |
| Forge | forgeversions/ |
| NeoForge | neoforge/ |

构建好的 JAR 文件会写入各版本对应的：

build/libs/

---

项目说明

Find My Villager 最初名为 Trade Compass。

因此，部分旧版 JAR 文件名、文件夹、配置路径或内部名称中仍可能使用：

tradecompass

这是正常现象，不会影响模组。

目前，旧文件夹名称仍会保留以确保兼容性。未来版本可能会将配置文件夹迁移至 find-my-villager，前提是能安全迁移且不会破坏已保存的数据库。

---

常见问题

常见问题解答请见此处：

查看常见问题

---

许可证

0.4.0 及更高版本采用Earlystream Source-Available License v1.0授权。

本项目提供源代码，供用户了解项目、作品集审阅、安全审查、兼容性审查及学习参考。

你可以使用官方构建版本进行个人游戏。未经书面许可，不得重新上传、再分发、重命名、发布修改版构建、复制大量源代码或制作竞争性克隆项目。

以 MPL-2.0许可证发布的旧版本仍遵循 MPL-2.0许可证。

另请参阅：

LICENSE

---

重新上传与整合包

仅允许从此 Modrinth 页面、官方 CurseForge 页面、关联的 GitHub 仓库，或 earlystream 明确批准的其他渠道下载官方版本。

未经书面许可，不得重新上传、发布重命名副本或修改版构建、建立镜像、制作非官方移植版或通过第三方渠道再分发。

整合包只能通过 Modrinth 或 CurseForge 官方的依赖项／下载系统收录 Find My Villager。未经书面许可，请勿在整合包压缩包、启动器 CDN、Discord 服务器、文件托管平台或第三方镜像中手动托管 JAR 文件。