QuickCast PvP

QuickCast PvP — это лёгкий, высокопроизводительный клиентский мод на Fabric для Minecraft 26.3 («Wilderness Bound»). Он позволяет игрокам привязать клавиши или кнопки мыши для мгновенного выбора, применения/использования/установки и восстановления предметов из хотбара одним плавным действием за 1–2 клиентских тика.

Разработанный специально для соревновательного PvP, QuickCast PvP не отправляет никаких кастомных пакетов, соблюдает все ванильные ограничения по перезарядке и дальности, а также работает с монотонной наносекундной точностью, чтобы предотвратить десинхронизацию и промахи.

Возможности

• Три независимых действия:

  • Быстрый эндер-жемчуг: по умолчанию Средняя кнопка мыши (кнопка 3).
  • Быстрый заряд ветра: по умолчанию не привязан.
  • Быстрый кристалл Края: по умолчанию не привязан.

• Умный поиск по хотбару:

  • Сканирует слоты хотбара 0–8 по порядку в поисках нужных предметов (Items.ENDER_PEARL, Items.WIND_CHARGE, Items.END_CRYSTAL).
  • Вторая рука строго не трогается и никогда не проверяется.

• Конечный автомат переключения и восстановления слота за 1 тик:

  • Переключается на слот с подходящим предметом и запускает ванильное использование (useItem или useItemOn).
  • В режиме RESTORE возвращается к исходному слоту на следующем клиентском тике.
  • Сохранение ввода игрока: если вы вручную прокручиваете или нажимаете цифровую клавишу хотбара, пока ожидается восстановление, мод обнаруживает изменение и отменяет восстановление, никогда не конфликтуя с вашими ручными действиями.

• Режимы срабатывания (нажатие vs удержание и отпускание):

  • PRESS: срабатывает сразу при нажатии клавиши.
  • HOLD_AND_RELEASE: подготавливается при нажатии и применяет при отпускании. Автоматически отменяется через 3-секундное окно безопасности или если вы вручную переключите слот хотбара во время удержания.

• Защита с учётом задержки:

  • Настраиваемый порог пинга (highPingGuardMs, по умолчанию 250 мс, 0 = отключено).
  • Защищает от десинхронизации слотов на нестабильном соединении, предотвращая применение, когда задержка в реальном времени (PlayerInfo.getLatency()) превышает ваш лимит.
  • Автоматически обходит проверки задержки в одиночной игре и мирах по локальной сети.

• Обнаружение конфликтов привязок клавиш:

  • Сканирует все ванильные и модифицированные записи KeyMapping при запуске и во время работы.
  • Записывает предупреждения в консоль, один раз уведомляет игрока через панель действий при конфликте и отображает предупреждающие баннеры в реальном времени в экране конфигурации YACL.

• Проверка установки кристалла:

  • Поддерживает TRY_PLACE (прямая серверная проверка) и PLACE_AT_CROSSHAIR_IF_POSSIBLE (клиентская предпроверка с проверкой обсидиана/бедрока, верхней грани, воздуха сверху и свободного места под хитбокс сущности).

• Гибкая обратная связь и предупреждения о низком запасе:

  • Несколько стилей обратной связи: NONE, ACTION_BAR, TITLE, SOUND или ALL.
  • Настраиваемое предупреждение о низком запасе (lowStockWarningThreshold, по умолчанию 1 предмет, 0 = отключено), предупреждающее вас, когда запас в хотбаре подходит к концу.

• Монотонные перезарядки и переопределения:

  • Использует System.nanoTime() для устойчивого к лагам тайминга.
  • Настраиваемая глобальная перезарядка (по умолчанию 120 мс, ползунок 0–2000 мс).
  • Защита от быстрого повтора клавиш при промахах (перезарядка 50 мс) предотвращает спам сканирования хотбара, когда предметы закончились.
  • Переопределения перезарядки для каждого действия (cooldownOverrideMs, -1 = наследовать глобальную).

• Управление профилями:

  • Сохраняйте, загружайте и переключайтесь между именованными профилями конфигурации, хранящимися в `.minecraft/config/quickcastpvp/profiles/.json`.
  • Управляйте профилями прямо в игре через экран конфигурации YACL или через чат-команды (/quickcastpvp profile [save|load|list]).

