Skip to content

Repository files navigation

PromptCraft

ИИ-ассистент строительства для Minecraft (Fabric)

🌐 Язык: Русский | English


О моде

Мод для Fabric, который строит в Minecraft по твоему текстовому запросу. Просто пишешь, что хочешь увидеть, а нейросеть (GPT, Claude, Gemini и другие) сама придумывает чертёж и возводит здание прямо в игре, правильно расставляя все блоки и детали.

Мод устанавливается как обычный .jar-файл в папку mods (Fabric Loader + Fabric API, Minecraft 1.20.1, Java 17+). Постройка доступна только в творческом режиме игры.


Первый запуск

При старте мод создаёт папку config/promptcraft/ со следующими файлами:

  • config.json: все настройки мода, включая провайдера, модель, режимы, лимиты и визуальные параметры. Редактировать файл вручную не обязательно: почти всё доступно и сохраняется через игровое меню.
  • .env: API-ключи провайдеров, которые хранятся отдельно от общих настроек.

Получение API-ключа

Ключ можно добавить прямо из игры, без редактирования файлов: команда /pmenu или клавиша K открывает меню. На вкладке «Подключение ИИ» можно выбрать провайдера и вставить ключ в соответствующее поле. После этого ключ сразу сохранится в .env.

Ключи выдаются на сайтах провайдеров: Anthropic (console.anthropic.com), OpenAI (platform.openai.com), Google Gemini (aistudio.google.com), DeepSeek (platform.deepseek.com), xAI (console.x.ai), OpenRouter (openrouter.ai) и NVIDIA NIM (build.nvidia.com).


Основной рабочий процесс

  1. Взять в руки кисть выделения из группы предметов «PromptCraft».
  2. Нажать ЛКМ по блоку, чтобы задать первую точку зоны построения, затем ПКМ по другому блоку, чтобы задать вторую. Между точками отображается полупрозрачный контур выделения.
  3. Открыть меню командой /pmenu или клавишей K.
  4. На вкладке «Создание» ввести текстовое описание постройки и нажать «Создать».
  5. Мод очистит выделенную область, отправит запрос ИИ и после ответа начнёт строительство с отображением прогресса в HUD.

Кнопка «Правка» позволяет доработать последний запрос новой фразой, например «добавь окна» или «сделай крышу выше», без повторного выделения области. ИИ перестроит результат с учётом правки.

Кнопка «Отменить (очистить)» прерывает текущую генерацию либо полностью убирает уже построенную структуру. Кнопки «Назад» и «Далее» перемещаются по истории построек, отменяя и возвращая отдельные шаги.

Пока отображается призрак-предпросмотр в режиме авто области, обычное разрушение блоков левой кнопкой мыши заблокировано. Нажатие используется только для подтверждения размещения.


Меню /pmenu

Меню открывается командой /pmenu или клавишей K и состоит из семи вкладок.

Создание: поле запроса и кнопки «Создать», «Правка», «Отменить (очистить)», «Назад» и «Далее», а также переключатель режима зоны построения: «Ручная область» или «Авто область».

Подключение ИИ: выбор провайдера из списка с иконками, поле API-ключа для текущего провайдера, выбор модели вручную или через обновление списка моделей с сервера провайдера, а также переключатель креативности: «Высокая креативность» или «Строго по промпту».

Анимации: переключатель отображения текстовых сообщений о ходе процесса, включая подготовку области, обращение к ИИ и строительство.

Язык: переключение интерфейса мода между русским и английским. При первом входе в мир язык автоматически подбирается в соответствии с языком клиента Minecraft.

Тема: цветовой пикер с настройками насыщенности, яркости и оттенка для акцентного цвета интерфейса мода, ручной ввод HEX-кода и кнопка сброса к цвету по умолчанию.

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

Лимиты: включение жёсткого ограничения размеров постройки и значения максимальной ширины, высоты и глубины в блоках. Эти лимиты действуют и в режиме авто области, задавая безопасный максимальный размер конструкции, которую ИИ может построить без явного выделения.


Режимы зоны построения: ручная область и авто область

Переключатель находится на вкладке «Создание».

