Villager Cycle

Villager Cycle - это Quality of Life мод для Minecraft Fabric, который добавляет в интерфейс торговли с жителями кнопку для мгновенного обновления их предложений. Никаких лишних телодвижений: открыл меню, нажал кнопку - получил новый набор товаров. Идеально для тех, кто устал бесконечно ломать и ставить рабочие места в надежде выбить нужную книгу или алмазную броню.

Зачем это нужно

В ванильном Майнкрафт, чтобы сменить ассортимент жителя первого уровня, приходится либо разрушать его рабочее место, либо ждать, пока он сам обновится (а это может занять вечность). Мод решает эту проблему в один клик. Экономит кучу времени, особенно на серверах, где каждый алмаз на счету.

Особенности

• Кнопка "Обновить торговлю" - настраиваемая кнопка прямо над GUI жителя
• Перетаскивание кнопки - можно переместить в любое место через специальный экран
• Мгновенное обновление - предложения меняются без закрытия интерфейса
• Горячие клавиши - поддержка клавиатуры и мыши (например, Mouse Button 4/5)
• Лимиты обновлений - можно ограничить количество смен товаров для одного жителя (полезно на серверах)
• Поддержка странствующих торговцев - опционально, только для операторов на сервере
• Умная проверка - кнопка работает только с жителями, у которых есть профессия и с которыми ещё не торговали
• Безопасность на стороне сервера - вся валидация происходит на сервере, читеры не пройдут
• Защита от дупликации - предметы из слотов ввода возвращаются в инвентарь при обновлении

Установка

1. Скачайте .jar мода и поместите в папку .minecraft/mods
2. Обязательно установите Fabric API (версия под ваш Minecraft)
3. Рекомендуется Cloth Config 20.0.149+ (для расширенного интерфейса настроек, недоступен для MC 26.x)
4. Рекомендуется ModMenu 16.0.0+ (для доступа к конфигу прямо из игры)
5. Запускайте Minecraft с Fabric Loader 0.18.4+

Как пользоваться

1. Откройте интерфейс торговли с жителем
2. Нажмите кнопку "Обновить торговлю" (или используйте назначенную клавишу)
3. Предложения первого уровня жителя обновятся мгновенно

Настройка

Файл конфига

• Windows: %appdata%\.minecraft\config\villagercycle.json
• macOS: ~/Library/Application Support/minecraft/config/villagercycle.json
• Linux: ~/.minecraft/config/villagercycle.json

Параметры

{
  "enableCycleButton": true,
  "allowWanderingTraders": false,
  "showSuccessMessage": true,
  "showWanderingTraderSuccessMessage": true,
  "villagerCycleLimit": -1,
  "wanderingTraderCycleLimit": 1,
  "buttonOffsetX": 6,
  "buttonOffsetY": -25,
  "buttonWidth": 100,
  "buttonHeight": 20
}

Параметр	По умолчанию	Описание
enableCycleButton	true	Показать/скрыть кнопку обновления
showSuccessMessage	true	Показывать сообщение об успешном обновлении (клиентская сторона)
showWanderingTraderSuccessMessage	true	То же для странствующего торговца
allowWanderingTraders	false	Разрешить обновление странствующих торговцев (только оператор на сервере)
villagerCycleLimit	-1	Максимум обновлений на одного жителя: -1=безлимит, 0=отключено, 1+=лимит (только оператор)
wanderingTraderCycleLimit	1	То же для странствующего торговца
buttonOffsetX/Y	6/-25	Смещение кнопки от края GUI
buttonWidth/Height	100/20	Размер кнопки в пикселях

Горячие клавиши

По умолчанию все клавиши не назначены. Настроить можно в меню: Настройки → Управление → Villager Cycle.

Поддерживаются как клавиши клавиатуры, так и кнопки мыши (например, Mouse Button 4/5).

Клавиша	Функция
Переключить видимость кнопки	Показать/скрыть кнопку
Открыть экран позиции кнопки	Перетаскивание кнопки
Открыть экран настроек	Открыть конфиг мода
Перезагрузить конфиг	Перечитать файл настроек с диска
Обновить торговлю	Сменить предложения (клавиатура или мышь)

Одиночная игра и мультиплеер

• Одиночная игра: все функции доступны, полный контроль над настройками.
• Мультиплеер: для изменения параметров allowWanderingTraders, villagerCycleLimit и wanderingTraderCycleLimit требуется уровень оператора (4). Остальные настройки (сообщения об успехе) клиентские - каждый игрок выбирает сам.

Ограничения

• Работает только с жителями, с которыми ещё не торговали
• Только с жителями, у которых есть профессия (не с безработными или нитвитами)
• Обновляются только предложения первого уровня (опыт 0)
• Предметы из слотов ввода возвращаются в инвентарь при обновлении

Технические требования

• Minecraft: 1.21.9, 1.21.10, 1.21.11, 26.1 или 26.2
• Fabric Loader: 0.18.4+
• Java: 21+ (Java 25+ для MC 26.x)
• Fabric API: обязательно (версия под ваш Minecraft)
• Cloth Config: опционально, рекомендуется (недоступен для MC 26.x)
• ModMenu: опционально, рекомендуется

По факту, Villager Cycle - это тот случай, когда маленький мод делает большую разницу. Если вы часто торгуете с жителями на сервере или в одиночке, этот мод сэкономит вам кучу нервов и времени. Скачайте Villager Cycle и забудьте о бесконечных перестановках рабочих мест!