/
Minecraft Villager Trade Manager V12.0 - Complete Villager Economy Control
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.
🎯 Key Features
- AI Assistant: In-game help powered by Groq
🤖 AI-Powered Help System ⭐ NEW in V12
- Interactive AI Assistant:
/vtrade help askquestion "How do I ban diamond items?" - Smart Q&A: Natural language questions about plugin features
- Knowledge Base: Comprehensive built-in help system
- Groq API Integration: Advanced AI responses with plugin context
- Context-Aware: Understands your server's specific configuration
- 24/7 Support: Instant answers without leaving the game
- Plugin Expertise: Specialized knowledge about villager trade mechanics
Example AI Interactions:
/vtrade help askquestion "How do I set up custom prices for armorers?"
/vtrade help askquestion "What items should I ban to prevent economy exploits?"
/vtrade help askquestion "How does the villager leveling system work?"
💰 Universal Trade Pricing
- All 13 Professions Supported: Armorer, Butcher, Cartographer, Cleric, Farmer, Fisherman, Fletcher, Leatherworker, Librarian, Mason, Shepherd, Toolsmith, Weaponsmith
- Per-Trade Customization: Set emerald costs for any specific trade
- Simple Commands:
/vt setprice armorer diamond_leggings 30 - Legacy Support: Maintains backward compatibility
🚫 Item Banning System ⭐ NEW in V11
- Complete Item Control: Ban entire items from all villager trades
- Smart Filtering: Prevents enchanted variants when base item is banned
- Easy Management:
/vt banitem diamond_sword,/vt unbanitem diamond_sword - List Banned Items:
/vt listbanneditemsto see all banned items
💾 Multi-Database Support ⭐ NEW in V11
- SQLite: Local file-based (default, recommended)
- Supabase: Cloud REST API
- PostgreSQL: Direct JDBC connections ⭐ NEW
- Automatic Fallback: SQLite backup if cloud fails
⚡ Advanced Restock System
- Instant Restock:
/vt instantrestock onfor immediate trade refresh - Custom Intervals: Set restock times with
/vt restocktime <minutes> - Daily Limits: Control restocks per day with
/vt restocklimit <count> - Unlimited Mode:
/vt unlimitedrestock onfor no restrictions
🎮 Multi-Platform Compatibility
- Folia: Region-threaded scheduling for optimal performance
- Paper/Purpur: Full API compatibility
- Spigot/Bukkit: Legacy support maintained
- Thread-Safe: All operations are concurrency-safe
📊 Real-Time Monitoring
- Trade Analytics: Track trade statistics and patterns
- Performance Metrics: Monitor plugin performance
- Health Checks: Built-in system monitoring
- Dynamic Detection: Automatically discovers new trades
📦 Installation
Requirements
- Java 17 or higher
- Minecraft Server: Paper, Spigot, Purpur, Bukkit, or Folia
- Minecraft Version: 1.20.x - 1.21.x
Steps
- Download the plugin JAR file
- Stop your Minecraft server
- Place
Minecraft-Villager-Trade-Manager-11.0.jarin theplugins/folder - Start your server to generate configuration files
- Configure
plugins/VillagerTradeManager/config.ymlas needed - Restart server or use
/reload(not recommended for production)
⚙️ Configuration
Basic Configuration
# Enable/disable the plugin
settings:
trade_management_enabled: true
# Database selection
database:
type: "sqlite" # Options: sqlite, supabase, postgresql
# Restock settings
custom_restock_enabled: false
restock_interval_minutes: 30
restock_limit_per_day: 3
unlimited_restock: false
instant_restock_enabled: false
Database Configuration
SQLite (Recommended)
database:
type: "sqlite"
sqlite:
file: "villager_data.db"
Supabase (Cloud REST API)
database:
type: "supabase"
supabase:
url: "https://your-project.supabase.co"
apiKey: "your-anon-key"
serviceKey: "your-service-key"
schema: "public"
PostgreSQL (Direct JDBC) ⭐ NEW in V11
database:
type: "postgresql"
postgresql:
connectionString: "postgresql://user:password@host:5432/database"
🖥️ Commands
Main Commands
| Command | Description | Example |
|---|---|---|
/vt on/off | Enable/disable trade management | /vt on |
/vt status | Show current settings and banned items | /vt status |
Trade Pricing
| Command | Description | Example |
|---|---|---|
/vt setprice <profession> <item> <cost> | Set custom price for any trade | /vt setprice armorer diamond_leggings 30 |
/vt resetprice <profession> <trade> | Reset trade to default price | /vt resetprice armorer armorer_l4_emerald_13_diamond_boots_1 |
/vt listtrades <profession> | List all trades for a profession | /vt listtrades armorer |
Item Banning ⭐ NEW in V11
| Command | Description | Example |
|---|---|---|
/vt banitem <item> | Ban item from all villager trades | /vt banitem diamond_sword |
/vt unbanitem <item> | Allow item in villager trades | /vt unbanitem diamond_sword |
/vt listbanneditems | Show all banned items | /vt listbanneditems |
Restock Management
| Command | Description | Example |
|---|---|---|
/vt restock on/off | Enable custom restock system | /vt restock on |
/vt restocktime <minutes> | Set restock interval | /vt restocktime 45 |
/vt restocklimit <count> | Set daily restock limit | /vt restocklimit 5 |
/vt unlimitedrestock on/off | Toggle unlimited restocks | /vt unlimitedrestock on |
/vt instantrestock on/off | Enable instant restock | /vt instantrestock on |
Trade Analysis
| Command | Description | Example |
|---|---|---|
/vt analyzetrades | Show trade statistics | /vt analyzetrades |
/vt inspectvillager | Analyze nearest villager's trades | /vt inspectvillager |
Advanced Commands
| Command | Description | Example |
|---|---|---|
/vt exporttrades json/yaml | Export trade configuration | /vt exporttrades json |
/vt tradedetection on/off/status | Control dynamic trade detection | /vt tradedetection status |
/vt cleardynamictrades | Clear old dynamic trade data | /vt cleardynamictrades |
💾 Database Options
SQLite (Default - Recommended)
- Local file-based database
- Zero configuration required
- Best performance for most servers
- Automatic backups and maintenance
Supabase (Cloud REST API)
- Cloud-hosted PostgreSQL
- REST API communication
- Multi-server sync capability
- Requires API keys and internet connection
PostgreSQL (Direct JDBC) ⭐ NEW in V11
- Direct database connection using JDBC
- Best performance for cloud databases
- Compatible with Supabase, AWS RDS, Google Cloud SQL
- Requires connection string configuration
🔧 Advanced Features
Item Banning System
Prevent entire items from appearing in villager trades:
# Ban diamond swords (prevents all enchanted variants too)
/vt banitem diamond_sword
# Ban enchanted golden apples
/vt banitem enchanted_golden_apple
# Check what's banned
/vt listbanneditems
# Allow items again
/vt unbanitem diamond_sword
Custom Pricing Examples
# Simple format (recommended)
/vt setprice armorer diamond_leggings 25
/vt setprice librarian protection_4 30
/vt setprice farmer emerald 2
### Database Migration
The plugin automatically handles database schema updates. When you update from older versions, the plugin will:
1. **Detect version differences**
2. **Apply migrations automatically**
3. **Preserve existing data**
4. **Log migration progress**
---
## 🔧 Troubleshooting
### Common Issues
#### Plugin Not Loading
Error: Could not load plugin
**Solution**: Ensure Java 17+ and compatible Minecraft version
#### Database Connection Failed
Failed to establish database connection
**Solutions**:
- Check database credentials
- Verify network connectivity (for cloud databases)
- Plugin automatically falls back to SQLite
#### Commands Not Working
/vt: Unknown command
**Solution**: Check console for permission errors or plugin conflicts
#### High CPU Usage
**Solutions**:
- Reduce `trade_monitor_frequency` in config
- Decrease `villager_scan_radius`
- Enable Folia for better performance
### Debug Mode
Enable debugging in `config.yml`:
```yaml
logging:
debug_database: true
debug_trades: true
debug_restock: true
Performance Tuning
performance:
trade_monitor_frequency: 60 # Ticks between checks
villager_scan_radius: 32 # Blocks to scan
📊 Metrics & Monitoring
Health Checks
- HTTP Endpoint:
http://localhost:8080/health(if enabled) - Automatic Monitoring: System health checks every 30 seconds
- Performance Metrics: CPU, memory, and trade statistics
Prometheus Integration
Enable Prometheus metrics in config.yml:
metrics:
enabled: true
prometheus:
enabled: true
🤝 Support
Getting Help
- Community: Join Discord for support
System Requirements
- RAM: +50MB (depending on trade volume)
- CPU: Minimal overhead
- Storage: ~1MB for SQLite database
- Network: Required for cloud databases only
📈 Version History
V11.0 (Latest)
- ✅ Item Banning System: Ban entire items from villager trades
- ✅ PostgreSQL Support: Direct JDBC connections to databases
- ✅ Enhanced Commands: Improved tab completion and error messages
- ✅ Bug Fixes: Resolved Supabase URL construction and authentication issues
- ✅ Performance: Optimized database operations and memory usage
V10.x
- Universal trade pricing for all professions
- Folia compatibility and region-threaded scheduling
- Advanced restock system with instant restock
- Dynamic trade detection and storage
📜 License
MIT License - Free for personal and commercial use.
🙏 Credits
- Developer: AlanTheDev (Villager Trade Manager Team)
- Contributors: Minecraft server administrators and developers
- Community: SpigotMC, PaperMC, and Minecraft communities
🎮 Ready to master your server's villager economy? Install Villager Trade Manager V11.0 today!
🧱 Technical Notes
- Tested on Minecraft 1.20.x – 1.21.x
- Supported server types: Folia, Paper, Purpur, Spigot, Bukkit
- Async SQLite database persistence for settings and restock data
- Thread-safe and region-threaded scheduling for Folia
- Minimal CPU and memory overhead
🧭 Ideal Use Cases
- Economy-focused servers maintaining fair villager trading systems.
- Fast-paced gameplay or event servers requiring instant trade resets.
- Large-scale Folia servers needing safe, concurrent villager management.
🆕 V11.0 Highlights
- Universal Trade Manipulation: Control pricing for all 13 villager professions
- Per-Trade Customization: Set custom emerald costs for any specific trade
- Comprehensive Trade Registry: Complete mapping of all vanilla Minecraft trades
- Content-Based Identification: Reliable trade identification using item hashing
- Legacy Compatibility: Maintains backward compatibility with enchantment pricing
- Enhanced Command System: Universal commands supporting all professions
- Fixed Compilation Issues: Resolved API compatibility problems with current Minecraft versions
🧾 License
This plugin is open-source and licensed under the MIT License. You are free to use, modify, and distribute with proper credit.
**V12.0 brings universal trade control to Villager Trade Manager —
