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 listbanneditems to 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 on for 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 on for 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

1. Download the plugin JAR file
2. Stop your Minecraft server
3. Place Minecraft-Villager-Trade-Manager-11.0.jar in the plugins/ folder
4. Start your server to generate configuration files
5. Configure plugins/VillagerTradeManager/config.yml as needed
6. 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 —