VtTradeHUB

VtTradeHUB is a plugin that lets you create fully customizable NPC-based trades for both small and large servers, featuring a modern interface and detailed settings that give you complete control and the freedom to create more engaging and diverse trading experiences for your server.



Installation
Download the plugin .jar file to your computer.
Place the plugin file into your server’s plugins folder.
Start the server.
Enjoy the features!

Requirements
java 21 and Potato Hosting


Plugin Features

• NPC Shops: Create trading shops using in-game NPCs.
• GUI Shop Editor: Manage shops, trades, NPC settings, and equipment through menus.
• Custom Trades: Create trades with one or two required input items.
• Custom Item Support: Supports matching custom items with flexible comparison modes.
• Exact Item Matching: Requires the traded item to match full item data.
• Material Matching: Only checks the item material type.
• Smart Matching: Supports smarter matching for custom item setups.
• Match Flags: Ignore durability, NBT, enchantments, lore, or display name when matching items.
• Trade Result Items: Set any item as the trade reward/output.
• Per-Player Trade Limits: Limit how many times each player can use a trade.
• Server-Wide Trade Limits: Limit how many times a trade can be used globally.
• Trade Usage Tracking: Tracks trade usage per player and per server.
• Shop Open/Close Toggle: Enable or disable trading for each shop.
• NPC Name Display: Show, hide, or always display NPC shop names.
• NPC Equipment Editor: Configure armor and held items for shop NPCs.
• Mob Type Selection: Choose the NPC mob type used for a shop.
• Villager Options: Configure villager profession, biome type, level, and age.
• NPC Look Behavior: NPCs can look toward nearby players.
• Price Display Modes: Show discount or price increase displays for trades.
• Custom Stack Support: Supports item stack sizes above vanilla limits when configured.
  
• SQL Storage: YAML by default, with SQLite/MySQL-ready storage options.

Commands
/vttradehub create [name]: Create a new shop at your location.

/vttradehub manage: Open the shop manager GUI.

/vttradehub list: Open the shop manager GUI.

/vttradehub edit <id>: Open the editor for a shop.

/vttradehub delete <id>: Delete a shop.

/vttradehub tp <id>: Teleport to a shop.

/vttradehub open <id>: Enable trading for a shop.

/vttradehub close <id>: Disable trading for a shop.

/vttradehub reload: Reload shops and configuration.


Statistics




This plugin uses bStats to collect anonymous plugin usage statistics.

This helps me understand how many servers are using the plugin, which Minecraft versions it is used with, and which environments it is running on.

Currently tracked information:
Common information: server count, player count, online mode, Minecraft version, plugin version, core count, system architecture, operating system, server country, and Java version.
VtTradeHUB does not currently send custom feature charts. Only the default bStats plugin metrics are collected.

Support & Bug Reports


If you find a bug or experience any issue with the plugin, please contact me through Discord instead of using the review section. This helps me understand the problem faster, provide support more quickly, and keep the plugin improving without unnecessary negative impact on its development. Thank you very much!

Others

If you're looking for a custom plugin tailored to your needs, a professional plugin license management panel, or simply some useful tools to make managing and developing your Minecraft server easier, feel free to visit my website and explore what I have to offer!