# Villager Cycle<\/p>\n
\n
\n
\n<\/p>\n
A Quality of Life mod for Minecraft Fabric that adds a button to villager trading screens, allowing you to refresh their trades before making any purchases.<\/p>\n
## Features<\/p>\n
– **Cycle Trades Button**: Customizable button above the villager trading GUI
\n– **Draggable Button Position**: Reposition the button via drag screen
\n– **Real-Time Updates**: Trade offers refresh instantly without closing the GUI
\n– **Keybind Support**: Keyboard and mouse button bindings for all mod functions
\n– **Configurable Cycle Limits**: Set limits on how many times trades can be cycled (per villager)
\n– **Wandering Trader Support**: Optional feature (operator-controlled on servers)
\n– **Smart Validation**: Only works on valid villagers (must have profession, not traded with)
\n– **Server-Side Security**: All validation happens server-side
\n– **Anti-Exploit Protection**: Clears trade input slots to prevent item duplication<\/p>\n
## Installation<\/p>\n
1. Download from Releases
\n2. Place `.jar` in your `.minecraft\/mods` folder
\n3. Required: **Fabric API** (version matched to your MC version)
\n4. Recommended: **Cloth Config** 20.0.149+ (enhanced config UI, not available for MC 26.1)
\n5. Recommended: **ModMenu** 16.0.0+ (in-game config access)
\n6. Launch Minecraft with Fabric Loader 0.18.4+<\/p>\n
## How to Use<\/p>\n
1. Open a villager’s trading interface
\n2. Click the “Cycle Trades” button (or use the keybind)
\n3. The villager’s Level 1 trades will regenerate with new offers<\/p>\n
## Configuration<\/p>\n
### Config File Location
\n– **Windows**: `%appdata%.minecraftconfigvillagercycle.json`
\n– **macOS**: `~\/Library\/Application Support\/minecraft\/config\/villagercycle.json`
\n– **Linux**: `~\/.minecraft\/config\/villagercycle.json`<\/p>\n
### Options<\/p>\n
“`json
\n{
\n “enableCycleButton”: true,
\n “allowWanderingTraders”: false,
\n “showSuccessMessage”: true,
\n “showWanderingTraderSuccessMessage”: true,
\n “villagerCycleLimit”: -1,
\n “wanderingTraderCycleLimit”: 1,
\n “buttonOffsetX”: 6,
\n “buttonOffsetY”: -25,
\n “buttonWidth”: 100,
\n “buttonHeight”: 20
\n}
\n“`<\/p>\n
| Option | Default | Description |
\n|——–|———|————-|
\n| `enableCycleButton` | `true` | Show\/hide the cycle button |
\n| `showSuccessMessage` | `true` | Show villager cycle success message (client-side) |
\n| `showWanderingTraderSuccessMessage` | `true` | Show wandering trader success message (client-side) |
\n| `allowWanderingTraders` | `false` | Enable wandering trader cycling (**operator only** on servers) |
\n| `villagerCycleLimit` | `-1` | Max cycles per villager: -1=unlimited (**operator only** on servers) |
\n| `wanderingTraderCycleLimit` | `1` | Max cycles per wandering trader: -1=unlimited (**operator only** on servers) |
\n| `buttonOffsetX\/Y` | `6`\/`-25` | Button position offset from GUI |
\n| `buttonWidth\/Height` | `100`\/`20` | Button dimensions (pixels) |<\/p>\n
### Keybinds<\/p>\n
All keybinds are **unbound by default**. Set them in Options \u2192 Controls \u2192 Villager Cycle.<\/p>\n
Supports both keyboard keys and mouse buttons (e.g., Mouse Button 4\/5).<\/p>\n
| Keybind | Function |
\n|———|———-|
\n| Toggle Button Visibility | Show\/hide the cycle button |
\n| Open Button Position Screen | Open drag screen to reposition button |
\n| Open Config Screen | Open the mod configuration screen |
\n| Reload Config File | Reload config from disk |
\n| Cycle Trades | Cycle trades while in merchant screen (keyboard or mouse) |<\/p>\n
## Singleplayer vs Multiplayer<\/p>\n
– **Singleplayer**: All features available with full control over all settings.
\n– **Multiplayer**: Operator permission (level 4) required for:
\n – Allow Wandering Traders toggle
\n – Villager Cycle Limit
\n – Wandering Trader Cycle Limit<\/p>\n
Success message toggles are client-side \u2014 each player controls their own preference.<\/p>\n
## Limitations<\/p>\n
– Only works on villagers not yet traded with
\n– Only works on villagers with valid professions (not Nitwits\/Unemployed)
\n– Only refreshes Level 1 trades (experience level 0)
\n– Items in trade slots are returned to inventory when cycling<\/p>\n
## Technical Requirements<\/p>\n
– **Minecraft**: 1.21.9, 1.21.10, 1.21.11, or 26.1
\n– **Fabric Loader**: 0.18.4+
\n– **Java**: 21+ (Java 25+ for MC 26.1)
\n– **Fabric API**: Required (version matched to your MC version)
\n– **Cloth Config**: Optional, recommended (not available for MC 26.1 as of late)
\n– **ModMenu**: Optional, recommended<\/p>\n
## License<\/p>\n
MIT License \u2014 Free to include in modpacks.<\/p>\n
## Support<\/p>\n
Open an issue on GitHub for bugs or suggestions.<\/p>\n
## Author<\/p>\n
Created by Partacus-SPQR<\/p>\n","protected":false},"excerpt":{"rendered":"
A Minecraft Fabric mod that adds a button to refresh villager trades.<\/p>\n","protected":false},"featured_media":166487,"template":"","meta":{"_minecraft_slug":"villagercycle","_minecraft_project_id":"lI4LXqQa","_minecraft_author":"Partacus-SPQR","_minecraft_license":"MIT","_minecraft_downloads":22940,"_minecraft_follows":14,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"villagercycle.zip","_minecraft_size_bytes":7219604,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-16T22:07:26.454057Z","_minecraft_date_created":"2025-12-02T22:23:29.488637Z","_minecraft_date_modified":"2026-03-26T00:44:33.964519Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/villagercycle","_minecraft_icon_attachment_id":166487,"_minecraft_imported_at":"2026-06-09T18:24:36+00:00","_minecraft_import_hash":"693947ea10decac438180b9c6b697fed","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,89,92],"mod_loader":[99],"minecraft_version":[40,41,83],"class_list":["post-166486","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-game-mechanics","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-26-1"],"yoast_head":"\n