AI Crafting Table — NeoForge Port

Unofficial port of AI Crafting Table for Minecraft 1.21.1 + NeoForge

English

This is an unofficial NeoForge 1.21.1 port of AI Crafting Table, originally created by AlexLee1235 / Watermelon0117 for Minecraft 1.19.2 Forge.

This port is independently maintained and is not an official release from the original author.

✨ About

AI Crafting Table turns a normal 3×3 ingredient layout into completely new, AI-generated Minecraft items.

The basic workflow is simple:

1. Place ingredients into the AI crafting table.
2. Request three item ideas based on the ingredients and their arrangement.
3. Select one of the generated ideas.
4. The configured AI service generates the item's properties and texture.
5. Take the finished result to register its recipe in the current world.

Generated items may behave as tools, weapons, food, or regular items depending on their generated properties.

Recipes, item data, textures, and per-player rate limits are persisted by the server and synchronized with connected clients. Previously generated recipes are also available through the mod's crafting integration.

🧩 Compatibility

The port is built and tested against NeoForge 21.1.241. Compatibility with other NeoForge versions is not guaranteed.

The mod must be installed on both the server and every connecting client.

📦 Installation

1. Install Minecraft 1.21.1.
2. Install NeoForge 21.1.241.
3. Make sure Java 21 is available to your launcher or server.
4. Download the NeoForge port .jar.
5. Place the .jar in the mods directory:
   • on the server;
   • on every connecting client.
6. Start the game/server once to generate the configuration files.

Crafting recipe

The AI Crafting Table is crafted with four diamonds around a vanilla crafting table:

 D
DCD
 D

• D — Diamond
• C — Crafting Table

🤖 AI service configuration

The common configuration file is generated at:

config/aicraft-common.toml

Public proxy

When OpanAI API Key is empty, the mod uses the original project's public proxy service:

mod.aicraftingtable.com

Direct OpenAI API

When an OpenAI API key is configured, the server contacts the OpenAI API directly for text and image generation.

The OpanAI API Key spelling is intentionally retained for configuration compatibility.

API keys are stored locally in plain text. Never commit a populated config file to Git, publish it, or share it with clients.

Direct OpenAI usage requires network access, a compatible account, and may incur API charges.

Generation requests necessarily send the following data to the selected external service:

• crafting-grid item names;
• requested language;
• a player identifier.

The public proxy is operated outside this port, so its availability is not guaranteed.

⏱️ Server rate limits

Server-authoritative limits are generated in:

config/aicraft-server.toml

The cooldown value must be a positive integer followed by:

• s — seconds
• m — minutes
• h — hours
• d — days

Examples:

30m
24h
7d

An accepted generation request consumes its quota even if the external service later returns an error.

🛠️ Commands

Operators with permission level 2 can remove a generated item and its registered recipes:

/aicraft removeItem <item_id>

❤️ Credits

• Original mod and assets: AlexLee1235 / Watermelon0117
• Original CurseForge project: AI Crafting Table
• NeoForge 1.21.1 port: Softboundless

Minecraft is a trademark of Microsoft Corporation.

This project is not affiliated with or endorsed by Microsoft, Mojang Studios, NeoForged, OpenAI, or the original mod author.

⚖️ License

This project is a fork/port of the original AI Crafting Table project.

Upstream code and assets that originate from the original project remain licensed under the MIT License. See LICENSE-UPSTREAM.

Original modifications and contributions created by Peacefull02 (AKA softboundless) are licensed under the Softboundless Modifications License 1.0. See LICENSE.

Use of the Softboundless modifications in certain third-party Minecraft modpacks using the "Freakland" name is restricted.

The restriction does not apply to modpacks created or authorized by Peacefull02 (AKA softboundless), as defined by the applicable license terms.

Русский

Это неофициальный порт для NeoForge 1.21.1 мода AI Crafting Table, изначально созданного AlexLee1235 / Watermelon0117 для Minecraft 1.19.2 Forge.

