Craftpilot

Craftpilot

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

Установка

Craftpilot требует companion-программу, которая запускает ML-модель. Вот как начать:

Быстрый старт (рекомендуется)

1. Скачай последний релиз со страницы релизов

2. Запусти companion-программу

   ⚠️ Примечание: для оптимальной производительности ML-модели нужна современная видеокарта (рекомендуется NVIDIA). Без неё генерация может быть значительно медленнее.

3. Запусти Minecraft — Craftpilot автоматически подключится к локальному экземпляру

Альтернативные варианты установки

• Для разработчиков: companion-программу можно запустить прямо из исходного кода. Клонируй репозиторий, установи зависимости Python и запусти её локально. Это пригодится для кастомизации или отладки.
• Продвинутая настройка: companion-программа может работать на удалённом сервере. Укажи URL подключения в настройках мода, чтобы он указывал на нужный адрес сервера.

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

1. Вызов подсказок

   • Поставь любой блок, чтобы начать новую постройку или продолжить существующую. Подсказки появятся автоматически.
   • Также можно вручную вызвать подсказки, не ставя блоки, нажав клавишу вызова (по умолчанию R).
   • Craftpilot покажет предложенные блоки в виде полупрозрачного оверлея.

2. Работа с подсказками

   • Принимай подсказки, ставя блоки там, где они показаны.
   • В режиме лёгкой установки (включён по умолчанию) можно ставить блоки точно так, как они показаны в подсказках, не задумываясь об ориентации или соседних блоках. Просто кликни правой кнопкой по предложенному блоку, чтобы поставить его в правильной ориентации и состоянии. В креативе можно ставить блоки даже с пустой рукой.
   • Пока ты строишь, новые подсказки будут появляться автоматически.
   • Используй функцию выбора блока (средняя кнопка мыши) на подсказках, чтобы быстро выбрать блоки.
   • Нажми клавишу очистки (по умолчанию Z), чтобы убрать все текущие подсказки.
   • Убирай отдельные подсказки, кликая по ним левой кнопкой (ударяя).
   • Прими все предложенные блоки сразу, нажав клавишу принятия (по умолчанию V).

3. Гибкость строительства

   • Смело отклоняйся от подсказок — система подстроится.
   • Есть период отсрочки, позволяющий поставить несколько других блоков перед тем, как подсказки обновятся.
   • Это помогает учесть опорные блоки и мелкие правки.

4. Выбор альтернатив

   • Помимо основных подсказок можно сгенерировать несколько альтернатив. Они видны как квадратики рядом с логотипом Craftpilot в правом верхнем углу экрана.
   • Удерживай клавишу выбора альтернативы (по умолчанию левый alt) и используй колесо прокрутки или клавиши хотбара, чтобы выбрать вариант.

Настройка производительности

Запуск ML-модели очень требователен к производительности и сильно зависит от железа. Поэтому есть несколько вариантов и компромиссов по производительности. Если предложения генерируются очень медленно, попробуйте уменьшить эти значения. Если скорость генерации нормальная, можно попробовать их увеличить. Есть 3 основных параметра, влияющих на производительность:

• Тип модели — Сейчас есть 2 модели разного размера: Iron и Diamond. Iron значительно меньше и быстрее Diamond, но даёт предложения хуже по качеству. При запуске на CPU Diamond почти невозможно использовать. При значении по умолчанию используется модель, которую программа-компаньон автоматически выбрала для вашего железа.
• Радиус предложений — Меняет размер структуры, отправляемой в модель, и тем самым напрямую влияет на объём вычислений. Большие радиусы экспоненциально увеличивают требования к вычислениям и памяти. Уменьшение этого значения ускорит работу, но предложения будут учитывать меньше окружающей территории.
• Макс. альтернатив — Каждая альтернатива, которую рассчитывает модель, требует дополнительных вычислений и памяти. Быстрее всего будет поставить 1.

Кастомизация

Настройки можно редактировать в файле конфигурации "craftpilot.json" или на экране настроек, доступном через Mod Menu. Доступные настройки включают визуальные параметры (например, внешний вид оверлея), поведение при строительстве и параметры ML-модели.