BindAlias

BindAliasPlus

Клиентский мод для Minecraft на Fabric, который позволяет создавать собственные алиасы и привязки клавиш для автоматизации сложных действий в игре простым нажатием клавиш. Также включает управление автономным ИИ-агентом через внутриигровой HTTP API — агенты могут видеть, рассуждать и действовать в Minecraft самостоятельно. Используйте вместе с инструментом BindAliasPlus MCP, чтобы позволить ИИ играть в игру.

Обзор

BindAliasPlus улучшает вашу игру в Minecraft, позволяя задавать собственные алиасы для последовательностей действий и привязывать их к клавишам. Нужно ли вам быстро менять слоты инвентаря, автоматизировать полёт на элитрах или объединять несколько действий (например, использование лука или установку блоков, которых нет даже в хотбаре или во второй руке) — этот мод упрощает повторяющиеся задачи с помощью настраиваемых алиасов и привязок клавиш.

Возможности

• Собственные алиасы: Создавайте переиспользуемые алиасы для одного или нескольких действий в игре (например, обмен предметов, использование способностей, движение).
• Привязки клавиш: Привязывайте алиасы к клавишам с поддержкой отдельных действий на нажатие и отпускание клавиши.
• Встроенные алиасы: Предопределённые алиасы для распространённых действий (например, swapSlot, wait, use, attack).
• Система команд: Интуитивные команды для управления алиасами и привязками (например, /alias, /bind, /unbind).
• Сохранение конфигурации: Сохраняет алиасы и привязки в файле конфигурации, который автоматически загружается при подключении к серверам.
• Цепочки действий: Объединяйте алиасы для создания сложных последовательностей (например, надеть элитры → использовать фейерверк → лететь).

Установка

1. Убедитесь, что у вас установлен Fabric Loader для вашей версии Minecraft.
2. Скачайте последний bind-alias-plus-*.*.*.jar со страницы релизов.
3. Поместите JAR-файл в папку mods вашего Minecraft.
4. Запустите Minecraft с загрузчиком Fabric.

Использование

Основные понятия

• Алиас: Собственное или встроенное действие (или последовательность действий), которое можно выполнить.
• Привязка клавиши: Связь между физической клавишей (например, mouse5, keyboard.g) и алиасом (или двумя алиасами: один для нажатия, один для отпускания).

Встроенные алиасы

BindAliasPlus включает готовые алиасы для распространённых действий. Они делятся на алиасы с аргументами и * *алиасы без аргументов**.

Алиасы с аргументами

Примечание: Слоты следуют внутренней нумерации Minecraft:

• 1-9 → Слоты хотбара
• 10-36 → Слоты инвентаря (10-19 = первый ряд)
• 37-40 → Слоты экипировки (37 = ступни, 38 = ноги, 39 = нагрудник, 40 = голова)
• 41 → Слот второй руки
• аргументы можно заключать в двойные кавычки, чтобы пробелы внутри не считались разделителями.
• РЕКОМЕНДУЕТСЯ для вложенных определений: При использовании встроенных алиасов alias, bind, unbind, say, sendCommand или localSay внутри других определений алиасов используйте точку с запятой ; вместо пробела в качестве разделителя между аргументами. Это позволяет использовать обычные пробелы-разделители во вложенном определении без конфликтов. Пример: alias +testAlias bind\v;+anotherAlias alias\+yetAnotherAlias;+anotherAlias;+jump alias\+nextAlias;wait\2;+yetAnotherAlias wait\1 bind\x;+testAlias — здесь точки с запятой разделяют аргументы для этих встроенных алиасов, а пробелы работают как обычно.

| alias\args | почти то же, что команда alias, только аргументы нужно оборачивать в двойные кавычки. | alias\"meow say\nya~" (создать или заменить алиас) | | bind\args | почти то же, что команда bind, только аргументы нужно оборачивать в двойные кавычки. | bind\"m meow wait\0 +fly" (создать или заменить бинд) | | unbind\keyName | почти то же, что команда unbind. | unbind\m (снять бинды с клавиши) | | say\string | отправить сообщение в чат. | say\"How old r u?" (отправить в чат сообщение "how old r u?") | | localSay\string | показать сообщение в чате только на локальном клиенте, не отправляя на сервер. Полезно для тестов, уведомлений и отладочного вывода. | localSay\"Debug: slot is \(mySlot)" (сообщение только локально) | | sendCommand\command | отправить команду. | sendCommand\"gamemode creative" (отправить команду "gamemode creative") | | var\varName\source | Сохранить значение в переменную. Источники: hotbarSlot, itemsOfSlot0-9, pitch, yaw или число. | var\mySlot\hotbarSlot (сохранить слот хотбара), var\angle\pitch (сохранить угол наклона) | | reapply\action | Вручную заново применить зажатый булев алиас (attack, use, forward, back, left, right, jump, sneak, sprint, drop, openInventory). Полезно в конце UserAlias после переходов между экранами. | reapply\forward (заново нажимает клавишу forward, если она зажата) | | openInventory\state | Открывает (1) или закрывает (0) экран инвентаря. | openInventory\1 (открыть инвентарь), openInventory\0 (закрыть инвентарь) |

