TradeCycle
Villager trading is one of the most rewarding mechanics in Minecraft, but endlessly breaking and replacing a lectern to get the right enchanted book can drain your patience. TradeCycle changes that completely. This lightweight, multiplatform plugin gives you the power to cycle through a villager’s trades directly from the trading UI, making the hunt for Mending or Unbreaking III faster and far less tedious. Whether you run a small SMP or a large public server, TradeCycle brings a quality-of-life upgrade that your players will love.
What Exactly Does TradeCycle Do?
Inspired by henkelmax’s popular Trade Cycling mod, TradeCycle is a server-side plugin written in Kotlin that works across multiple platforms. Instead of forcing you to break and re-place job blocks, it lets you refresh a villager’s offers instantly. The plugin respects vanilla limitations: if a villager has no profession or has already been traded with, cycling is disabled to prevent exploits. This keeps the experience fair while removing the grind.
Key Features
TradeCycle offers two distinct methods to cycle trades, giving server owners and players flexibility:
- Keyboard shortcut (F key by default): While the trading UI is open and your cursor is inside your inventory, press the configured key to cycle the villager’s offers. This is the fastest method for Java Edition players.
- Shift + Right Click on the villager: This alternative method is designed with Bedrock Edition and Geyser compatibility in mind. It allows Bedrock players to cycle trades even though they can’t use the keyboard shortcut inside the UI. Note that this method is disabled by default and must be enabled in the config.
Both methods are seamless and require no commands in-game. Once configured, TradeCycle works silently in the background.
How to Install TradeCycle
Getting TradeCycle for Minecraft up and running is straightforward. Since it’s a server plugin, you’ll need a server running a compatible loader like Paper, Spigot, or any Bukkit-based platform. Simply download TradeCycle from its official repository and place the JAR file into your server’s plugins folder. Restart the server, and the plugin will generate a default configuration file. No client-side mods are required for Java players, and Bedrock users can benefit through Geyser integration.
If you’re managing a server through the foxygame.net launcher, adding TradeCycle is even simpler. The launcher’s built-in add-on catalog includes TradeCycle, so you can install it with a single click and receive automatic updates whenever a new version is released. This keeps your server compatible with the latest Minecraft builds without manual file replacements.
Configuration Options
TradeCycle’s config file is clean and easy to edit. You can choose which cycling strategies are active by editing the strategy section:
- KEYBOARD – Enables the hotkey method (default: F).
- SHIFT_INTERACT – Enables the shift-right-click method. To disable a method, simply add a
#in front of its name. For example, if you only want the keyboard method, leaveSHIFT_INTERACTcommented out.
The shift-interact strategy was specifically created for Bedrock players connecting via Geyser, but it does not work while the trading UI is open. Server admins can mix and match strategies to suit their player base. The config also allows you to change the keyboard key if F conflicts with other functions, though this requires a small edit in the source code.
Compatibility and Supported Versions
TradeCycle is built for modern Minecraft server software. It runs on Paper, Spigot, and other Bukkit derivatives, supporting versions from 1.16.5 up to the latest 1.20.x releases. Because it’s a plugin rather than a mod, it doesn’t require Fabric or Forge on the client side. Java players simply join the server and use the features immediately. For Bedrock players, pairing TradeCycle with Geyser ensures the shift-interact method works smoothly, bridging the gap between editions.
When you download TradeCycle, always grab the newest stable version unless a specific build is marked as unstable. The developer actively maintains the project, and contributions from the community—like special thanks to Tamikaschu—help keep it polished. If you encounter issues or have ideas, the project welcomes pull requests and bug reports.
Why Choose TradeCycle Over Other Methods?
Traditional trade cycling involves destroying and replacing job blocks, which wastes time and resources. Some mods offer similar functionality, but they require every player to install client-side mods and often break with game updates. TradeCycle solves both problems: it’s server-side, lightweight, and works out of the box for all players. The dual-method design also makes it one of the few trade cycling solutions that genuinely supports cross-play environments.
Server owners who value performance will appreciate that TradeCycle adds negligible overhead. It listens for specific inputs and only acts when a player is interacting with a villager, so it won’t affect tick rates or cause lag. The Kotlin codebase is efficient and well-structured, making it a reliable addition to any server setup.
Final Thoughts
TradeCycle transforms the villager trading experience from a chore into a smooth, enjoyable part of Minecraft gameplay. With easy installation, flexible configuration, and broad version support, it’s a must-have plugin for any server that wants to respect players’ time. Whether you’re a seasoned admin or just setting up your first Paper server, TradeCycle for Minecraft delivers immediate value. Download TradeCycle today and let your villagers offer their best deals without the grind.
--- **Update Jun 27, 2026:** Added 1 file for version 26.2, 26.1.2, 26.1.1, 26.1, 1.21.9, 1.21.8, 1.21.7, 1.21.6, 1.21.5, 1.21.4, 1.21.11, 1.21.10.