Logo
MINECRAFTBIBLE
Items
Items

All game items

Blocks
Blocks

Building blocks

Mobs
Mobs

Creatures & monsters

Biomes
Biomes

World biomes

Structures
Structures

Generated structures

Recipes
Recipes

Crafting guides

Advancements
Advancements

Achievements

Loot Tables
Loot Tables

Drop rates

Tags
Tags

Item groupings

All Versions
View all data →
Capes
Cape ArchiveNEW

Browse rare Minecon capes, OptiFine capes, and custom capes from players worldwide

Browse

Player Database
Player DatabasePopular

Search any player

Skin Browser
Skin Browser

Browse & download skins

Cape Gallery
Cape GalleryNEW

Minecon & OptiFine capes

Seed Vault
Seed Vault

Curated seeds

Learn

Guides
GuidesNew

Tutorials & tips

Blog
Blog

News & updates

Community

Community Hub
Community HubHub

Posts, discussions & more

All Versions
View community →
Seed Analyzer
Seed Analyzer

World seed analysis

Loot Explorer
Loot Explorer

Drop rates

Crafting Calculator
Crafting Calculator

Material planning

Enchant Calculator
Enchant Calculator

Probability math

Redstone Lab
Redstone Lab

Signal timing

Trading Profit
Trading Profit

Villager ROI

All Versions
View all tools →
Mods
Mods

Browse all mods

Plugins
Plugins

Server plugins

Resource Packs
Resource Packs

Textures & sounds

Shaders
Shaders

Visual enhancements

Datapacks
Datapacks

World logic

Scanner
Mod Intelligence

Scan & analyze any mod

All Versions
View all mods →
Loading...
IntroductionIntroductionVersion HistoryVersion HistoryGuidesGuidesBlog & NewsBlog & News
ItemsItemsBlocksBlocksMobsMobsRecipesRecipesBiomesBiomesStructuresStructuresAdvancementsAdvancementsLoot TablesLoot TablesTagsTags
ModsModsPluginsPluginsResource PacksResource PacksShadersShadersDatapacksDatapacks

MinecraftBible

The Ultimate Wiki

Logo
MINECRAFTBIBLE

The ultimate Minecraft reference. Every item, block, mob, and recipe documented with precision.

Community

  • Player Database
  • Skin Browser
  • Cape Gallery
  • Community Hub
  • Seed Vault

Database

  • Items
  • Blocks
  • Mobs
  • Recipes
  • Biomes
  • Structures

Tools

  • Seed Analyzer
  • Mod Intelligence
  • Crafting Calculator
  • Enchant Calculator

Mods & Packs

  • Mods
  • Plugins
  • Resource Packs
  • Shaders
  • Datapacks

© 2026 MinecraftBible. Not affiliated with Mojang or Microsoft.

PrivacyTermsContact
Minecraft Villager Trade Manager
PluginMIT

Minecraft Villager Trade Manager

Complete control over villager trading economics with custom pricing and discount prevention Minecraft Villager Trade Manager is a comprehensive Paper/Spigot plugin that gives server administrators complete control over villager trading economics. Take co

812
Downloads
7
Followers
6 months ago
Updated
📦
14
Versions
economygame-mechanicsmobsbukkitfoliapaperpurpurspigot
Download Latestv12.2View on Modrinth

📖About Minecraft Villager Trade Manager

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

Paper
Spigot
Purpur
Bukkit
Folia
License: MIT
Java 21+

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 —

👥 Team & Contributors

AlanTheDev
AlanTheDevOwner

⚙️ Compatibility

Environment
🖥️ Server-side
Loaders
bukkitfoliapaperpurpurspigot
Minecraft Versions
1.201.20.11.20.21.20.31.20.41.20.51.20.61.21+11 more

🔗 Links

Modrinth Page