# Minecraft Villager Trade Manager V12.0 – Complete Villager Economy Control<\/p>\n
\n
\n
\n
\n
\n
\n<\/p>\n
**Ultimate Minecraft villager trade management plugin** – Control every aspect of villager trading economics with advanced features like item banning, custom pricing, and multi-database support.<\/p>\n
—<\/p>\n
—<\/p>\n
## \ud83c\udfaf Key Features
\n– **AI Assistant**: In-game help powered by Groq
\n### \ud83e\udd16 **AI-Powered Help System** \u2b50 *NEW in V12*
\n– **Interactive AI Assistant**: `\/vtrade help askquestion “How do I ban diamond items?”`
\n– **Smart Q&A**: Natural language questions about plugin features
\n– **Knowledge Base**: Comprehensive built-in help system
\n– **Groq API Integration**: Advanced AI responses with plugin context
\n– **Context-Aware**: Understands your server’s specific configuration
\n– **24\/7 Support**: Instant answers without leaving the game
\n– **Plugin Expertise**: Specialized knowledge about villager trade mechanics<\/p>\n
**Example AI Interactions:**
\n“`
\n\/vtrade help askquestion “How do I set up custom prices for armorers?”
\n\/vtrade help askquestion “What items should I ban to prevent economy exploits?”
\n\/vtrade help askquestion “How does the villager leveling system work?”
\n“`
\n### \ud83d\udcb0 **Universal Trade Pricing**
\n– **All 13 Professions Supported**: Armorer, Butcher, Cartographer, Cleric, Farmer, Fisherman, Fletcher, Leatherworker, Librarian, Mason, Shepherd, Toolsmith, Weaponsmith
\n– **Per-Trade Customization**: Set emerald costs for any specific trade
\n– **Simple Commands**: `\/vt setprice armorer diamond_leggings 30`
\n– **Legacy Support**: Maintains backward compatibility<\/p>\n
### \ud83d\udeab **Item Banning System** \u2b50 *NEW in V11*
\n– **Complete Item Control**: Ban entire items from all villager trades
\n– **Smart Filtering**: Prevents enchanted variants when base item is banned
\n– **Easy Management**: `\/vt banitem diamond_sword`, `\/vt unbanitem diamond_sword`
\n– **List Banned Items**: `\/vt listbanneditems` to see all banned items<\/p>\n
### \ud83d\udcbe **Multi-Database Support** \u2b50 *NEW in V11*
\n– **SQLite**: Local file-based (default, recommended)
\n– **Supabase**: Cloud REST API
\n– **PostgreSQL**: Direct JDBC connections \u2b50 *NEW*
\n– **Automatic Fallback**: SQLite backup if cloud fails<\/p>\n
### \u26a1 **Advanced Restock System** ### \ud83c\udfae **Multi-Platform Compatibility** ### \ud83d\udcca **Real-Time Monitoring** —<\/p>\n ## \ud83d\udce6 Installation<\/p>\n ### Requirements ### Steps —<\/p>\n ## \u2699\ufe0f Configuration<\/p>\n ### Basic Configuration # Database selection # Restock settings ### Database Configuration<\/p>\n #### SQLite (Recommended) #### Supabase (Cloud REST API) #### PostgreSQL (Direct JDBC) \u2b50 *NEW in V11* —<\/p>\n ## \ud83d\udda5\ufe0f Commands<\/p>\n ### Main Commands ### Item Banning \u2b50 *NEW in V11* ### Restock Management ### Trade Analysis ### Advanced Commands —<\/p>\n ## \ud83d\udcbe Database Options<\/p>\n ### SQLite (Default – Recommended) ### Supabase (Cloud REST API) ### PostgreSQL (Direct JDBC) \u2b50 *NEW in V11* —<\/p>\n ## \ud83d\udd27 Advanced Features<\/p>\n ### Item Banning System “`bash # Ban enchanted golden apples # Check what’s banned # Allow items again ### Custom Pricing Examples ### Database Migration 1. **Detect version differences** —<\/p>\n ## \ud83d\udd27 Troubleshooting<\/p>\n ### Common Issues<\/p>\n #### Plugin Not Loading #### Database Connection Failed #### Commands Not Working #### High CPU Usage ### Debug Mode ### Performance Tuning —<\/p>\n ## \ud83d\udcca Metrics & Monitoring<\/p>\n ### Health Checks ### Prometheus Integration —<\/p>\n ## \ud83e\udd1d Support<\/p>\n ### Getting Help ### System Requirements —<\/p>\n ## \ud83d\udcc8 Version History<\/p>\n ### V11.0 (Latest) ### V10.x —<\/p>\n ## \ud83d\udcdc License<\/p>\n **MIT License** – Free for personal and commercial use.<\/p>\n —<\/p>\n ## \ud83d\ude4f Credits<\/p>\n – **Developer**: AlanTheDev (Villager Trade Manager Team) —<\/p>\n **\ud83c\udfae Ready to master your server’s villager economy? Install Villager Trade Manager V11.0 today!**<\/p>\n —<\/p>\n ## \ud83e\uddf1 Technical Notes —<\/p>\n ## \ud83e\udded Ideal Use Cases —<\/p>\n ## \ud83c\udd95 V11.0 Highlights —<\/p>\n ## \ud83e\uddfe License —<\/p>\n **V12.0 brings universal trade control to Villager Trade Manager \u2014<\/p>\n","protected":false},"excerpt":{"rendered":" Complete control over villager trading economics with custom pricing and discount prevention<\/p>\n Minecraft Villager Trade Manager is a comprehensive Paper\/Spigot plugin that gives server administrators complete control over villager trading economics. Take co<\/p>\n","protected":false},"featured_media":102156,"template":"","meta":{"_minecraft_slug":"minecraft-villager-trade-manager","_minecraft_project_id":"8oLCKGgM","_minecraft_author":"AlanTheDev","_minecraft_license":"MIT","_minecraft_downloads":1320,"_minecraft_follows":9,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"minecraft-villager-trade-manager.zip","_minecraft_size_bytes":98135530,"_minecraft_version_count":14,"_minecraft_updated_at":"2026-05-16T07:38:14.795841Z","_minecraft_date_created":"2025-09-27T03:32:22.088126Z","_minecraft_date_modified":"2026-01-30T19:23:49.494018Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/minecraft-villager-trade-manager","_minecraft_icon_attachment_id":102156,"_minecraft_imported_at":"2026-06-05T20:52:20+00:00","_minecraft_import_hash":"18c168034ee0bf4f0bbee5a9983834f2","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,125,89,126,137,90,127,128,129,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-102155","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-mobs","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– **Instant Restock**: `\/vt instantrestock on` for immediate trade refresh
\n– **Custom Intervals**: Set restock times with `\/vt restocktime
\n– **Daily Limits**: Control restocks per day with `\/vt restocklimit
\n– **Unlimited Mode**: `\/vt unlimitedrestock on` for no restrictions<\/p>\n
\n– **Folia**: Region-threaded scheduling for optimal performance
\n– **Paper\/Purpur**: Full API compatibility
\n– **Spigot\/Bukkit**: Legacy support maintained
\n– **Thread-Safe**: All operations are concurrency-safe<\/p>\n
\n– **Trade Analytics**: Track trade statistics and patterns
\n– **Performance Metrics**: Monitor plugin performance
\n– **Health Checks**: Built-in system monitoring
\n– **Dynamic Detection**: Automatically discovers new trades<\/p>\n
\n– **Java 17** or higher
\n– **Minecraft Server**: Paper, Spigot, Purpur, Bukkit, or Folia
\n– **Minecraft Version**: 1.20.x – 1.21.x<\/p>\n
\n1. **Download** the plugin JAR file
\n2. **Stop** your Minecraft server
\n3. **Place** `Minecraft-Villager-Trade-Manager-11.0.jar` in the `plugins\/` folder
\n4. **Start** your server to generate configuration files
\n5. **Configure** `plugins\/VillagerTradeManager\/config.yml` as needed
\n6. **Restart** server or use `\/reload` (not recommended for production)<\/p>\n
\n“`yaml
\n# Enable\/disable the plugin
\nsettings:
\n trade_management_enabled: true<\/p>\n
\ndatabase:
\n type: “sqlite” # Options: sqlite, supabase, postgresql<\/p>\n
\ncustom_restock_enabled: false
\nrestock_interval_minutes: 30
\nrestock_limit_per_day: 3
\nunlimited_restock: false
\ninstant_restock_enabled: false
\n“`<\/p>\n
\n“`yaml
\ndatabase:
\n type: “sqlite”
\n sqlite:
\n file: “villager_data.db”
\n“`<\/p>\n
\n“`yaml
\ndatabase:
\n type: “supabase”
\n supabase:
\n url: “https:\/\/your-project.supabase.co”
\n apiKey: “your-anon-key”
\n serviceKey: “your-service-key”
\n schema: “public”
\n“`<\/p>\n
\n“`yaml
\ndatabase:
\n type: “postgresql”
\n postgresql:
\n connectionString: “postgresql:\/\/user:password@host:5432\/database”
\n“`<\/p>\n
\n| Command | Description | Example |
\n|———|————-|———|
\n| `\/vt on\/off` | Enable\/disable trade management | `\/vt on` |
\n| `\/vt status` | Show current settings and banned items | `\/vt status` |
\n### Trade Pricing
\n| Command | Description | Example |
\n|———|————-|———|
\n| `\/vt setprice
\n| `\/vt resetprice
\n| `\/vt listtrades
\n| Command | Description | Example |
\n|———|————-|———|
\n| `\/vt banitem
\n| `\/vt unbanitem
\n| `\/vt listbanneditems` | Show all banned items | `\/vt listbanneditems` |<\/p>\n
\n| Command | Description | Example |
\n|———|————-|———|
\n| `\/vt restock on\/off` | Enable custom restock system | `\/vt restock on` |
\n| `\/vt restocktime
\n| `\/vt restocklimit
\n| `\/vt unlimitedrestock on\/off` | Toggle unlimited restocks | `\/vt unlimitedrestock on` |
\n| `\/vt instantrestock on\/off` | Enable instant restock | `\/vt instantrestock on` |<\/p>\n
\n| Command | Description | Example |
\n|———|————-|———|
\n| `\/vt analyzetrades` | Show trade statistics | `\/vt analyzetrades` |
\n| `\/vt inspectvillager` | Analyze nearest villager’s trades | `\/vt inspectvillager` |<\/p>\n
\n| Command | Description | Example |
\n|———|————-|———|
\n| `\/vt exporttrades json\/yaml` | Export trade configuration | `\/vt exporttrades json` |
\n| `\/vt tradedetection on\/off\/status` | Control dynamic trade detection | `\/vt tradedetection status` |
\n| `\/vt cleardynamictrades` | Clear old dynamic trade data | `\/vt cleardynamictrades` |<\/p>\n
\n– **Local file-based** database
\n– **Zero configuration** required
\n– **Best performance** for most servers
\n– **Automatic backups** and maintenance<\/p>\n
\n– **Cloud-hosted** PostgreSQL
\n– **REST API** communication
\n– **Multi-server sync** capability
\n– **Requires API keys** and internet connection<\/p>\n
\n– **Direct database connection** using JDBC
\n– **Best performance** for cloud databases
\n– **Compatible with** Supabase, AWS RDS, Google Cloud SQL
\n– **Requires connection string** configuration<\/p>\n
\nPrevent entire items from appearing in villager trades:<\/p>\n
\n# Ban diamond swords (prevents all enchanted variants too)
\n\/vt banitem diamond_sword<\/p>\n
\n\/vt banitem enchanted_golden_apple<\/p>\n
\n\/vt listbanneditems<\/p>\n
\n\/vt unbanitem diamond_sword
\n“`<\/p>\n
\n“`bash
\n# Simple format (recommended)
\n\/vt setprice armorer diamond_leggings 25
\n\/vt setprice librarian protection_4 30
\n\/vt setprice farmer emerald 2<\/p>\n
\nThe plugin automatically handles database schema updates. When you update from older versions, the plugin will:<\/p>\n
\n2. **Apply migrations automatically**
\n3. **Preserve existing data**
\n4. **Log migration progress**<\/p>\n
\n“`
\nError: Could not load plugin
\n“`
\n**Solution**: Ensure Java 17+ and compatible Minecraft version<\/p>\n
\n“`
\nFailed to establish database connection
\n“`
\n**Solutions**:
\n– Check database credentials
\n– Verify network connectivity (for cloud databases)
\n– Plugin automatically falls back to SQLite<\/p>\n
\n“`
\n\/vt: Unknown command
\n“`
\n**Solution**: Check console for permission errors or plugin conflicts<\/p>\n
\n**Solutions**:
\n– Reduce `trade_monitor_frequency` in config
\n– Decrease `villager_scan_radius`
\n– Enable Folia for better performance<\/p>\n
\nEnable debugging in `config.yml`:
\n“`yaml
\nlogging:
\n debug_database: true
\n debug_trades: true
\n debug_restock: true
\n“`<\/p>\n
\n“`yaml
\nperformance:
\n trade_monitor_frequency: 60 # Ticks between checks
\n villager_scan_radius: 32 # Blocks to scan
\n“`<\/p>\n
\n– **HTTP Endpoint**: `http:\/\/localhost:8080\/health` (if enabled)
\n– **Automatic Monitoring**: System health checks every 30 seconds
\n– **Performance Metrics**: CPU, memory, and trade statistics<\/p>\n
\nEnable Prometheus metrics in `config.yml`:
\n“`yaml
\nmetrics:
\n enabled: true
\n prometheus:
\n enabled: true
\n“`<\/p>\n
\n– **Community**: Join Discord for support<\/p>\n
\n– **RAM**: +50MB (depending on trade volume)
\n– **CPU**: Minimal overhead
\n– **Storage**: ~1MB for SQLite database
\n– **Network**: Required for cloud databases only<\/p>\n
\n– \u2705 **Item Banning System**: Ban entire items from villager trades
\n– \u2705 **PostgreSQL Support**: Direct JDBC connections to databases
\n– \u2705 **Enhanced Commands**: Improved tab completion and error messages
\n– \u2705 **Bug Fixes**: Resolved Supabase URL construction and authentication issues
\n– \u2705 **Performance**: Optimized database operations and memory usage<\/p>\n
\n– Universal trade pricing for all professions
\n– Folia compatibility and region-threaded scheduling
\n– Advanced restock system with instant restock
\n– Dynamic trade detection and storage<\/p>\n
\n– **Contributors**: Minecraft server administrators and developers
\n– **Community**: SpigotMC, PaperMC, and Minecraft communities<\/p>\n
\n– Tested on Minecraft **1.20.x \u2013 1.21.x**
\n– Supported server types: **Folia, Paper, Purpur, Spigot, Bukkit**
\n– Async SQLite database persistence for settings and restock data
\n– Thread-safe and region-threaded scheduling for Folia
\n– Minimal CPU and memory overhead<\/p>\n
\n– Economy-focused servers maintaining fair villager trading systems.
\n– Fast-paced gameplay or event servers requiring instant trade resets.
\n– Large-scale Folia servers needing safe, concurrent villager management.<\/p>\n
\n– **Universal Trade Manipulation**: Control pricing for all 13 villager professions
\n– **Per-Trade Customization**: Set custom emerald costs for any specific trade
\n– **Comprehensive Trade Registry**: Complete mapping of all vanilla Minecraft trades
\n– **Content-Based Identification**: Reliable trade identification using item hashing
\n– **Legacy Compatibility**: Maintains backward compatibility with enchantment pricing
\n– **Enhanced Command System**: Universal commands supporting all professions
\n– **Fixed Compilation Issues**: Resolved API compatibility problems with current Minecraft versions<\/p>\n
\nThis plugin is open-source and licensed under the **MIT License**.
\nYou are free to use, modify, and distribute with proper credit.<\/p>\n