神笔马良 (Magic Brush) - 更新日志

v4.0.0 - 2026-08-26

✨ 重大更新：全种类扩充

识别种类从 60种 大幅扩充至 104种，新增 44种 生物和方块，几乎覆盖 Minecraft 1.20.1 所有常见生物和方块。

📊 识别数量统计

类别	v3.0	v4.0	新增
物品	26	26	0
生物	20	40	+20
方块	14	38	+24
总计	60	104	+44

🐛 新增生物（20种）

名称	游戏ID	画法提示
兔子	minecraft:rabbit	小身体+两只长耳朵
狐狸	minecraft:fox	尖嘴+大尾巴+三角耳
熊猫	minecraft:panda	圆身体+黑色眼圈+黑耳
海豚	minecraft:dolphin	流线型身体+背鳍
鱿鱼	minecraft:squid	圆头+下方多条触手
驴	minecraft:donkey	马身+长耳朵
山羊	minecraft:goat	头+两只角+胡子
骆驼	minecraft:camel	长脖子+驼峰+长腿
青蛙	minecraft:frog	大眼+宽身体+长腿
美西螈	minecraft:axolotl	外鳃+扁尾巴+四肢
洞穴蜘蛛	minecraft:cave_spider	比普通蜘蛛更小的体型
岩浆怪	minecraft:magma_cube	方形身体+内部纹理
僵尸猪灵	minecraft:zombified_piglin	猪脸+人形+僵尸色
猪灵	minecraft:piglin	猪脸+金色装备+人形
疣猪兽	minecraft:hoglin	野猪形+獠牙+四足
劫掠兽	minecraft:ravager	大型四足兽+宽身体
掠夺者	minecraft:pillager	人形+持弩+灰色衣服
卫道士	minecraft:vindicator	人形+持斧+深色衣服
潜影贝	minecraft:shulker	贝壳形+可开合
监守者	minecraft:warden	高大身形+发光胸口+无眼

🧱 新增方块（24种）

名称	游戏ID	必需颜色	画法提示
石头	minecraft:stone	灰	干净的灰色实心方块
木板	minecraft:oak_planks	棕	棕色方块+横向木纹
泥土	minecraft:dirt	棕	棕色方块+斑点纹理
沙子	minecraft:sand	黄	黄色方块+细斑点
砂砾	minecraft:gravel	灰	灰色方块+大斑点
砖块	minecraft:bricks	红	红色方块+砖缝纹理
石砖	minecraft:stone_bricks	灰	灰色方块+石砖缝
石英块	minecraft:quartz_block	白	白色方块+横向纹理
羊毛	minecraft:white_wool	白	白色方块+绒毛斑点
混凝土	minecraft:white_concrete	白	纯白色实心方块
木门	minecraft:oak_door	棕	竖长方形+门板纹理
梯子	minecraft:ladder	灰	两根竖杆+横向踏板
栅栏	minecraft:oak_fence	棕	多根立柱+横向连接
酿造台	minecraft:brewing_stand	不限	底座+三根瓶子
仙人掌	minecraft:cactus	绿	竖长方形+刺状突起
红石粉	minecraft:redstone_wire	红	红色线条+十字交叉
活塞	minecraft:piston	灰	方块+前部活塞头
萤石	minecraft:glowstone	黄	黄色方块+发光斑点
末地石	minecraft:end_stone	黄	黄色方块+斑点纹理
下界岩	minecraft:netherrack	红	红色方块+斑点纹理
灵魂沙	minecraft:soul_sand	灰	灰色方块+鬼脸纹理
岩浆块	minecraft:magma_block	橙	橙色方块+发光斑点
冰块	minecraft:ice	青	淡蓝色方块+冰裂纹
雪块	minecraft:snow_block	白	纯白色方块
花盆	minecraft:flower_pot	棕	上宽下窄的盆形

🔧 技术信息

• 模板总数：104个（26物品 + 40生物 + 38方块）
• 保持 v3.0 所有功能：颜色绑定识别、32x32小画布、Top3相似度显示、14色调色板
• 版本号升级至 4.0.0
• jar 大小：37.1 KB

---

v3.0.0 - 2026-08-26

✨ 重大新功能

1. 颜色绑定识别系统