• Защита при вводе текста и в экранах:

  • allowWhileScreenOpen: если false, любой открытый GUI блокирует применение. Если true, нетекстовые экраны (например, инвентарь) позволяют применение, а ChatScreen и активные текстовые поля (EditBox) остаются строго защищёнными.

• Настройка в игре:

  • Работает на YetAnotherConfigLib (YACL v3).
  • Бесшовно интегрируется с Mod Menu, если он установлен.
  • Доступно через команду /quickcastpvp config или отдельную переназначаемую привязку клавиши.
  • Схема v2 с автоматической обратно совместимой миграцией из конфигураций v1.0.0.

Требования для установки

• Minecraft: 26.3 ("Wilderness Bound")
• Fabric Loader: >= 0.19.5
• Java: 25

• Обязательные зависимости:

  • Fabric API (0.161.0+26.3 или новее)
  • YetAnotherConfigLib (YACL) (3.9.6+26.3-fabric или новее)

• Необязательные зависимости:

  • Mod Menu (21.0.0-beta.1 или новее) для доступа через экран "Мods".

Скинь quickcastpvp-1.0.1.jar и обязательные зависимости в папку .minecraft/mods.

Справочник по конфигурации

Конфигурация хранится в .minecraft/config/quickcastpvp.json (схема v2).

{
  "configVersion": 2,
  "pearl": {
    "enabled": true,
    "cooldownOverrideMs": -1,
    "triggerMode": "PRESS"
  },
  "windCharge": {
    "enabled": true,
    "cooldownOverrideMs": -1,
    "triggerMode": "PRESS"
  },
  "endCrystal": {
    "enabled": true,
    "cooldownOverrideMs": -1,
    "triggerMode": "PRESS",
    "crystalPlaceMode": "TRY_PLACE"
  },
  "afterUseBehavior": "RESTORE",
  "requireHotbarOnly": true,
  "cooldownMs": 120,
  "highPingGuardMs": 250,
  "feedbackStyle": "ACTION_BAR",
  "lowStockWarningThreshold": 1,
  "allowWhileScreenOpen": false
}

Таблица параметров конфигурации

Примечание: Клавиши хранятся в ванильном options.txt Minecraft и настраиваются в Настройки > Управление > Клавиши > QuickCast PvP.

Команды

QuickCast PvP предоставляет клиентские команды:

• /quickcastpvp config — Открывает экран настройки в игре.
• `/quickcastpvp profile save — Сохраняет активные настройки в.minecraft/config/quickcastpvp/profiles/.json`.
• `/quickcastpvp profile load ` — Загружает настройки из указанного профиля и сразу их применяет.
• /quickcastpvp profile list — Выводит в чат список всех сохранённых профилей настроек.

Открытие экрана настройки

1. Через Mod Menu: Откройте меню модов в игре, выберите QuickCast PvP и нажмите на иконку настроек.
2. Через команду: Выполните /quickcastpvp config в чате.
3. Через клавишу: Назначьте клавишу "Open QuickCast Config" в разделе Управление > Клавиши.

Известные ограничения и особенности реализации

• Только хотбар (requireHotbarOnly = true): Поиск по всему основному инвентарю и перемещение предметов в хотбар через пакеты клика по слоту создаёт задержки сетевого обмена, обновления ID состояния контейнера и риск рассинхронизации в напряжённом PvP. Чтобы соблюсти правило "No Fake Options", этот переключатель явно отключён в меню YACL с поясняющей подсказкой и сейчас строго ограничен только хотбаром.
• Честная игра по ванильным правилам: QuickCast PvP не изменяет ванильные перезарядки атак, перезарядки предметов, дальность взаимодействия или серверную проверку пакетов. Энд-кристаллы, поставленные на недопустимые блоки или занятые места, будут отклонены сервером согласно ванильной механике.

Сборка из исходников

Чтобы скомпилировать мод из исходников:

git clone https://github.com/quickcastpvp/quickcastpvp.git
cd quickcastpvp
./gradlew build

Скомпилированный артефакт будет находиться в build/libs/quickcastpvp-1.0.1.jar.