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

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

Minecraft Villager Trade Manager

Compatibility

Minecraft: Java Edition

Platforms

Links

Creators

Details

Minecraft Villager Trade Manager V12.0 - Complete Villager Economy Control

🎯 Key Features

🤖 AI-Powered Help System ⭐ NEW in V12

💰 Universal Trade Pricing

🚫 Item Banning System ⭐ NEW in V11

💾 Multi-Database Support ⭐ NEW in V11

⚡ Advanced Restock System

🎮 Multi-Platform Compatibility

📊 Real-Time Monitoring

📦 Installation

Requirements

Steps

⚙️ Configuration

Basic Configuration

Database Configuration

SQLite (Recommended)

Supabase (Cloud REST API)

PostgreSQL (Direct JDBC) ⭐ NEW in V11

🖥️ Commands

Main Commands

Trade Pricing

Item Banning ⭐ NEW in V11

Restock Management

Trade Analysis

Advanced Commands

💾 Database Options

SQLite (Default - Recommended)

Supabase (Cloud REST API)

PostgreSQL (Direct JDBC) ⭐ NEW in V11

🔧 Advanced Features

Item Banning System

Custom Pricing Examples

Performance Tuning

📊 Metrics & Monitoring

Health Checks

Prometheus Integration

🤝 Support

Getting Help

System Requirements

📈 Version History

V11.0 (Latest)

V10.x

📜 License

🙏 Credits

🧱 Technical Notes

🧭 Ideal Use Cases

🆕 V11.0 Highlights

🧾 License