Описание
# AI Crafting Table — NeoForge Port
**Unofficial port of AI Crafting Table for Minecraft 1.21.1 + NeoForge**
[](https://www.minecraft.net/)
[](https://neoforged.net/)
[](https://www.oracle.com/java/)
[](#compatibility)
[](#license)
---
# English
> This is an **unofficial NeoForge 1.21.1 port** of
> [AI Crafting Table](https://github.com/AlexLee1235/AICraftingTable), 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
| Component | Version |
| --- | --- |
| **Minecraft** | `1.21.1` |
| **Mod loader** | `NeoForge 21.1.241` |
| **Java** | `21` |
| **Mod version** | `1.2.0` |
| **Mod ID** | `aicraft` |
> 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:
```text
D
DCD
D
```
- `D` — Diamond
- `C` — Crafting Table
---
## 🤖 AI service configuration
The common configuration file is generated at:
```text
config/aicraft-common.toml
```
### Public proxy
When `OpanAI API Key` is empty, the mod uses the original project's public
proxy service:
```text
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:
```text
config/aicraft-server.toml
```
| Setting | Default | Meaning |
| --- | ---: | --- |
| `ideaRequestsPerCooldown` | `50` | Accepted idea-generation requests per player |
| `craftsPerCooldown` | `5` | AI-item crafts per player |
| `cooldown` | `24h` | Rolling cooldown window |
The cooldown value must be a positive integer followed by:
- `s` — seconds
- `m` — minutes
- `h` — hours
- `d` — days
Examples:
```text
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:
```text
/aicraft removeItem
```
---
## ❤️ Credits
- **Original mod and assets:** [AlexLee1235 / Watermelon0117](https://github.com/AlexLee1235/AICraftingTable)
- **Original CurseForge project:** [AI Crafting Table](https://www.curseforge.com/minecraft/mc-mods/aicraftingtable)
- **NeoForge 1.21.1 port:** [Softboundless](https://github.com/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`](https://github.com/softboundless/AICraftingTable-NeoForge/blob/neoforge-1.21.1/LICENSE-UPSTREAM).
Original modifications and contributions created by
**Peacefull02 (AKA softboundless)** are licensed under the
**Softboundless Modifications License 1.0**. See [`LICENSE`](https://github.com/softboundless/AICraftingTable-NeoForge/blob/neoforge-1.21.1/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](https://github.com/AlexLee1235/AICraftingTable),
> изначально созданного **AlexLee1235 / Watermelon0117** для
> Minecraft 1.19.2 Forge.
>
> Порт поддерживается независимо и **не является официальным релизом**
> оригинального автора.
## ✨ О моде
**AI Crafting Table** позволяет превращать обычную раскладку ингредиентов
3×3 в совершенно новые предметы Minecraft, сгенерированные с помощью ИИ.
Процесс создания предмета выглядит так:
1. Поместите ингредиенты в AI Crafting Table.
2. Запросите **три идеи предметов**, основанные на ингредиентах и их
расположении.
3. Выберите одну из предложенных идей.
4. Настроенный ИИ-сервис сгенерирует свойства и текстуру предмета.
5. Заберите готовый предмет, чтобы зарегистрировать его рецепт в текущем мире.
Сгенерированные предметы могут работать как **инструменты, оружие, еда или
обычные предметы** — это зависит от полученных при генерации свойств.
Рецепты, данные предметов, текстуры и персональные лимиты игроков сохраняются
сервером и синхронизируются с подключёнными клиентами. Ранее созданные рецепты
также доступны через интеграцию мода с системой крафта.
---
## 🧩 Совместимость
| Компонент | Версия |
| --- | --- |
| **Minecraft** | `1.21.1` |
| **Загрузчик модов** | `NeoForge 21.1.241` |
| **Java** | `21` |
| **Версия мода** | `1.2.0` |
| **Mod ID** | `aicraft` |
> Порт собирался и тестировался на **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 создаётся из **четырёх алмазов**, расположенных вокруг
обычного верстака:
```text
D
DCD
D
```
- `D` — алмаз
- `C` — верстак
---
## 🤖 Настройка ИИ-сервиса
Общий конфигурационный файл создаётся по адресу:
```text
config/aicraft-common.toml
```
### Публичный прокси
Если значение `OpanAI API Key` пустое, мод использует публичный прокси-сервис
оригинального проекта:
```text
mod.aicraftingtable.com
```
### Прямое использование OpenAI API
Если указан OpenAI API key, **сервер** будет напрямую обращаться к OpenAI API
для генерации текста и изображений.
> Написание `OpanAI API Key` сохранено намеренно для совместимости с
> существующей конфигурацией.
>
> API-ключ хранится локально в **открытом текстовом виде**. Никогда не
> публикуйте заполненный конфигурационный файл, не добавляйте его в Git и не
> передавайте клиентам.
Прямое использование OpenAI требует доступа к сети, совместимой учётной записи
и может приводить к расходам на API.
Запросы генерации неизбежно передают выбранному внешнему сервису:
- названия предметов в сетке крафта;
- выбранный язык;
- идентификатор игрока.
Публичный прокси работает независимо от данного порта, поэтому его постоянная
доступность не гарантируется.
---
## ⏱️ Серверные лимиты
Серверные ограничения создаются в файле:
```text
config/aicraft-server.toml
```
| Параметр | По умолчанию | Значение |
| --- | ---: | --- |
| `ideaRequestsPerCooldown` | `50` | Принятые запросы на генерацию идей для одного игрока |
| `craftsPerCooldown` | `5` | Количество созданий ИИ-предметов для одного игрока |
| `cooldown` | `24h` | Скользящий период восстановления лимита |
Значение `cooldown` должно состоять из положительного целого числа и
одного из суффиксов:
- `s` — секунды
- `m` — минуты
- `h` — часы
- `d` — дни
Примеры:
```text
30m
24h
7d
```
> Принятый запрос генерации расходует лимит даже в том случае, если внешний
> сервис позже вернёт ошибку.
---
## 🛠️ Команды
Операторы с **уровнем прав 2** могут удалить сгенерированный предмет и
зарегистрированные для него рецепты:
```text
/aicraft removeItem
```
---
## ❤️ Авторы и благодарности
- **Оригинальный мод и ресурсы:** [AlexLee1235 / Watermelon0117](https://github.com/AlexLee1235/AICraftingTable)
- **Оригинальная страница CurseForge:** [AI Crafting Table](https://www.curseforge.com/minecraft/mc-mods/aicraftingtable)
- **Порт для NeoForge 1.21.1:** [Softboundless](https://github.com/softboundless)
Minecraft является товарным знаком Microsoft Corporation.
Этот проект не связан и не одобрен компаниями **Microsoft, Mojang Studios,
NeoForged, OpenAI**, а также оригинальным автором мода.
---
## ⚖️ Лицензия
Этот проект является форком/портом оригинального проекта
**AI Crafting Table**.
Код и ресурсы upstream-проекта, происходящие из оригинального мода, продолжают
распространяться по условиям **MIT License**. См.
[`LICENSE-UPSTREAM`](https://github.com/softboundless/AICraftingTable-NeoForge/blob/neoforge-1.21.1/LICENSE-UPSTREAM).
Оригинальные изменения и дополнения, созданные
**Peacefull02 (AKA softboundless)**, распространяются по лицензии
**Softboundless Modifications License 1.0**. См. [`LICENSE`](https://github.com/softboundless/AICraftingTable-NeoForge/blob/neoforge-1.21.1/LICENSE).
> Использование изменений Softboundless в некоторых сторонних модпаках
> Minecraft, использующих название **"Freakland"**, ограничено.
>
> Ограничение **не распространяется** на модпаки, созданные или разрешённые
> **Peacefull02 (AKA softboundless)**, в соответствии с условиями применимой
> лицензии.