В режиме «Ручная область» зона построения задаётся игроком с помощью кисти выделения. Границы жёсткие: ИИ обязан уложиться точно в заданные габариты. При попытке выйти за пределы движок повторно отправляет модели запрос с уточнением, ограничивая количество таких попыток настройкой в конфигурации.

В режиме «Авто область» выделять зону не нужно: команда «Создать» отправляется сразу, а ИИ самостоятельно определяет подходящий размер конструкции под описание. При этом используются безопасный технологический предел или ограничения со вкладки «Лимиты», если они включены.

После получения ответа в мире появляется полупрозрачный призрак постройки. Его можно перемещать вслед за курсором и поворачивать клавишей R. Нажатие левой кнопки мыши открывает диалог подтверждения с кнопками «Да» и «Нет». Только после подтверждения область фактически очищается, а постройка размещается в мире.


Переключатель креативности: высокая креативность и строго по промпту

Настройка находится на вкладке «Подключение ИИ» и определяет не только художественный стиль результата, но и параметры самого запроса к модели.

Высокая креативность

Режим ставит перед моделью задачу выступить в роли мастера-строителя высокого уровня. Системная инструкция запрещает однотонные плоские коробки и требует:

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

Модели передаётся развёрнутый эталонный пример того, как из простого запроса «каменная башня» получить многоярусную детализированную конструкцию. Температура генерации в этом режиме равна 0.85, что даёт модели больше вариативности и творческой свободы.

Строго по промпту

Режим переводит модель в роль точного и буквального исполнителя. Единственная задача: построить ровно то, что описано в запросе, без добавленных украшений, ландшафта или художественных вольностей, если о них не было речи явно.

Материалы, размеры и форма соблюдаются в точности так, как указал игрок. Если какая-то деталь не упомянута, выбирается простейшая нейтральная реализация вместо самостоятельной додумки.

Температура генерации равна 0.2, что делает поведение модели максимально предсказуемым и детерминированным.

Переключение между режимами происходит мгновенно, сохраняется в конфигурации и применяется уже к следующему запросу без перезапуска игры. Высокая креативность подходит для художественных построек и запросов вида «удиви меня». Строго по промпту лучше использовать для точных технических заданий, копий чертежей и построек с редстоун-механизмами, где особенно важна буквальная точность.


Формат строительных операций

ИИ не возвращает изображение: он присылает JSON с последовательностью операций, которые мод выполняет по порядку.

Операция place ставит один блок в указанной точке с возможными состояниями, включая ориентацию, половину двери и другие параметры.

Операция fill заливает сплошной прямоугольный объём одним блоком.

Операция hollow_box создаёт пустотелую коробку со стенами, полом и потолком толщиной в один блок.

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

Мод дополнительно:

  • проверяет, что все координаты находятся в пределах выделенной или безопасной зоны;
  • автоматически соединяет стеклянные панели, решётки, заборы, стены и провода редстоуна без явного указания состояний соединения;
  • восстанавливает операции из обрезанного или повреждённого ответа модели, например при обрыве потоковой передачи;
  • при необходимости повторно обращается к ИИ с уточнением ошибки. Число таких попыток ограничено настройкой в конфигурации.

Провайдеры ИИ

Мод работает через единый интерфейс с семью провайдерами, у каждого из которых учтены особенности запроса.

Anthropic использует потоковую передачу с отдельным системным промптом и автоматическим подбором ограничения токенов под модель.

OpenAI поддерживает рассуждающие модели с ролью developer и повышенным уровнем рассуждения.

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

DeepSeek использует формат запроса, совместимый с OpenAI.

xAI и OpenRouter также запрашивают повышенный уровень рассуждения перед ответом.

NVIDIA NIM используется по умолчанию и для поддерживаемых моделей включает режим отображения рассуждений.

Для каждого провайдера на вкладке «Подключение ИИ» доступна кнопка обновления списка моделей. Она запрашивает актуальный перечень напрямую с серверов провайдера.


Управление

  • Клавиша K открывает и закрывает меню PromptCraft.
  • Клавиша R поворачивает призрак-предпросмотр на девяносто градусов в режиме авто области.
  • Левая кнопка мыши подтверждает текущее положение призрака и открывает диалог подтверждения размещения.

Все клавиши можно переназначить в стандартном меню управления Minecraft, в категории «PromptCraft».

About

Script that allows AI to create structures in Minecraft

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages