Minecraft Villager Trade Manager V11.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.

🚀 Quick Start

# Install the plugin
1. Download Minecraft-Villager-Trade-Manager-11.0.jar
2. Place in your server's plugins/ folder
3. Restart server
4. Configure in config.yml
5. Use /vt status to verify

# Basic commands
/vt on                    # Enable trade management
/vt setprice armorer diamond_leggings 30  # Set custom price
/vt banitem diamond_sword # Ban items from trades

📋 Table of Contents

Features
Installation
Configuration
Commands
Database Setup
Advanced Features
Troubleshooting
Support

🎯 Key Features

💰 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)

Verification

# Check if plugin loaded
/version VillagerTradeManager

# Test basic functionality
/vt status

⚙️ 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`
`/vt reload`	Reload configuration (with caution)	`/vt reload`

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

# Universal format (advanced)
/vt setprice armorer armorer_l4_emerald_13_diamond_boots_1 15 20

# Legacy format (enchantments only)
/vt setprice efficiency 5 45

Database Migration

The plugin automatically handles database schema updates. When you update from older versions, the plugin will:

Detect version differences
Apply migrations automatically
Preserve existing data
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:

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

Documentation: Full guide at project repository
Issues: Report bugs on GitHub
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: Alan (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.

V11.0 brings universal trade control to Villager Trade Manager —
Every villager trade, every profession, fully customizable under your command.

Minecraft Villager Trade Manager

Compatibility

Minecraft: Java Edition

Platforms

Links

Creators

Details

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

🚀 Quick Start

📋 Table of Contents

🎯 Key Features

💰 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

Verification

⚙️ 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

Database Migration

🔧 Troubleshooting

Common Issues

Plugin Not Loading

Database Connection Failed

Commands Not Working

High CPU Usage

Debug Mode

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