艺术地图工坊

ArtMap Workshop

ArtMap Workshop 是一个客户端 Fabric 模组，旨在让使用 ArtMap 创作画作变得更简单、更精确、更易上手。

它并非简单地在屏幕上显示参考图像，而是将像素指南直接投射到 Minecraft 世界中检测到的物品展示框上。叠加层会以 3D 空间的形式附着在画布上，并随着你移动或旋转视角而保持正确的透视关系。

本项目的目标是为所有人提供舒适的绘画工作流程，包括那些难以分辨颜色、难以定位单个像素，或需要处理大型复杂图像的玩家。

---

✨ 主要功能

🖼️ 图像导入与准备

直接从 ArtMap Workshop 图像文件夹导入你自己的 PNG、JPG 或 JPEG 图像。

模组可以自动为 ArtMap 的 32×32 画布系统准备图像。

可用的缩放模式包括：

• 透明填充
• 保持宽高比缩放
• 拉伸至最接近的 32 像素倍数

大型图像也可以自动分割为多个 32×32 画布。

---

🎨 ArtMap 调色板转换

导入的图像会转换为所配置的 ArtMap 调色板中最接近的可用颜色。

每个像素可以提供如下信息：

• 调色板编号
• 颜色名称
• 所需绘画方法
• 像素坐标
• 完成状态

这意味着你不必再通过视觉来辨认每一种颜色。

调色板数据单独存储，以便在获得更精确的颜色测量数据后对其进行细化和更新。

---

🧱 物品展示框画布检测

看向 ArtMap 画布并按下 C。

ArtMap Workshop 会检测用作绘画画布的物品展示框，并将其作为叠加层的参考表面。

---

🌐 透视正确的 3D 叠加层

绘画指南直接渲染在 Minecraft 的 3D 世界中。

与普通的屏幕叠加层不同，指南会保持附着在检测到的画布上。

你可以：

• 向左或向右移动
• 靠近或远离
• 从某个角度观察画布
• 旋转视角

而叠加层会持续跟随画布的透视关系。

叠加层的深度也可以调整，以便当 ArtMap 画布在物品展示框前方具有厚度时，指南仍然保持可见。

---

🎯 准星像素引导

你无需手动在 32×32 网格上移动单独的光标。

只需将 Minecraft 准星对准叠加层上的某个像素。

ArtMap Workshop 会自动确定你正在看向的像素，并在 HUD 上显示其信息。

例如：

像素 14, 7
调色板 023 — 草绿色
绘画指令：煤炭 ×1

这让你只需看向想要绘制的像素，即可自然地工作。

---

✅ 手动标记像素完成

ArtMap Workshop 刻意不会自动将像素标记为已完成。

在绘制完一个像素并确认无误后，按下 X。

该像素随后会被记录为已完成。

如果你不小心标记了错误的像素，按下 Z 即可撤销。

这套手动确认系统旨在提高准确性，同时让进度跟踪依然便捷。

---

📊 进度跟踪

ArtMap Workshop 可以跟踪你的绘画进度。

HUD 可以显示：

• 当前画布
• 当前工作颜色
• 该颜色剩余的像素数
• 准星所指像素的坐标
• 调色板信息
• 绘画指令
• 像素完成状态
• 总体进度

进度会被保存，因此你可以退出游戏后再继续你的画作。

---

🎨 以颜色为中心的工作流程

你可以一次专注于一种 ArtMap 颜色。

例如：

调色板 023 — 草绿色
剩余：47 个像素

叠加层可以仅显示需要当前所选颜色的像素。

一旦这些像素完成，你就可以继续处理下一种颜色。

这可以显著减少在绘画材料之间不必要的切换。

---

🔍 多种工作模式

ArtMap Workshop 提供多种显示绘画指南的方式：

• 完整画布
• 当前行
• 当前颜色
• 未完成的像素
• 当前像素

选择最适合你画作的工作流程即可。

---

♿ 无障碍辅助

无障碍是 ArtMap Workshop 的主要目标之一。

色觉无障碍

玩家无需仅依赖视觉颜色识别。

当准星指向某个像素时，ArtMap Workshop 会提供文字信息，例如：

• 调色板编号
• 颜色名称
• 绘画指令
• 像素坐标
• 完成状态
• 剩余像素数

这让玩家可以通过基于文字的信息来识别和还原颜色，而不必仅依赖每种颜色的视觉外观。

此功能旨在帮助有色觉差异的玩家，以及任何觉得难以区分相似 ArtMap 颜色的人。

---

⚙️ 简洁的选项卡界面

按下 F9 打开 ArtMap Workshop 界面。

设置分为四个类别：

图像

图像选择、图像文件夹访问以及 32×32 准备。

工作

画布检测、工作模式、颜色选择以及进度控制。

无障碍

可见性与无障碍辅助。

设置

叠加层不透明度、深度、HUD、网格以及渲染选项。

F9 菜单主要用于初始设置。

在正常绘画过程中，大部分交互都可以直接通过准星和键盘快捷键完成。

---

⌨️ 重要操作

按键	功能
F6	切换 3D 叠加层
F8	重新加载所选图像
F9	打开 ArtMap Workshop
C	检测物品展示框画布
V	切换工作模式
B	切换无障碍模式
P	选择下一个工作颜色
X	将准星所指像素标记为已完成
Z	撤销准星所指像素的完成标记
M	将当前画布标记为已完成
[ / ]	上一个 / 下一个 32×32 画布
PageUp / PageDown	调整叠加层深度
, / .	调整叠加层不透明度

---

📦 环境要求

• Minecraft 1.21.4
• Fabric Loader
• Fabric API
• 客户端安装

服务器无需安装 ArtMap Workshop。

---

⚠️ Alpha 版本

ArtMap Workshop 目前处于 Alpha 阶段。

功能、按键绑定、调色板数据、渲染行为以及用户界面在开发过程中可能会发生变化。

如果你遇到问题，请尽可能提供详细的信息进行反馈。

---

重要提示

ArtMap Workshop 是一个绘画辅助工具。

它不会自动绘制 ArtMap 画布、不会自动与服务器交互，也不会替代玩家的绘画操作。

实际绘画由玩家完成，完成的像素由玩家手动确认。

---

❤️ 项目目标

ArtMap Workshop 的诞生源于一个简单的目标：

让 ArtMap 绘画对每个人来说都更简单、更易上手。

无论你是在创作你的第一幅 ArtMap 画作、正在处理一个大型多画布项目、难以分辨颜色，还是只是想要一个更有条理的工作流程，ArtMap Workshop 都旨在帮助你一步一步完成你的画作。