Villager Cycle

Villager Cycle

Мод для Minecraft Fabric, повышающий удобство игры: добавляет кнопку в интерфейс торговли с жителями, позволяя обновлять их предложения до совершения покупок.

Возможности

• Кнопка обновления торговли: настраиваемая кнопка над интерфейсом торговли с жителем
• Перетаскиваемая позиция кнопки: перемещайте кнопку через экран перетаскивания
• Обновление в реальном времени: предложения обновляются мгновенно, без закрытия интерфейса
• Поддержка горячих клавиш: привязки клавиш клавиатуры и кнопок мыши для всех функций мода
• Настраиваемые лимиты обновлений: задайте ограничение на количество обновлений торговли (для каждого жителя)
• Поддержка странствующего торговца: опциональная функция (управляется оператором на серверах)
• Умная проверка: работает только с подходящими жителями (должна быть профессия, торговля ещё не проводилась)
• Серверная безопасность: вся проверка выполняется на стороне сервера
• Защита от эксплойтов: очищает слоты ввода торговли, предотвращая дублирование предметов

Установка

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

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

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

Настройка

Расположение файла конфигурации

• 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
}

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

Все горячие клавиши по умолчанию не назначены. Назначьте их в разделе Настройки → Управление → Villager Cycle.

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

Одиночная игра против многопользовательской

• Одиночная игра: Все функции доступны с полным контролем над всеми настройками.

• Многопользовательская игра: Требуются права оператора (уровень 4) для:

  • Переключателя «Разрешить странствующих торговцев»
  • Лимита цикла жителей
  • Лимита цикла странствующих торговцев

Переключатели сообщений об успехе работают на стороне клиента — каждый игрок управляет своими предпочтениями.

Ограничения

• Работает только с жителями, с которыми ещё не торговали
• Работает только с жителями с действительными профессиями (не бездельниками/безработными)
• Обновляет только сделки 1-го уровня (уровень опыта 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: Обязательно (версия должна соответствовать вашей версии MC)
• Cloth Config: Опционально, рекомендуется (недоступно для MC 26.x)
• ModMenu: Опционально, рекомендуется

Лицензия

Лицензия MIT — свободно включать в модпаки.

Поддержка

Открыть issue на GitHub для сообщений об ошибках или предложений.

Автор

Создано Partacus-SPQR