• 物品必须用对应颜色画才能识别，颜色不对即使形状匹配也无法生成
• 颜色不匹配时，相似度惩罚至原来的 25%
• 26种物品全部绑定了专属颜色
• 生物类不限制颜色，方块类部分限制颜色

2. 画板尺寸缩小，全分辨率适配

• 画布从 64x64（256px）缩小为 32x32（160px）
• 自动适配屏幕高度，低分辨率设备也能完整显示

3. 识别种类扩充至60种

• 新增18种（9物品+6生物+3方块）

4. 相似度系统增强

• 识别阈值从 35% 提高至 38%
• 预览识别时显示 🥇🥈🥉 Top3 候选
• 颜色不匹配的候选标注 (需XX色)

5. 颜色选择器UI优化

• 色块加大至 18px，5列3行排列
• 选中颜色白色加粗边框高亮
• 底部显示当前笔刷和颜色名称

---

v2.0.0 - 2026-08-25

✨ 新功能

• 新增 14种颜色 调色板，彩色画笔
• 识别种类从20种扩充至42种（+22种）
• 彩色图像自动二值化识别

---

v1.0.0 - 2026-08-25

✨ 初始版本

• 神笔物品 + 64x64画板
• 20种识别（7物品+8生物+5方块）
• 左键绘画/右键擦除/笔刷调节/预览识别
• 物品、生物、方块三种生成方式
• 修复按钮被画布遮挡的问题

---

技术信息

• 模组ID: magicbrush
• 适用版本: Minecraft 1.20.1
• 加载器: Forge 47.2.0+
• Java版本: Java 17
• Gradle版本: 8.1.1
• 识别算法: 16x16 模板匹配（IoU + 召回率 + 精确率 + 颜色匹配）
• 画布分辨率: 32x32 像素
• 网络协议: Forge SimpleChannel
• 许可证: MIT

神笔马良 (Magic Brush) - 更新日志

v3.0.0 - 2026-08-26

✨ 重大新功能

1. 颜色绑定识别系统

• 物品必须用对应颜色画才能识别，颜色不对即使形状匹配也无法生成
• 颜色不匹配时，相似度惩罚至原来的 25%，基本无法通过识别
• 26种物品全部绑定了专属颜色
• 生物类不限制颜色（任何颜色都可识别）
• 方块类部分限制颜色

物品颜色对应表：

物品	必需颜色	物品	必需颜色
钻石	蓝色	煤炭	黑色
金锭	金色	红石	红色
铁锭	灰色	青金石	蓝色
苹果	红色	绿宝石	绿色
铁剑	灰色	面包	棕色
铁镐	灰色	胡萝卜	橙色
火把	橙色	弓	棕色
箭	白色	水桶	蓝色
书	棕色	钻石剑	蓝色
蛋糕	白色	西瓜	绿色
药水	不限	鞍	棕色
指南针	灰色	经验瓶	不限

2. 画板尺寸缩小，全分辨率适配

• 画布从 64x64（256px）缩小为 32x32（160px）
• 自动适配屏幕高度，低分辨率设备也能完整显示界面
• 按钮、颜色面板、相似度信息全部在右侧，不会被遮挡

3. 识别种类扩充至60种

类别	v2.0	v3.0	新增
物品	17	26	+9
生物	14	20	+6
方块	11	14	+3
总计	42	60	+18

新增物品（9种）： 钻石剑、蛋糕、西瓜、药水、鞍、指南针、经验瓶 新增生物（6种）： 烈焰人、恶魂、女巫、马、蜜蜂 新增方块（5种）： 钻石矿、木板、铁砧、附魔台、床

4. 相似度系统增强

• 识别阈值从 35% 提高至 38%，减少误识别
• 预览识别时显示 🥇🥈🥉 Top3 候选，每个候选显示名称和相似度
• 颜色不匹配的候选会标注 (需XX色) 提示
• 金/银/铜三色区分排名，一目了然
• 主颜色自动检测：计算画作中出现最多的颜色作为主色

5. 颜色选择器UI优化

• 色块从 16px 加大至 18px，更易点击
• 5列3行排列，14种颜色整齐展示
• 选中颜色有白色加粗边框高亮，状态清晰
• 底部信息栏显示当前笔刷大小和颜色名称
• 切换颜色时自动清除旧的预览结果

🔧 技术改进