Порт поддерживается независимо и не является официальным релизом оригинального автора.

✨ О моде

AI Crafting Table позволяет превращать обычную раскладку ингредиентов 3×3 в совершенно новые предметы Minecraft, сгенерированные с помощью ИИ.

Процесс создания предмета выглядит так:

1. Поместите ингредиенты в AI Crafting Table.
2. Запросите три идеи предметов, основанные на ингредиентах и их расположении.
3. Выберите одну из предложенных идей.
4. Настроенный ИИ-сервис сгенерирует свойства и текстуру предмета.
5. Заберите готовый предмет, чтобы зарегистрировать его рецепт в текущем мире.

Сгенерированные предметы могут работать как инструменты, оружие, еда или обычные предметы — это зависит от полученных при генерации свойств.

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

🧩 Совместимость

Порт собирался и тестировался на NeoForge 21.1.241. Совместимость с другими версиями NeoForge не гарантируется.

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

📦 Установка

1. Установите Minecraft 1.21.1.
2. Установите NeoForge 21.1.241.
3. Убедитесь, что лаунчер или сервер использует Java 21.
4. Скачайте .jar-файл NeoForge-порта.
5. Поместите .jar в папку mods:
   • на сервере;
   • у каждого подключающегося игрока.
6. Один раз запустите игру/сервер, чтобы были созданы конфигурационные файлы.

Рецепт крафта

AI Crafting Table создаётся из четырёх алмазов, расположенных вокруг обычного верстака:

 D
DCD
 D

• D — алмаз
• C — верстак

🤖 Настройка ИИ-сервиса

Общий конфигурационный файл создаётся по адресу:

config/aicraft-common.toml

Публичный прокси

Если значение OpanAI API Key пустое, мод использует публичный прокси-сервис оригинального проекта:

mod.aicraftingtable.com

Прямое использование OpenAI API

Если указан OpenAI API key, сервер будет напрямую обращаться к OpenAI API для генерации текста и изображений.

Написание OpanAI API Key сохранено намеренно для совместимости с существующей конфигурацией.

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

Прямое использование OpenAI требует доступа к сети, совместимой учётной записи и может приводить к расходам на API.

Запросы генерации неизбежно передают выбранному внешнему сервису:

• названия предметов в сетке крафта;
• выбранный язык;
• идентификатор игрока.

Публичный прокси работает независимо от данного порта, поэтому его постоянная доступность не гарантируется.

⏱️ Серверные лимиты

Серверные ограничения создаются в файле:

config/aicraft-server.toml

Значение cooldown должно состоять из положительного целого числа и одного из суффиксов:

• s — секунды
• m — минуты
• h — часы
• d — дни

Примеры:

30m
24h
7d

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

🛠️ Команды

Операторы с уровнем прав 2 могут удалить сгенерированный предмет и зарегистрированные для него рецепты:

/aicraft removeItem <item_id>

❤️ Авторы и благодарности

• Оригинальный мод и ресурсы: AlexLee1235 / Watermelon0117
• Оригинальная страница CurseForge: AI Crafting Table
• Порт для NeoForge 1.21.1: Softboundless

Minecraft является товарным знаком Microsoft Corporation.

Этот проект не связан и не одобрен компаниями Microsoft, Mojang Studios, NeoForged, OpenAI, а также оригинальным автором мода.

⚖️ Лицензия

Этот проект является форком/портом оригинального проекта AI Crafting Table.

Код и ресурсы upstream-проекта, происходящие из оригинального мода, продолжают распространяться по условиям MIT License. См. LICENSE-UPSTREAM.

Оригинальные изменения и дополнения, созданные Peacefull02 (AKA softboundless), распространяются по лицензии Softboundless Modifications License 1.0. См. LICENSE.

Использование изменений Softboundless в некоторых сторонних модпаках Minecraft, использующих название "Freakland", ограничено.

Ограничение не распространяется на модпаки, созданные или разрешённые Peacefull02 (AKA softboundless), в соответствии с условиями применимой лицензии.