AnhyShop: Transform Your Minecraft Server Economy with Custom Villager Trading
Running a Minecraft server means constantly looking for ways to keep players engaged, and a dynamic economy is one of the best tools you have. AnhyShop is a powerful plugin that reimagines how trading works, giving administrators complete control over custom merchants while preserving the familiar villager trading interface. Whether you want to create a blacksmith who exchanges rare ores for enchanted gear or a wandering trader with a fixed inventory, AnhyShop makes it intuitive and secure.
What Makes AnhyShop Stand Out
Unlike many economy plugins that rely on complex configuration files or external databases, AnhyShop stores all trader data automatically in an embedded SQLite database. This means no manual file editing is required for day-to-day operations. The plugin encrypts trader information, keeping your custom trades safe from tampering. It also integrates seamlessly with Spigot, Paper, and Purpur server cores, tested specifically on version 1.20.4.
One of the most appealing aspects is the plugin's multilingual potential. With the right dependencies, you can offer system messages and trader names in multiple languages, and even display trade items in a player's chosen language. This makes your server welcoming to a global community.
Essential Dependencies for Smooth Operation
Before diving into commands, it is important to understand what AnhyShop needs to run. The primary requirement is AnhyLibAPI version 1.5.2 or higher. This library handles translation of system messages and multilingual trader names. Without it, AnhyShop will not function. For expanded language features, you can also install AnhyLingo version 0.3.3 or higher. AnhyLingo enables multilingual item display within trades, but its absence does not break the core plugin.
Setting up AnhyShop is straightforward, and for those who prefer a streamlined experience, the plugin can be easily installed via the foxygame.net launcher — a convenient, flexible, and modern Minecraft launcher where you can download plugins right from the menu. This launcher simplifies the process of keeping your server tools up to date without hunting through multiple websites.
Administrator Commands: Full Control at Your Fingertips
AnhyShop provides a clean set of commands for server operators with the anhyshop.* permission. All commands are accessible from the console, making remote management a breeze.
Reloading and Basic Management
- /shop reload — Reloads language files, configurations, and all traders from the database. Requires anhyshop.reload.
- /shop list — Displays every trader currently stored. Requires anhyshop.trader.view.
Creating and Modifying Traders
- /shop newt <name> — Creates a new trader with a custom name. Requires anhyshop.trader.create.
- /shop delt <key> — Deletes a trader using its unique key. Requires anhyshop.trader.delete.
- /shop rename <key> <new_name> — Renames an existing trader. Requires anhyshop.trader.rename.
Opening Trades for Players
- /shop open <key> <player_name> — Forces a trade window to open for a specific player. Requires anhyshop.trader.open.
- /shop trade <key> — Opens a trade for yourself. Requires anhyshop.trader.trade.
Managing Trade Offers with Product Commands
Once a trader exists, you need to stock their inventory. AnhyShop uses a clever in-game method: you place the items you want to sell (and the price items) into your own hotbar slots 1, 2, and 3, then run a command. This visual approach eliminates guesswork.
- /shop add <key> — Adds a new trade using the items in your hotbar. Requires anhyshop.product.add.
- /shop replace <key> — Replaces an existing trade or adds a new one if the slot is empty. Requires anhyshop.product.replace.
- /shop remove <key> — Deletes a specific trade from the trader. Requires anhyshop.product.remove.
This system makes it incredibly easy to update offers on the fly, perfect for seasonal events or balancing the server economy.
Introducing Sellers: Interactive Trading Objects
Version 1.0.0 of AnhyShop introduced a groundbreaking feature called Sellers. Instead of only opening trades via commands, you can now link traders to physical objects in the world. Players simply interact with a button, sign, or even a named mob to open a trade window. This creates a much more immersive experience.
Types of Sellers
- Mechanical Objects: Buttons, doors, and levers identified by type and exact coordinates.
- Signs: Linked by material and the text on the sign. Identical signs in different locations will point to the same Seller.
- Mobs with Custom Names: Any mob given a unique name can become a Seller.
- Wandering Traders: All wandering traders are treated as one Seller, allowing you to standardize their offers.
- Villagers: Linked by profession and level. Changing a villager Seller overrides trades for all villagers of that type.
Seller Commands (Requires anhyshop.seller permission)
- /shop seller add <trader_key> — Creates a Seller from the object you are looking at, within 5 blocks.
- /shop seller remove <seller_id> — Deletes a Seller by its numerical ID.
- /shop seller view <seller_id> — Shows detailed info about a Seller, including type, location, and linked trader.
- /shop seller list — Lists all Sellers with copyable IDs for easy management.
This feature transforms static NPCs into dynamic shopkeepers, giving players a reason to explore and interact with the world you have built.
Multilingual Support for a Global Player Base
AnhyShop's language system is built on two pillars. AnhyLibAPI handles system messages and trader name translations through YAML files in the lang folder. You can add files like shop_XX.yml for messages and traders_XX.yml for names. The plugin comes with a set of default trader names such as Flint Firebeard, Mira Mysticsight, and Silas Silverthread, all of which can be localized.
When AnhyLingo is installed, the multilingual capability extends to the items themselves. If a trade involves an item with multiple language variants, the player sees the name in their own language. This makes trading feel natural and inclusive, no matter where your players come from.
Directory Structure and Data Security
All plugin data lives inside the AnhyShop folder. The lang subfolder contains translation files, while the embedded SQLite database (shops.db) stores encrypted trader information. This self-contained design means you can back up or migrate your entire trading setup by simply copying the plugin folder.
Why AnhyShop Is a Must-Have for Server Owners
AnhyShop combines ease of use with deep customization. You can set up a basic admin shop in minutes, then gradually expand into interactive Sellers that turn your server into a living marketplace. The command structure is logical and well-documented, and the multilingual features future-proof your server for an international audience. Whether you run a small survival world or a large minigame network, AnhyShop gives you the tools to craft a unique economic experience that keeps players coming back.