О моде

PromptCraft это мод для 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 и состоит из семи вкладок.

Режимы зоны построения

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

Ручная область

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

Авто область

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

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

Переключатель креативности

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

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

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

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

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

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

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

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

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

place

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

fill

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

hollow_box

Создаёт пустотелую коробку: стены, пол и потолок толщиной в один блок.

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

{
  "operations": [
    { "op": "hollow_box", "from": [0,0,0], "to": [8,7,8],
      "block": "minecraft:stone_bricks" },
    { "op": "fill", "from": [1,1,1], "to": [7,1,7],
      "block": "minecraft:oak_planks" },
    // окно прорезается воздухом поверх готовой стены
    { "op": "fill", "from": [3,3,0], "to": [5,4,0],
      "block": "minecraft:air" },
    { "op": "place", "pos": [4,1,0],
      "block": "minecraft:oak_door",
      "state": { "facing": "north", "half": "lower" } }
  ]
}

Что мод делает сам

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

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

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

Управление

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

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