Числовые алиасы поддерживают ссылки на переменные: yaw, pitch, setYaw, setPitch, slot, swapSlot, wait и setPerspective принимают имена переменных (например, yaw\myVar или slot\mySlot) вместо чисел.

Алиасы без аргументов

Это сокращённые алиасы, которые соответствуют обычным действиям state=1 (старт) и state=0 (стоп) для более простого использования:

| TPS2 | builtinSetPerspective\2 | Переключает на вид от третьего лица спереди. | | reloadCFG | — | Перезагружает файл конфига (применяет изменения без перезапуска). | | unloadCFGAliases | — | Удаляет все алиасы, загруженные из файла конфига. | | unloadCFGBinds | — | Удаляет все привязки клавиш, загруженные из файла конфига. | | unloadCFGVars | — | Удаляет все переменные, загруженные из файла конфига. | | unloadCFGAll | — | Удаляет все алиасы, привязки клавиш и переменные, загруженные из конфига. |

Переменные

Переменные позволяют сохранять и переиспользовать игровые значения (слот хотбара, углы pitch/yaw, количество предметов и т. д.).

Источники для var\varName\source:

Затем переменные можно использовать как аргументы в любом числовом алиасе (например, yaw\myVar, slot\mySlot, wait\myTicks).

Команды, связанные с переменными:

Пример конфига

Вот реальный файл конфига (config/bind-alias-plus.cfg), показывающий ключевые возможности в одном месте:

/var offHand 41
/alias jumpOnce +jump wait\0 -jump
## 36->elytra; 27->firework
/alias +fly swapSlot\36\39 jumpOnce wait\0 jumpOnce swapSlot\27\41 +use -use TPS
/alias -fly swapSlot\36\39 swapSlot\27\41 wait\2 FPS
/alias +fastUse_Var swapSlot\varFastUse\offHand +use
/alias -fastUse_Var -use swapSlot\varFastUse\offHand
/alias +fastAttack_Var swapSlot\varFastAttack wait\1 +attack
/alias -fastAttack_Var -attack swapSlot\varFastAttack

# alias fly_on +silent bind\"mouse5 fly_off" -silent +fly
# alias fly_off +silent bind\"mouse5 fly_on" -silent -fly

/bind w +forward
/bind a +left
/bind s +back
/bind d +right
/bind space +jump
/bind left.shift +sneak
/bind left.control +sprint
/bind mouse1 +attack
/bind mouse2 +use
/bind mouse5 +fly
## water; powder_snow; food; ender_pearl; bow;... 3 fast use slots
/bind mouse4 var\varFastUse\19 +fastUse_Var
/bind b var\varFastUse\20 +fastUse_Var
/bind v var\varFastUse\28 +fastUse_Var
## fortune_pickaxe 1 fast mine slot
/bind n var\varFastAttack\29 +fastAttack_Var

Конфигурация

• Файл конфига: В config/bind-alias-plus.cfg. Создаётся автоматически, если его нет.
• Автозагрузка: Алиасы и привязки из файла конфига загружаются автоматически при загрузке мода.
• Ручное редактирование: Вы можете напрямую редактировать файл конфига, чтобы добавлять/изменять алиасы/привязки (используйте тот же синтаксис, что и для игровых команд). Смотрите раздел Пример конфига выше для полного реального конфига.

Справочник команд

Примечания

• Совместимость: Работает с большинством модов на Fabric; может конфликтовать с модами, которые изменяют обработку клавиш или механику инвентаря.
• Версия Minecraft: Требуется Minecraft 1.21+ (маппинги Yarn) или 26.x (маппинги Mojang). Проверьте страницу релиза для сборок под конкретные версии (имена файлов содержат версию MC).
• Переменные: Поддерживает целочисленные значения и значения с плавающей точкой. Числовые алиасы (yaw, pitch, setYaw, setPitch, slot, swapSlot, wait, setPerspective) принимают имена переменных вместо обычных чисел.
• Безопасность: Избегайте чрезмерной автоматизации на серверах с анти-читом (некоторые действия могут быть помечены как подозрительные).

Участие в разработке

Мы рады вашему вкладу! Смело открывайте issue с багами или предложениями либо присылайте pull request с улучшениями.

Лицензия

Этот мод распространяется под лицензией Creative Commons Zero v1.0 Universal.