Unlocking Dynamic Trading in Minecraft with CitiTraders
Imagine walking through your Minecraft village and being able to buy diamond swords from the local blacksmith NPC, or selling your surplus wheat to a farmer without typing a single command. CitiTraders makes this possible by transforming ordinary Citizens 2 NPCs into fully functional traders that buy and sell goods using a clean inventory interface. Whether you run a survival server, a roleplay world, or an economy-driven town, this plugin adds a layer of immersion that players instantly appreciate.
What Exactly is CitiTraders?
CitiTraders is a server-side plugin that hooks into the popular Citizens 2 API, allowing you to assign trading behaviors to any NPC you create. Instead of relying on sign shops or complex command menus, all buying and selling happens through the familiar inventory GUI. This makes transactions feel natural and accessible even for players who are new to modded servers. The plugin supports both admin shops — where stock never depletes — and player-run shops, giving server owners incredible flexibility.
The current iteration is CitiTraders 2, a major rewrite that fixes numerous holdover errors from the original version. The maintainer is actively addressing performance issues and refining the buy/sell mechanics to be more reliable. You can track progress through the CitiTraders Wiki and the project's JIRA issue tracker, where bugs and feature requests are logged.
Setting Up Your First Trader NPC
Creating a trader is straightforward if you already have Citizens 2 and Vault installed. Start by spawning an NPC with the Citizens commands, then assign the trader trait. Once configured, the NPC will respond to player interactions with dedicated buy and sell windows. Here’s a quick setup overview:
- Create an NPC using
/npc create TraderName. - Apply the trader trait with
/trait trader. - Open the trader configuration by right-clicking the NPC while holding a book.
- Add items you want the NPC to sell or buy in the configuration inventory.
- Set prices and adjust limits through the trader’s profile (more on that later).
How Players Interact with Traders
The interaction model is designed to be intuitive and command-free. A right-click on the NPC opens the selling window, where players see the items the NPC offers for sale. Hovering over an item displays its price. A left-click on that item brings up the final purchase screen, where a right-click buys a single item and a left-click buys the whole stack. For selling items to the NPC, a left-click on the NPC opens the buy window; players simply drag and drop their goods into the inventory slots. If the NPC cannot purchase certain items (for example, due to insufficient funds or a full inventory), those items will be dropped back to the player. Future updates aim to prevent invalid items from being placed in the first place.
Stocking the Shelves: Adding Items to Sell
Restocking a trader is flexible. Right-click the NPC with a book in your hand to open the stock inventory. Place the items you want the NPC to sell here. For admin shops, the items are never consumed — you still need to place a full stack (64 or the item’s maximum stack size) to show a complete listing in the sales window, but the stock never decreases. For player shops, each sale removes the corresponding item from the stock, so you’ll need to refill periodically.
Linked Chests for Effortless Restocking
If you prefer a more automated approach, CitiTraders supports linked chests. By connecting a chest to a trader NPC, you can simply fill that chest with the items you want to sell, and the trader will draw from it automatically. This is perfect for large-scale shops or for players who want to manage their inventory without opening the trader’s configuration every time. Linking is done through a simple command, and the chest acts as the trader’s personal warehouse.
Commands and Permissions at a Glance
While players need no commands to trade, admins and shop owners have a handful of useful commands to manage traders. The permissions system in CitiTraders 2 is granular, allowing you to control who can create traders, set prices, or bypass limits. Key commands include:
/trader create— Assign the trader trait to the selected NPC./trader linkchest— Link the nearest chest to the NPC for automatic restocking./trader setprice [buy|sell] [amount]— Define the price of an item in hand./trader limits— View or modify transaction limits for the trader.
Permissions are documented on the CitiTraders Wiki, with nodes like cititraders.admin for full control and cititraders.use for basic interaction. The plugin also integrates with zPermissions and any Vault-compatible permission system.
Limits and Profiles: Fine-Tuning Your Economy
To prevent inflation or abuse, CitiTraders lets you set per-trader limits and global profiles. You can cap how many items a player can buy per day, restrict trades to certain items, or define a maximum amount of currency an NPC can hold. These profiles are defined in configuration files and can be assigned to individual traders or entire groups, giving you precise control over your server’s economy balance.
Installation and Requirements
Getting CitiTraders running on your server is a simple process. Just drop the plugin JAR into your server’s plugins folder and restart. The essential dependencies are Citizens 2 and Vault, along with an economy plugin like BOSEconomy. For permissions, zPermissions or any Vault-compatible system works. Optionally, Towny can be integrated for town-based shop restrictions. For players who enjoy modded gameplay on the client side, managing add-ons can sometimes be a chore, but using a launcher like the one available at foxygame.net makes the experience far smoother; it offers a modern, flexible interface where you can download and install mods directly from the menu, ensuring everything stays up to date without manual hassle.
Development Builds and What’s Next
The recommended stable build for production servers is RC-5, but adventurous admins can grab the latest development build from the Jenkins continuous integration server. These builds contain the newest fixes and experimental features, though they may be less stable. The roadmap for CitiTraders 2 includes shop managers and assistants, a rewritten sell-to-player routine for better performance and easier stack buying, and further polish on the inventory validation to prevent invalid drops.
Bringing Your Server Economy to Life
CitiTraders bridges the gap between static NPCs and a vibrant, player-driven marketplace. By turning any Citizens 2 NPC into a trader, you add depth to towns, adventure maps, and survival servers alike. The inventory-based interface removes the learning curve, while linked chests and admin shops cater to both casual and complex economic setups. With active development and a clear focus on fixing legacy issues, CitiTraders remains a top choice for server owners who want immersive, command-free trading. Give it a try, and watch your Minecraft world become a bustling hub of commerce.