• 网络包优化：32x32 位图使用 int[] 压缩传输，比 v2.0 的 long[] 更高效
• 新增主颜色字段传输（1 byte）
• 识别引擎重构：支持颜色匹配参数，颜色不匹配时应用惩罚系数
• 新增 getMainColor() 方法：自动统计画作主色调
• RecognitionResult 扩展：增加 shapeScore（纯形状分）、mainColor（主颜色）、top3（前三候选）
• 版本号升级至 3.0.0

🐛 修复

• 修复低分辨率下画布和按钮超出屏幕的问题
• 修复快速切换颜色后预览结果残留的问题

---

v2.0.0 - 2026-08-25

✨ 新功能

彩色画笔系统

• 新增 14种颜色 调色板：白、红、橙、黄、绿、青、蓝、紫、粉、棕、金、灰、黑、翠绿
• 画板右侧新增颜色选择区域，点击色块切换当前颜色
• 选中的颜色有白色边框高亮提示
• 底部信息栏显示当前笔刷大小和选中颜色名称
• 画笔光标预览使用当前颜色的半透明效果
• 识别算法优化：彩色图像自动二值化，颜色不影响形状识别

识别种类扩充（20种 → 42种）

新增物品（10种）： 煤炭、红石、青金石、绿宝石、面包、胡萝卜、弓、箭、水桶、书 新增生物（6种）： 蜘蛛、史莱姆、村民、狼、蝙蝠、铁傀儡 新增方块（6种）： 草方块、工作台、熔炉、箱子、南瓜、黑曜石

🔧 优化

• 界面布局优化：右侧面板增加颜色选择区和信息显示
• 标题更新为"神笔马良 v2.0"
• 版本号升级至 2.0.0

---

v1.0.0 - 2026-08-25

✨ 初始版本功能

核心玩法

• 新增神笔物品，右键打开 64x64 像素画板
• 左键绘画、右键擦除
• 可调节笔刷大小（0~5格）
• 圆形笔刷，拖动绘画带插值补全（快速拖动不断线）
• 「清除画布」按钮一键清空

图案识别系统

• 基于 16x16 模板匹配的识别引擎
• 识别算法：IoU（交并比）+ 召回率 + 精确率 组合评分
• 相似度低于 35% 提示"无法识别"
• 「预览识别」按钮：本地预览识别结果，不消耗生成
• 「识别并生成」按钮：发送到服务器生成对应内容

可识别内容（20种）

物品7种： 钻石、金锭、铁锭、苹果、铁剑、铁镐、火把 生物8种： 苦力怕、僵尸、骷髅、牛、猪、鸡、羊、末影人 方块5种： 圆石、橡木原木、玻璃、钻石块、TNT

生成机制

• 物品：在玩家前方生成，带向上弹起动画
• 生物：在玩家前方2格处生成
• 方块：在玩家前方2格处放置
• 聊天栏显示识别结果和相似度百分比

其他

• 创造模式专属「神笔马良」标签页
• 中文（zh_cn）+ 英文（en_us）双语支持
• 自定义画笔物品纹理
• 服务端/客户端网络通信（SimpleChannel）
• 兼容 Minecraft 1.20.1 + Forge 47.2.0+

🐛 Bug修复

• 修复画板按钮被画布遮挡、超出屏幕底部的问题
• 按钮布局从底部移至右侧垂直排列

---

技术信息

• 模组ID: magicbrush
• 适用版本: Minecraft 1.20.1
• 加载器: Forge 47.2.0+
• Java版本: Java 17
• Gradle版本: 8.1.1
• 识别算法: 16x16 模板匹配（IoU + 召回率 + 精确率 + 颜色匹配）
• 画布分辨率: 32x32 像素（v3.0）
• 网络协议: Forge SimpleChannel
• 许可证: MIT

神笔马良 (Magic Brush) - 更新日志

v2.0.0 - 2026-08-25

✨ 新功能

彩色画笔系统

• 新增 14种颜色 调色板：白、红、橙、黄、绿、青、蓝、紫、粉、棕、金、灰、黑、翠绿
• 画板右侧新增颜色选择区域，点击色块切换当前颜色
• 选中的颜色有白色边框高亮提示
• 底部信息栏显示当前笔刷大小和选中颜色名称
• 画笔光标预览使用当前颜色的半透明效果

识别种类大幅扩充（20种 → 42种）

新增物品（10种）：

