Villager Trade
Lets you spawn custom villagers with custom trade options
About this Mod
Villager Tradings
Custom trading villagers with configurable multi-item recipes for Fabric and NeoForge.
Features
- Spawn persistent custom villagers with
/villager spawn <name> <outcome_item> <required_items...>. - Multi-input trades (3 inputs per row in UI), custom trade screen with themed background.
- Default settings for invulnerability and freeze; toggles via
/villager settings. - Persistent trade and villager data across dimensions.
Commands
/villager spawn <name> <outcome_item> <required_items...>— create a trader. Example:/villager spawn bookseller minecraft:enchanted_book:1 minecraft:paper:16 minecraft:emerald:2./villager delete <name>— remove a trader./villager find <name>— locate a trader and get a teleport suggestion./villager list [page]— list tracked traders./villager settings invulnerable <true|false> [villager]— set default or specific villager invulnerability./villager settings freeze <true|false> [villager]— set default or specific villager AI/freeze.
Permission: villager_tradings.command.villager (Fabric Permissions API v0/v1 if present), otherwise OP level 3.
Usage Tips
- Required items are space-separated
<item>:<count>tokens; use namespaces (e.g.,minecraft:emerald:3). - Trades consume all listed inputs; the in-game UI always reflects the full input list even if the merchant offer uses the first two slots.
- Custom villagers are tracked/persisted; when they die, their trades are cleaned up.
Building
./gradlew build
Artifacts for Fabric and NeoForge are produced under each subproject’s build/libs with the villager_tradings prefix.
Available Versions
How to Install Villager Trade on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.11).
Install Mod
Open the mod browser in the dashboard and search for "Villager Trade". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.11, 1.21.10, 1.21.9 (+8 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Villager Trade server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.11). You can switch loaders with one click in the panel.
Is Villager Trade compatible with fabric and neoforge?
Villager Trade officially supports fabric, neoforge for Minecraft 1.21.11, 1.21.10, 1.21.9. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Villager Trade – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Villager Trade consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Rent Modded Server
Install Villager Trade with just one click on your server.