[Immersive Vehicles Add-on] IV Paint

IV Paint

使用完整的 RGB 色彩控制，为任意 Immersive Vehicles 汽车重新喷漆——完全在游戏内完成，无需编辑纹理。

IV Paint 为 Minecraft 添加了一个喷漆物品，可打开简洁的颜色编辑器，为任意 Immersive Vehicles (MTS) 载具更改颜色。替换出厂颜色、为单个部件着色、将喜欢的颜色保存到调色板，还能将更改同步给服务器上的所有玩家——全程无需接触任何纹理文件。

✨ 功能

🎨 HSV 颜色选择器

借助完整的色相环、饱和度/明度方块和亮度条，你可以精准调出任意颜色。也支持直接输入 HEX 值，精确指定颜色。

🔄 替换模式

IV Paint 会采样载具的 UV 贴图，检测纹理上的所有颜色。从颜色列表中选择检测到的颜色，选好替换颜色，然后点击▶ 应用颜色。选定颜色会在整个纹理区域中被替换——非常适合为整个车身重新喷漆。

🖌️ 部件颜色模式

此模式不会修改纹理，而是为单个 OBJ 部件添加乘法色调。适合精细调整特定面板或组件的颜色。注意：着色效果会受到基础纹理亮度影响——纹理越亮，颜色越准确。

🗂️ OBJ 分组系统

部件会根据完全可自定义的 JSON 配置文件自动归入逻辑分组，例如车身、保险杠、引擎盖、扰流板、轮辋等。支持通配符模式（"hood"），方便灵活匹配不同载具整合包中的部件。

🎛️ 高级设置（ADV）

通过 GUI 中的两个滑块即时微调颜色检测——无需重启：

• 阈值 — 用于判断两个采样颜色是否“相同”的欧几里得距离（0–441）。调高可识别近似色；调低则仅匹配完全相同的颜色。
• 最小占比 — 某种颜色在 UV 贴图中至少需要覆盖的比例，才会显示在列表中（0.000–1.000）。可用于过滤掉不想修改的微小细节颜色。

🎴 调色板

可保存 56 个颜色色块，并在整个游戏会话期间保留。左键点击色块可将其颜色载入选择器；右键点击可用当前颜色覆盖该色块。专用的+ 保存按钮会自动填入下一个空位。

📖 交互式教程

刚开始使用 IV Paint？点击 GUI 右上角的? 帮助按钮。教程会通过 4 个步骤逐一高亮界面区域并进行说明，带你从选择颜色一直了解高级设置。教程完整支持英语、日语、中文、俄语和韩语——会根据你的 Minecraft 语言设置自动选择语言。

📦 需求

⚠️ IV Paint需要 Immersive Vehicles (MTS) 23.0.0，没有它将无法运行。你还需要至少安装一个兼容 MTS 的载具整合包——IV Paint 本身不包含载具。*此附加模组也可搭配 Immersive Vehicles 23.0.0 以外的版本使用，但请注意，无法保证其正常运行。

🔧 安装

1. 确保已为 Minecraft 1.20.1 安装Minecraft Forge 47.x。
2. 从 CurseForge 页面下载并安装 Immersive Vehicles (MTS) 23.0.0。
3. 从此页面下载最新版本的 IV Paint 。
4. 将 .jar 文件放入 .minecraft/mods/ 文件夹。
5. 启动游戏。首次运行时，IV Paint 会在以下位置生成配置文件：

   config/gtbench/paintshop_config.json
   

6. 制作或获得一个喷漆物品，右键点击任意 MTS 载具，即可开始喷漆。

⚠️ 注意事项与免责声明

• 颜色变化在客户端渲染，并通过数据包同步到服务端。磁盘上的原始载具纹理文件绝不会被修改。
• PART_COLOR 模式使用乘法混合。最终外观取决于底层纹理 — 白色或接近白色的基础纹理能给出最可预测的结果。
• 从现有存档中移除 IV Paint 会导致已应用的颜色在下次加载时恢复为载具的默认纹理。
• 与载具包的兼容性各不相同。如果 OBJ 名称与常见约定不同，可以更新配置文件以匹配。（不过，某些 obj 名称即使已注册也可能无法被识别。请事先理解这一点。）
• 本模组处于测试阶段，可能会出现意外行为。请事先知悉。

请务必在 Discord 服务器上报告 bug 和问题。

VellEagle Mods 信息服务器

*本项目使用生成式 AI 创建代码。