| Author | earlystream |
|---|---|
| Maintainers | earlystream |
| Stable Version | v0.5.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.5.0 series focuses on improved search, UI polish, safer sharing previews, and the newest Fabric targets. The 0.4.0 series remains available across Fabric, Forge, and NeoForge backports.
- 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. Version 0.5.0 is currently listed for Fabric builds; 0.4.0 remains the cross-loader line.
| Mod Version | Game Version | Fabric | Forge | NeoForge |
|---|---|---|---|---|
| Version 0.5.0 Series | ||||
| 0.5.0 | 26.1.2 | 0.5.0+26.1.2 1 minute ago |
Unavailable | Unavailable |
| 0.5.0 | 1.21.11 | 0.5.0+1.21.11 15 minutes ago |
Unavailable | Unavailable |
| 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 | 0.4.0+1.21.8 2 days ago |
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 | 0.4.0+1.21.4 2 days ago |
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 | 0.4.0+1.21.1 2 days ago |
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.5.0 Series (May 2026)
- Refined the premium glass interface across search, data management, JSON transfer, sharing, invite, preview, and warning screens.
- Upgraded natural search across villager identity, trade outputs and costs, enchantments, stock state, prices, coordinates, job blocks, favorites, partial terms, and light typos.
- Added clearer Active and Missing villager flows, including job block location warnings and distance-aware targeting when a saved villager cannot be found.
- Improved sharing notifications, sender confirmation, receiver preview safety checks, and validation feedback for incoming share payloads.
- Published Fabric builds for Minecraft 1.21.11 and 26.1.2.
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.