自动连接纹理

自动连接纹理

《我的世界》自动连接纹理，可在游戏内编辑和导出。

AutoSeamBlend

为 Minecraft 方块自动生成连接纹理——无需方块列表，无需手动纹理。在游戏内即可预览、绘制并导出。

这是什么？

在 Minecraft 中，将相同的方块相邻放置时，两个表面之间常常会看到明显的接缝——玻璃板就是最经典的例子。连接纹理能让相邻的表面自然地融合在一起，使一整面墙看起来像是一整块连续的方块，而不是许多独立的方块拼贴。

AutoSeamBlend 可以自动为你完成这一切：

  • 它自己就能找到合适的方块（无需手动填写列表）；
  • 它为每个方块选择合适的连接样式；
  • 它自动生成缺失的纹理状态。

它是知名的连接纹理引擎的附属模组。安装任意一个引擎后，AutoSeamBlend 即可立即使用。

功能特性

  • 自动发现 — AutoSeamBlend 会分析每个方块的实际建模和渲染方式，然后自行挑选合适的候选方块。
  • 游戏内 GUI — 输入 /autoseamblend 即可打开编辑器：查看哪些方块已经使用了连接纹理，并添加你自己的方块。
  • 真实 3D 预览 — 实时查看连接效果，可添加相邻方块、旋转和缩放。所见即游戏实际渲染效果。
  • 像素绘制 — 使用游戏内的像素编辑器（画笔、橡皮擦、取色器、填充、撤销/重做）调整方块六个面的纹理。
  • 原生属性编辑 — 以你的引擎所理解的格式修改连接属性，不会破坏现有的资源包。
  • 一键导出 — 导出一个即用型的“烘焙”资源包，即使未安装 AutoSeamBlend 也能加载（你仍需安装连接纹理引擎）。
  • 尊重你的资源包 — 已有的纹理和作者制作的內容永远不会被覆盖；AutoSeamBlend 只会补全缺失的部分。

快速开始

  1. 为你的 Minecraft 版本和加载器安装 AutoSeamBlend。

  2. 安装 Fzzy Config（必需）以及以下引擎中的任意一个：

    可用的引擎取决于版本和加载器（例如，某些 Fabric 版本没有 CTM 适配器）。在某些加载器上，还需要 Fabric API 和 Fabric Language Kotlin。UI 库（UILib）已随模组打包——无需额外安装。

  3. 启动游戏。输入 /autoseamblend 打开 GUI，或输入 /autoseamblend export 导出烘焙资源包。

配置与优先级

AutoSeamBlend 有三个配置入口。其优先级从高到低为：

  1. 第三方资源包 — 由任何资源包以你的引擎原生格式编写的连接规则（例如 Continuity 的 OptiFine 风格/MCPatcher 资源包，以及 CTM、Fusion 和 Athena 规则）。这是最高优先级来源；AutoSeamBlend 永远不会覆盖资源包作者编写的内容。
  2. 内置资源包 — 当你在游戏内 GUI（/autoseamblend）中添加方块并保存时创建。它位于 resourcepacks/AutoSeamBlend Managed/ 中，只会补全第三方资源包未覆盖的部分。
  3. 配置文件 — config/autoseamblend/autoseamblend.json5（Fzzy Config）。最适合手动添加或排除方块；它的优先级最低，仅在没有更高优先级来源匹配时才会生效。

优先级规则：第三方资源包 > 内置资源包 > 配置文件。当更高优先级来源匹配时，低优先级来源永远不会覆盖它。当没有更高优先级来源匹配时，低优先级来源将完全生效，并仅补全缺失的纹理状态。

常用配置字段：

  • automaticDiscovery — 自动发现开关，默认为 true；
  • targets — 按方式分类添加目标方块，例如在 targets.auto.non-compatibility 下添加 "minecraft:stone"，或使用 "#minecraft:stone" 将整个标签设为一个连接组；
  • excludedTargets — 明确排除你不想处理的方块。

编辑配置文件后，请重新加载游戏资源以应用更改（例如按 F3+T 或重启游戏）。

环境要求

  • 仅客户端 — 可在单人游戏和任何服务器上使用；服务器无需安装此模组。
  • 必需：Fzzy Config。
  • 至少一个上述受支持的连接纹理引擎。
  • 如果安装了多个引擎，AutoSeamBlend 会自动选择正确的引擎。

常见问题

游戏内没有任何变化？ 请确保至少安装并启用了其中一个引擎。没有引擎的情况下，AutoSeamBlend 只会显示诊断界面。

我需要在服务器上安装它吗？ 不需要 — AutoSeamBlend 是纯客户端模组。

它会修改我的存档或资源包吗？ 不会。它只会在你保存时写入自己的“AutoSeamBlend Managed”资源包，导出的内容会放在你选择的独立文件夹中。

为什么某个特定的方块没有连接效果？ 自动发现基于方块的实际模型和纹理行为。具有特殊动态渲染的方块可能无法被自动识别——你仍然可以在 GUI 或配置文件中手动添加并编辑它们。

我应该选择哪个引擎？ 列表中任意一个都可以。它们内部使用不同的格式，但编辑和导出的工作流程是相同的。

我可以与其他人分享我的成果吗？ 可以 — 导出的烘焙包就是一个普通的资源包。任何安装了相同引擎的人都可以使用它，即使没有安装 AutoSeamBlend。

它与其他模组兼容吗？ 当然 — 这正是它的设计初衷！

许可证与致谢

  • 作者：kltyton
  • 许可证：LGPL-3.0-or-later
  • AutoSeamBlend 基于 Continuity/NeoContinuity、CTM、Fusion、Athena、Fzzy Config 和 UILib 的公共 API 构建。感谢所有这些项目。