| Author | earlystream |
|---|---|
| Maintainers | earlystream |
| Stable Version | v0.4.0 Series |
| Loaders | Fabric, Forge, NeoForge |
| Environment | Client-side |
| Storage | config/find-my-villager/ |
| Sharing | Relay, Share Codes, JSON |
| License | Earlystream Source-Available v1.0 |
Find My Villager
Find My Villager is a client-side Minecraft mod that saves, searches, and locates villager trades you have already opened. It is built for trading halls, large villages, multiplayer bases, long-term worlds, and servers where players need a reliable way to remember which villager has which trade.
Turn villager trade management into a searchable local database without commands, markers, or server-side installation.
Find saved villagers by item, enchantment, profession, name, favorite status, and location details.
Share selected villager data through online invites, pasteable share codes, or JSON export/import.
All villager trades, locations, and statistics are stored securely in your local configuration folder. No mandatory server tracking.
Technical Features
The 0.4.0 series focuses on local data safety, multi-loader support, and optional sharing.
- Trade Capture: Saves visible villager and wandering trader offers when the trade screen is opened.
- Search Index: Searches saved trades by item name, enchantment, profession, name, favorite status, and location.
- Specific Trade Targeting: Targets the selected trade, not just the villager record.
- HUD Compass: Points toward the selected villager's last known location with a distance readout.
- Glow Highlight: Highlights the targeted villager when visible.
- Favorites: Marks important villagers for faster recall and sorting.
- Custom Names: Adds local names such as "Mending Librarian" or "Book Hall Row 3".
- Data Manager: Provides export, import, backup, stats, and reset tools.
- Safe Import: Validates imported JSON and creates recovery points where applicable.
- Cross-loader Builds: Supports Fabric, Forge, and NeoForge targets across multiple Minecraft versions.
Screenshots
Sharing & Collaboration
Find My Villager includes optional online sharing for selected villager data. Normal local search does not require the relay.
https://findmyvillagershare.earlystream.workers.dev
- The sender chooses what to share.
- The receiver must enable incoming invites.
- The payload is uploaded only after the receiver accepts.
- Raw Minecraft UUIDs are replaced with scoped hashes for relay routing.
| Method | Purpose | Relay Required |
|---|---|---|
| Online Invite | Live in-game sharing between two online players. | Yes |
| Copy / Paste Code | Manual transfer when invite delivery is unavailable. | No |
| Export / Import JSON | Backups, launcher migration, and long-term database copies. | No |
Data Storage
Newer versions (0.4.0 and later) store locally under config/find-my-villager/. World databases are stored under config/find-my-villager/worlds/.
If you updated from an older version, the mod automatically migrates existing saved data from the old config/tradecompass/ folder.
System Requirements
- Platform: Minecraft Java Edition
- Environment: Client-side (Server Install not required)
- Supported Loaders: Fabric, Forge, NeoForge
Downloads Matrix
Available artifacts grouped by mod version and loader. Use the specific loader string (e.g., -forge) based on your installation.
| Mod Version | Game Version | Fabric | Forge | NeoForge |
|---|---|---|---|---|
| Version 0.4.0 Series | ||||
| 0.4.0 | 26.1.2 | 0.4.0+26.1.2 3 days ago |
0.4.0+26.1.2-forge 3 days ago |
0.4.0+26.1.2-neoforge 2 days ago |
| 0.4.0 | 1.21.11 | 0.4.0+1.21.11 5 days ago |
0.4.0+1.21.11-forge 3 days ago |
0.4.0+1.21.11-neoforge 2 days ago |
| 0.4.0 | 1.21.8 | Unavailable | 0.4.0+1.21.8-forge 2 days ago |
0.4.0+1.21.8-neoforge 2 days ago |
| 0.4.0 | 1.21.4 | Unavailable | 0.4.0+1.21.4-forge 2 days ago |
0.4.0+1.21.4-neoforge 2 days ago |
| 0.4.0 | 1.21.1 | Unavailable | 0.4.0+1.21.1-forge 2 days ago |
0.4.0+1.21.1-neoforge 2 days ago |
| Version 0.3.0 Series | ||||
| 0.3.0 | 26.1.2 | 0.3.0+26.1.2 7 days ago |
0.3.0+26.1.2-forge 7 days ago |
0.3.0+26.1.2-neoforge 6 days ago |
| 0.3.0 | 26.1.1 | 0.3.0+26.1.1 7 days ago |
0.3.0+26.1.1-forge 7 days ago |
0.3.0+26.1.1-neoforge 6 days ago |
| 0.3.0 | 26.1 | 0.3.0+26.1 7 days ago |
Unavailable | Unavailable |
| 0.3.0 | 1.21.11 | 0.3.0+1.21.11 7 days ago |
0.3.0+1.21.11-forge 7 days ago |
0.3.0+1.21.11-neoforge 7 days ago |
| 0.3.0 | 1.21.8 | 0.3.0+1.21.8 7 days ago |
0.3.0+1.21.8-forge 7 days ago |
0.3.0+1.21.8-neoforge 6 days ago |
| 0.3.0 | 1.21.4 | 0.3.0+1.21.4 7 days ago |
0.3.0+1.21.4-forge 7 days ago |
0.3.0+1.21.4-neoforge 6 days ago |
| 0.3.0 | 1.21.1 | 0.3.0+1.21.1 7 days ago |
0.3.0+1.21.1-forge 7 days ago |
0.3.0+1.21.1-neoforge 7 days ago |
| Version 0.1.0 Series | ||||
| 0.1.0 | 26.1.2 | 0.1.0+26.1.2 Apr 30, 2026, 05:50 PM |
0.1.0+26.1.2 -forge Apr 30, 2026, 06:18 PM |
Unavailable |
| 0.1.0 | 26.1.1 | 0.1.0+26.1.1 Apr 30, 2026, 05:50 PM |
0.1.0+26.1.1 -forge Apr 30, 2026, 06:17 PM |
Unavailable |
| 0.1.0 | 26.1 | 0.1.0+26.1 Apr 30, 2026, 05:51 PM |
Unavailable | Unavailable |
| 0.1.0 | 1.21.11 | 0.1.0+1.21.11 Apr 30, 2026, 05:49 PM |
0.1.0+1.21.11 -forge Apr 30, 2026, 06:16 PM |
Unavailable |
| 0.1.0 | 1.21.8 | 0.1.0+1.21.8 Apr 30, 2026, 05:48 PM |
0.1.0+1.21.8 -forge Apr 30, 2026, 07:03 PM |
Unavailable |
| 0.1.0 | 1.21.4 | 0.1.0+1.21.4 Apr 30, 2026, 05:48 PM |
0.1.0+1.21.4 -forge Apr 30, 2026, 07:04 PM |
Unavailable |
| 0.1.0 | 1.21.1 | 0.1.0+1.21.1 Apr 30, 2026, 05:47 PM |
0.1.0+1.21.1 -forge Apr 30, 2026, 07:05 PM |
Unavailable |
Version History
v0.4.0 Series (May 2026)
- Added modern Find My Villager branding and storage migration to
config/find-my-villager/. - Expanded Data Manager with safer import, export, backup, stats, and reset tools.
- Added optional online sharing, invite flow, copy/paste share codes, and relay privacy controls.
- Added cross-loader ports for Fabric, Forge, and NeoForge.
- Improved UI behavior across older 1.21.x and newer 26.1.x targets.
v0.3.0 Series (April 2026)
- Implemented core HUD compass features and live 8-direction targeting readout.
- Added automatic Trade Capture upon opening villager trade screens.
- Introduced the local Search Index (query by item, enchantment, profession, name, favorite).
- Added basic Villager Detail Panel.
v0.1.0 (Early 2026)
- Initial release of the mod (previously known as Trade Compass).
- Basic trade saving functionality and local search established.
- Client-side infrastructure implemented for the Fabric loader.
Official Documents
Legal
Versions 0.4.0 and newer are licensed under the Earlystream Source-Available License v1.0. Official builds are for personal gameplay. Reuploads, mirrors, modified builds, unofficial ports, and redistribution require written permission.
View the Official License Document
Copyright © 2026 earlystream. All rights reserved.