画家

Painter

在不破坏建筑的前提下重新上色。 Painter 为你提供了一把专用的画笔，可以在光标周围一定半径内将现有方块替换为新方块 —— 将圆石墙变成石砖，在三种地板方块间随机铺设，或是在表面上手绘像素画图案，全程无需手动敲掉和替换任何方块。

设计上对生存模式友好：绘画会消耗你物品栏中匹配的方块，并退还被替换的方块，因此不仅限于创造模式，在生存世界中同样平衡。

✨ 功能特性

一把专用画笔物品 —— 使用原版刷子 + 白色染料合成。它不会影响常规的考古刷子，因此考古刷子仍可正常用于清理。

两种绘画方式：

• 随机 —— 每次点击都会从你的调色板中抽取一个全新的、带权重的随机方块。非常适合营造自然变化（例如将石头、圆石和苔石混合在一起）。
• 自定义 —— 将精确到每个格子的模板绘制到画笔的网格上。将特定方块分配到特定格子，用于制作棋盘格、边框或手工设计的像素图案，剩余的空格仍会从调色板中随机抽取。

完整的游戏内配置界面（按住 Shift + 右键点击画笔）：

• 可搜索、可滚动的方块选择器，包含游戏中的所有方块 —— 包括其他已安装模组中的方块
• 多选方块，然后一键添加到你的调色板或蒙版中
• 调色板权重通过滑块 + 数字输入框调节，并始终保持总和为 100%
• 自定义模式的可视化网格编辑器 —— 点击单元格，点击方块，完成
• 画笔尺寸（1–5）和形状（方形 / 圆形 / 菱形）

蒙版功能 —— 将绘画限制为仅替换特定方块（“只替换石头和泥土”），或反向操作以排除某些方块（“除玻璃外均可绘制”）。

内置安全机制：

• /paintbrush undo 可撤销你上一次的绘画操作 —— 方块和物品栏都会回滚
• 在两次绘画之间设有短暂冷却时间，防止按住右键时向服务器发送大量方块更新请求
• 矿石不会被复制 —— 在矿石上绘画会将其销毁，而不会返还一个免费物品
• 易碎和结构性方块（门、床、楼梯、台阶、方块实体等）会受到保护，防止误操作

所有功能也可通过命令使用，如果你不想打开 GUI 的话 —— 在游戏中输入 /paintbrush help 查看完整命令列表。

🧠 使用方法

1. 合成一把 画笔（刷子 + 白色染料）。
2. 手持画笔并 Shift + 右键点击 打开配置界面。
3. 搜索方块，选中它们，然后添加到你的 调色板（用于绘画成的方块），并可选择添加到 蒙版（用于绘画到的方块）。
4. 选择 随机 或 自定义 模式，设置画笔尺寸/形状，然后点击 应用。
5. 右键点击一个方块进行绘画。再次右键点击以继续。
6. 犯错了？使用 /paintbrush undo。

📋 环境要求

• Minecraft 1.20.1
• Forge 47.2.0 或更高版本
• Java 17

💬 反馈

本模组持续维护中 —— 欢迎通过问题追踪器提交 Bug 报告和功能建议。