名称	游戏ID	画法提示
煤炭	minecraft:coal	画一个黑色实心方块
红石	minecraft:redstone	画红色散点/粉末形状
青金石	minecraft:lapis_lazuli	画蓝色菱形
绿宝石	minecraft:emerald	画绿色椭圆
面包	minecraft:bread	画棕色长椭圆
胡萝卜	minecraft:carrot	画橙色三角，顶部带叶子
弓	minecraft:bow	画一个弧形（C形）
箭	minecraft:arrow	画尖头+尾部羽毛
水桶	minecraft:water_bucket	画桶形（上宽下窄）
书	minecraft:book	画长方形，左侧带书脊线

新增生物（6种）：

名称	游戏ID	画法提示
蜘蛛	minecraft:spider	圆身体+8条腿（上下各4条）
史莱姆	minecraft:slime	绿色方块，带眼睛
村民	minecraft:villager	人形，突出的大鼻子
狼	minecraft:wolf	狗形，长嘴+尾巴
蝙蝠	minecraft:bat	翅膀展开的形状
铁傀儡	minecraft:iron_golem	高大强壮的铁人形

新增方块（6种）：

名称	游戏ID	画法提示
草方块	minecraft:grass_block	方块，顶部画绿色纹理
工作台	minecraft:crafting_table	方块，画格子纹理
熔炉	minecraft:furnace	方块，前脸画开口
箱子	minecraft:chest	方块，中间画锁/缝隙
南瓜	minecraft:pumpkin	圆形，画三角眼睛和嘴
黑曜石	minecraft:obsidian	深色实心方块，带紫色纹理

🔧 优化与改进

• 识别算法优化：彩色图像自动二值化处理，颜色不影响形状识别
• 界面布局优化：右侧面板增加颜色选择区和信息显示
• 标题更新为"神笔马良 v2.0"
• 版本号升级至 2.0.0

📊 识别统计

类别	v1.0	v2.0	新增
物品	7	17	+10
生物	8	14	+6
方块	5	11	+6
总计	20	42	+22

---

v1.0.0 - 2026-08-25

✨ 初始版本功能

核心玩法

• 新增神笔物品，右键打开 64x64 像素画板
• 左键绘画、右键擦除
• 可调节笔刷大小（0~5格）
• 圆形笔刷，拖动绘画带插值补全（快速拖动不断线）
• 「清除画布」按钮一键清空

图案识别系统

• 基于 16x16 模板匹配的识别引擎
• 识别算法：IoU（交并比）+ 召回率 + 精确率 组合评分
• 相似度低于 35% 提示"无法识别"
• 「预览识别」按钮：本地预览识别结果，不消耗生成
• 「识别并生成」按钮：发送到服务器生成对应内容

可识别内容（20种）

物品7种： 钻石、金锭、铁锭、苹果、铁剑、铁镐、火把 生物8种： 苦力怕、僵尸、骷髅、牛、猪、鸡、羊、末影人 方块5种： 圆石、橡木原木、玻璃、钻石块、TNT

生成机制

• 物品：在玩家前方生成，带向上弹起动画
• 生物：在玩家前方2格处生成
• 方块：在玩家前方2格处放置
• 聊天栏显示识别结果和相似度百分比

其他

• 创造模式专属「神笔马良」标签页
• 中文（zh_cn）+ 英文（en_us）双语支持
• 自定义画笔物品纹理
• 服务端/客户端网络通信（SimpleChannel）
• 兼容 Minecraft 1.20.1 + Forge 47.2.0+

🐛 Bug修复

• 修复画板按钮被画布遮挡、超出屏幕底部的问题
• 按钮布局从底部移至右侧垂直排列

---

技术信息

• 模组ID: magicbrush
• 适用版本: Minecraft 1.20.1
• 加载器: Forge 47.2.0+
• Java版本: Java 17
• Gradle版本: 8.1.1
• 识别算法: 16x16 模板匹配（IoU + 召回率 + 精确率）
• 画布分辨率: 64x64 像素
• 网络协议: Forge SimpleChannel

v1.0.0

• 新增神笔物品，右键打开64x64画板
• 支持20种图案识别（7物品+8生物+5方块）
• 左键绘画、右键擦除、可调节笔刷大小
• 预览识别功能，确认后再生成
• 修复按钮被画布遮挡的问题