mcai

# mcAI Forge 1.0.1 — Minecraft 1.20.1

Fixes the 1.0.0 jar, which shipped **without `pack.mcmeta`** and therefore had no
working resources at all.

## Fixed

**Item models, textures and all 8 language files did not load.**

1.0.0 produced this in the log:

```
WARN Pack: Missing metadata in pack mod:mcai
WARN ModelBakery: Unable to load model: 'mcai:ai_model_switcher#inventory'
     java.io.FileNotFoundException: mcai:models/item/ai_model_switcher.json
```

The models **were** in the jar. Forge needs `pack.mcmeta` for a mod's resource
pack to be accepted; without it the whole pack is skipped, so every `mcai:`
resource — models, textures, translations — disappeared. Added. Verified against
a known-good Forge 1.20.1 mod (FerriteCore) that ships the same file.

Because the 1.0.0 item models never resolved, the two switcher items would have
shown as the purple/black missing texture. Language strings would have shown as
raw keys such as `mcai.cmd.status`.

## Added

**Switchable screen background** for `/ai config`, the region-select screen and
the send-preview screen — `/ai config` → **Screen background**:

| | |
| --- | --- |
| **Dim (vanilla)** | dark gradient over the game. Default — identical to before. |
| **Dirt** | classic tiled dirt background. |
| **Transparent** | no background; the game shows through. |
| **Custom image** | tiles any local PNG/JPG/WEBP you point it at. |

There is deliberately **no "blurred" option on 1.20.1**: menu blur
(`Screen.applyBlur` → `GameRenderer.renderBlur`) is a 1.21 API. It does not exist
in 1.20.1 — the ESC pause menu is not blurred there either.

A bad image path never breaks the screen: it logs a warning and falls back to the
dark gradient.

## Better logging

1.0.0 gave no way to tell whether the client-side modules had actually loaded. Now
each stage logs:

```
mcAI client modules: registering event listeners
mcAI client modules: 8 listeners registered (tick, commands, hud, chat, join, leave, item-use)
mcAI key mappings registered: H, G, R, V (screenshots) and B (widget bubble)
mcAI registered the /ai client command tree
mcAI: joined a world, scope = ...
```

## Requirements

Minecraft **1.20.1** · Forge **47.x** · **Java 17**

## Status

Compiles clean; 1.0.0 was also confirmed to load in a real game (mod
constructed, items registered, a world entered). The background feature in this
build has **not** been run yet.

## 中文

**修复**：1.0.0 的 jar 漏了 `pack.mcmeta`，导致模组资源包被跳过——物品模型、贴图、
8 个语言文件**全部不加载**。物品会显示成紫黑缺失贴图，文字会显示成 `mcai.cmd.status`
这样的原始键名。已补上。

**新增**：`/ai config`、框选截图、发送预览三个界面支持**可切换背景**——暗色渐变（原版默认）/
泥土 / 透明 / 自定义图片。**1.20.1 没有"模糊"选项**：菜单模糊是 1.21 才有的 API，
1.20.1 的 ESC 菜单本身也不模糊。

**日志**：补齐了客户端各环节的诊断日志，出问题能直接从日志定位。