Mineforgian
Find My Villager
Find My Villager is a client-side Minecraft mod for Fabric, Forge and NeoForge that remembers villager trades you have seen before, then lets you search your trading hall by item, enchantment, profession, price, name, and location.
- Загрузки
- 1K
- Подписчики
- 8
- Обновлён
- 16 мая 2026 г.
- Лицензия
- Earlystream-Source-Available-License-v1.0
Опубликован 24 апреля 2026 г.
Find My Villager
Ctrl+F for your trading hall.
Find any villager trade you've seen before, navigate straight to them, and never lose a good librarian again.
Find My Villager remembers trades after you open a villager or wandering trader trade screen. Later, press V to search through saved villagers by item, enchantment, profession, villager name, location, or saved trade details.
When you select a result, the mod points you back to that villager with a HUD compass and live distance readout. Once the villager is visible, they glow so you can find the correct one inside crowded trading halls.
No commands. No manual markers. No server install.
Just open villagers normally and the mod keeps track of them locally.
Need more details?
Read the FAQ for file names, privacy, multiplayer support, saved data, imports, backups, online sharing, and common questions.
What It Does
Trading halls get messy fast.
You might remember that you had a Mending librarian somewhere, but not which villager it was. You might have dozens of farmers, armorers, clerics, librarians, or wandering traders saved across different worlds and servers.
Find My Villager is made for that exact problem.
The mod does not change how villagers work. You still discover trades normally by opening trade screens. The mod simply remembers what you have already seen and gives you a clean way to search it later.
Features
- Search saved villagers by item, enchantment, profession, villager name, location, or saved trade data
- Target a specific trade and follow a HUD compass back to the right villager
- See a live distance readout while walking toward the target
- Glow highlight for the selected villager when visible
- Favorite important villagers so they appear first
- Add custom names to saved villagers
- View trade details, villager level progress, stock status, location, and last-seen info
- Export, import, back up, reset, and manage local databases
- Optional online sharing for selected villager data
- Works client-side without needing anything installed on the server
How To Use
- Open a villager or wandering trader trade screen.
- Press V to open Find My Villager.
- Search for an item, enchantment, profession, villager name, or location.
- Click the trade or villager you want to target.
- Follow the HUD compass.
- Look for the glow highlight when the villager is visible.
- Star important villagers as favorites if you want them easier to find later.
Data Manager
Find My Villager includes a Data Manager screen for saved databases.
You can export your current world or server database as JSON, import another database, create backups, view database stats, reset the current database, and safely merge imported data.
This is useful if you switch launchers, move worlds, test multiple Minecraft versions, or just want a backup before changing anything.
Client-Side & Local Data
Find My Villager is client-side only.
It does not automate trades, does not modify villager behavior, and does not require a server-side install.
For normal local use, saved data stays on your computer.
Saved data is currently stored locally in:
config/tradecompass/
World and server databases are currently stored under:
config/tradecompass/worlds/
The tradecompass folder name is kept for compatibility with older versions of the mod.
A future version may rename or migrate this folder to:
config/find-my-villager/
If that happens, the migration will aim to preserve existing saved data safely.
Online Sharing & Privacy
Find My Villager includes an optional online sharing feature.
Online sharing is disabled by default. Incoming share invites are also disabled by default.
Normal villager searching, favorites, compass targeting, glow highlighting, imports, exports, backups, and local database management work without the online relay.
Read the full privacy notice here:
When online sharing is used, the mod connects to the official relay server:
https://findmyvillagershare.earlystream.workers.dev
Supported Versions
| Minecraft | Fabric | Forge | NeoForge |
|---|---|---|---|
| 1.21.1 | Yes | Yes | Yes |
| 1.21.4 | Yes | Yes | Yes |
| 1.21.8 | Yes | Yes | Yes |
| 1.21.11 | Yes | Yes | Yes |
| 26.1 | Yes | No | No |
| 26.1.1 | Yes | Yes | Yes |
| 26.1.2 | Yes | Yes | Yes |
| 26.1.x | Yes | No | No |
Building
Build individual version folders with their Gradle wrapper, or use the root wrapper when the included builds are available.
| Loader | Source Folder |
|---|---|
| Fabric | versions/ |
| Forge | forgeversions/ |
| NeoForge | neoforge/ |
Built JARs are written to each version's:
build/libs/
Project Notes
Find My Villager was originally called Trade Compass.
Because of that, some older JAR names, folders, config paths, or internal names may still use:
tradecompass
This is normal and does not affect the mod.
The old folder name is currently kept for compatibility. A future version may migrate the config folder to find-my-villager if it can be done safely without breaking saved databases.
FAQ
Common questions are answered here:
License
Versions 0.4.0 and newer are licensed under the Earlystream Source-Available License v1.0.
This project is source-available for transparency, portfolio review, security review, compatibility review, and educational reading.
You may use official builds for personal gameplay. You may not reupload, redistribute, rename, publish modified builds, copy substantial source code, or create competing clones without written permission.
Older versions released under MPL-2.0 remain under MPL-2.0.
See:
LICENSE
Reuploads & Modpacks
Official downloads are only allowed from this Modrinth page, the official CurseForge page, the linked GitHub repository, or other locations explicitly approved by earlystream.
Reuploads, renamed copies, modified builds, mirrors, unofficial ports, and third-party redistribution are not allowed without written permission.
Modpacks may include Find My Villager only through official Modrinth or CurseForge dependency/download systems. Do not manually rehost the JAR in a modpack archive, launcher CDN, Discord server, file host, or third-party mirror without written permission.
Ченджлог
0.5.0+26.1.2Релиз26.1.2 · 16 мая 2026 г.
Changelog - Find My Villager v0.5.0
This update focuses on polishing the full mod experience after the Online Sharing release. It improves the UI, search quality, sharing flow, safety checks, and villager targeting behavior.
New Features
Natural Search Upgrade
Search now understands deeper natural queries across villagers, trades, costs, enchantments, stock, locations, job blocks, favorites, and partial words.Missing Villager Tracking
Missing or unloaded villagers are now separated from active results and marked clearly with warning indicators.Job Block Redirect Warnings
If a villager is missing, the HUD can point toward the villager’s job block and show its location and distance.Share Safety Check
Shared villager previews now include a Check Safety option that validates incoming share data before importing.
UI Improvements
Premium Glass UI Pass
Reworked the mod screens into a cleaner transparent glass style with better spacing, hierarchy, and readability.Data Manager Redesign
The Data page is now a proper action hub with clear sections for sharing, JSON transfer, backups, and reset actions.Improved Share Villagers Screen
Sharing now has clearer recipient selection, better status messages, cleaner footer layout, and more readable invite handling.Better Main Screen Layout
Improved search bar alignment, result cards, details panel spacing, favorite/pin controls, and compact screen behavior.Improved Icons
Updated favorite, pin, Clear All, player, logo, and saved villager visuals for a more consistent interface.
Improvements & Fixes
Smarter Result Ranking
Favorites, relevance, distance, stock state, and price now influence result ordering more naturally.Duplicate Villager Handling
Villagers with the same UUID now update existing saved entries instead of creating duplicate records.Smoother Scrolling
Search results and details lists now scroll more smoothly and avoid jumping back to the bottom.Better Sharing Notifications
Sender and receiver notifications now include clearer invite, acceptance, upload, decline, expiry, and failure states.More Reliable Compact Layouts
Fixed overlapping text/buttons across the main screen, Data Manager, JSON screens, Share screens, and modal previews.Cleaner Data Page Copy
Removed duplicate storage-root messaging and made status text only show useful operation feedback.
0.5.0+1.21.11Релиз1.21.11 · 16 мая 2026 г.
Changelog - Find My Villager v0.5.0
This update focuses on polishing the full mod experience after the Online Sharing release. It improves the UI, search quality, sharing flow, safety checks, and villager targeting behavior.
New Features
Natural Search Upgrade
Search now understands deeper natural queries across villagers, trades, costs, enchantments, stock, locations, job blocks, favorites, and partial words.Missing Villager Tracking
Missing or unloaded villagers are now separated from active results and marked clearly with warning indicators.Job Block Redirect Warnings
If a villager is missing, the HUD can point toward the villager’s job block and show its location and distance.Share Safety Check
Shared villager previews now include a Check Safety option that validates incoming share data before importing.
UI Improvements
Premium Glass UI Pass
Reworked the mod screens into a cleaner transparent glass style with better spacing, hierarchy, and readability.Data Manager Redesign
The Data page is now a proper action hub with clear sections for sharing, JSON transfer, backups, and reset actions.Improved Share Villagers Screen
Sharing now has clearer recipient selection, better status messages, cleaner footer layout, and more readable invite handling.Better Main Screen Layout
Improved search bar alignment, result cards, details panel spacing, favorite/pin controls, and compact screen behavior.Improved Icons
Updated favorite, pin, Clear All, player, logo, and saved villager visuals for a more consistent interface.
Improvements & Fixes
Smarter Result Ranking
Favorites, relevance, distance, stock state, and price now influence result ordering more naturally.Duplicate Villager Handling
Villagers with the same UUID now update existing saved entries instead of creating duplicate records.Smoother Scrolling
Search results and details lists now scroll more smoothly and avoid jumping back to the bottom.Better Sharing Notifications
Sender and receiver notifications now include clearer invite, acceptance, upload, decline, expiry, and failure states.More Reliable Compact Layouts
Fixed overlapping text/buttons across the main screen, Data Manager, JSON screens, Share screens, and modal previews.Cleaner Data Page Copy
Removed duplicate storage-root messaging and made status text only show useful operation feedback.
0.4.0+26.1Релиз26.1 · 9 мая 2026 г.
Changelog - Find My Villager v0.4.0
This major update introduces the Online Sharing System, allowing you to securely share your trading hall data directly with other players on your server without using manual codes.
New Features
Direct Player-to-Player Sharing
Send and receive villager databases directly through a secure, privacy-focused online relay.Background Lifecycle Management
The sharing process is now fully automated. Once you send an invite or click accept, the mod handles the data transfer in the background, allowing you to return to your game immediately.Rebindable Controls
The Open Find My Villager key is now a standard Minecraft keybind. You can rebind it to any key in:Options > Controls > Key Binds
Privacy-First Hashing Implemented SHA-256 scoped identity hashing. Your raw Minecraft UUID is never sent to the relay, helping keep your persistent identity and server history private.
Dynamic UI Feedback Added system toasts and overlay messages that track background uploads, downloads, and incoming invites.
Improvements & Fixes
Network Reliability Increased payload transfer timeouts to 30 seconds to support large trading halls, up to 512 KB, on slower connections.
Server Identity Normalization Fixed an issue where slight variations in server addresses, such as case differences, could prevent players from finding each other on the relay.
Protocol Synchronization Overhauled the Cloudflare Worker routing to support both legacy and modern sharing protocols at the same time.
Validation Hardening Every incoming share is now strictly validated for structural integrity before being presented for import.
Privacy & Disclosure
- Added a comprehensive Privacy Warning Screen and Privacy Notice that clearly disclose when data is uploaded and what specific information is shared.
- Online sharing is strictly opt-in and disabled by default.
0.4.0+1.21.1Релиз1.21.1 · 9 мая 2026 г.
Changelog - Find My Villager v0.4.0
This major update introduces the Online Sharing System, allowing you to securely share your trading hall data directly with other players on your server without using manual codes.
New Features
Direct Player-to-Player Sharing
Send and receive villager databases directly through a secure, privacy-focused online relay.Background Lifecycle Management
The sharing process is now fully automated. Once you send an invite or click accept, the mod handles the data transfer in the background, allowing you to return to your game immediately.Rebindable Controls
The Open Find My Villager key is now a standard Minecraft keybind. You can rebind it to any key in:Options > Controls > Key Binds
Privacy-First Hashing Implemented SHA-256 scoped identity hashing. Your raw Minecraft UUID is never sent to the relay, helping keep your persistent identity and server history private.
Dynamic UI Feedback Added system toasts and overlay messages that track background uploads, downloads, and incoming invites.
Improvements & Fixes
Network Reliability Increased payload transfer timeouts to 30 seconds to support large trading halls, up to 512 KB, on slower connections.
Server Identity Normalization Fixed an issue where slight variations in server addresses, such as case differences, could prevent players from finding each other on the relay.
Protocol Synchronization Overhauled the Cloudflare Worker routing to support both legacy and modern sharing protocols at the same time.
Validation Hardening Every incoming share is now strictly validated for structural integrity before being presented for import.
Privacy & Disclosure
- Added a comprehensive Privacy Warning Screen and Privacy Notice that clearly disclose when data is uploaded and what specific information is shared.
- Online sharing is strictly opt-in and disabled by default.
0.4.0+1.21.4Релиз1.21.4 · 9 мая 2026 г.
Changelog - Find My Villager v0.4.0
This major update introduces the Online Sharing System, allowing you to securely share your trading hall data directly with other players on your server without using manual codes.
New Features
Direct Player-to-Player Sharing
Send and receive villager databases directly through a secure, privacy-focused online relay.Background Lifecycle Management
The sharing process is now fully automated. Once you send an invite or click accept, the mod handles the data transfer in the background, allowing you to return to your game immediately.Rebindable Controls
The Open Find My Villager key is now a standard Minecraft keybind. You can rebind it to any key in:Options > Controls > Key Binds
Privacy-First Hashing Implemented SHA-256 scoped identity hashing. Your raw Minecraft UUID is never sent to the relay, helping keep your persistent identity and server history private.
Dynamic UI Feedback Added system toasts and overlay messages that track background uploads, downloads, and incoming invites.
Improvements & Fixes
Network Reliability Increased payload transfer timeouts to 30 seconds to support large trading halls, up to 512 KB, on slower connections.
Server Identity Normalization Fixed an issue where slight variations in server addresses, such as case differences, could prevent players from finding each other on the relay.
Protocol Synchronization Overhauled the Cloudflare Worker routing to support both legacy and modern sharing protocols at the same time.
Validation Hardening Every incoming share is now strictly validated for structural integrity before being presented for import.
Privacy & Disclosure
- Added a comprehensive Privacy Warning Screen and Privacy Notice that clearly disclose when data is uploaded and what specific information is shared.
- Online sharing is strictly opt-in and disabled by default.
0.4.0+1.21.8Релиз1.21.8 · 9 мая 2026 г.
Changelog - Find My Villager v0.4.0
This major update introduces the Online Sharing System, allowing you to securely share your trading hall data directly with other players on your server without using manual codes.
New Features
Direct Player-to-Player Sharing
Send and receive villager databases directly through a secure, privacy-focused online relay.Background Lifecycle Management
The sharing process is now fully automated. Once you send an invite or click accept, the mod handles the data transfer in the background, allowing you to return to your game immediately.Rebindable Controls
The Open Find My Villager key is now a standard Minecraft keybind. You can rebind it to any key in:Options > Controls > Key Binds
Privacy-First Hashing Implemented SHA-256 scoped identity hashing. Your raw Minecraft UUID is never sent to the relay, helping keep your persistent identity and server history private.
Dynamic UI Feedback Added system toasts and overlay messages that track background uploads, downloads, and incoming invites.
Improvements & Fixes
Network Reliability Increased payload transfer timeouts to 30 seconds to support large trading halls, up to 512 KB, on slower connections.
Server Identity Normalization Fixed an issue where slight variations in server addresses, such as case differences, could prevent players from finding each other on the relay.
Protocol Synchronization Overhauled the Cloudflare Worker routing to support both legacy and modern sharing protocols at the same time.
Validation Hardening Every incoming share is now strictly validated for structural integrity before being presented for import.
Privacy & Disclosure
- Added a comprehensive Privacy Warning Screen and Privacy Notice that clearly disclose when data is uploaded and what specific information is shared.
- Online sharing is strictly opt-in and disabled by default.
0.4.0+1.21.1-forgeРелиз1.21.1 · 6 мая 2026 г.
Changelog - Find My Villager v0.4.0
This major update introduces the Online Sharing System, allowing you to securely share your trading hall data directly with other players on your server without using manual codes.
New Features
Direct Player-to-Player Sharing
Send and receive villager databases directly through a secure, privacy-focused online relay.Background Lifecycle Management
The sharing process is now fully automated. Once you send an invite or click accept, the mod handles the data transfer in the background, allowing you to return to your game immediately.Rebindable Controls
The Open Find My Villager key is now a standard Minecraft keybind. You can rebind it to any key in:Options > Controls > Key Binds
Privacy-First Hashing Implemented SHA-256 scoped identity hashing. Your raw Minecraft UUID is never sent to the relay, helping keep your persistent identity and server history private.
Dynamic UI Feedback Added system toasts and overlay messages that track background uploads, downloads, and incoming invites.
Improvements & Fixes
Network Reliability Increased payload transfer timeouts to 30 seconds to support large trading halls, up to 512 KB, on slower connections.
Server Identity Normalization Fixed an issue where slight variations in server addresses, such as case differences, could prevent players from finding each other on the relay.
Protocol Synchronization Overhauled the Cloudflare Worker routing to support both legacy and modern sharing protocols at the same time.
Validation Hardening Every incoming share is now strictly validated for structural integrity before being presented for import.
Privacy & Disclosure
- Added a comprehensive Privacy Warning Screen and Privacy Notice that clearly disclose when data is uploaded and what specific information is shared.
- Online sharing is strictly opt-in and disabled by default.
0.4.0+1.21.4-forgeРелиз1.21.4 · 6 мая 2026 г.
Changelog - Find My Villager v0.4.0
This major update introduces the Online Sharing System, allowing you to securely share your trading hall data directly with other players on your server without using manual codes.
New Features
Direct Player-to-Player Sharing
Send and receive villager databases directly through a secure, privacy-focused online relay.Background Lifecycle Management
The sharing process is now fully automated. Once you send an invite or click accept, the mod handles the data transfer in the background, allowing you to return to your game immediately.Rebindable Controls
The Open Find My Villager key is now a standard Minecraft keybind. You can rebind it to any key in:Options > Controls > Key Binds
Privacy-First Hashing Implemented SHA-256 scoped identity hashing. Your raw Minecraft UUID is never sent to the relay, helping keep your persistent identity and server history private.
Dynamic UI Feedback Added system toasts and overlay messages that track background uploads, downloads, and incoming invites.
Improvements & Fixes
Network Reliability Increased payload transfer timeouts to 30 seconds to support large trading halls, up to 512 KB, on slower connections.
Server Identity Normalization Fixed an issue where slight variations in server addresses, such as case differences, could prevent players from finding each other on the relay.
Protocol Synchronization Overhauled the Cloudflare Worker routing to support both legacy and modern sharing protocols at the same time.
Validation Hardening Every incoming share is now strictly validated for structural integrity before being presented for import.
Privacy & Disclosure
- Added a comprehensive Privacy Warning Screen and Privacy Notice that clearly disclose when data is uploaded and what specific information is shared.
- Online sharing is strictly opt-in and disabled by default.
Комментарии
Загружаем…