ConTex

ConTex 是一个前置库，允许资源包添加带有连接纹理的方块模型。
连接元数据在方块的 blockstate 文件中指定，几何模型则从同一 blockstate 文件中的标准变体和/或多部分声明中获取。

面向资源包

ConTex 提供了多种内置连接纹理类型和连接判定条件。

内置纹理类型：

• 简单型（连接六个面，只检查与坐标轴对齐的四个方向，不区分角落处的对角方块是否存在）
• 完整型（连接六个面，同时检查与坐标轴对齐的方向和对角方向，以获得更好的视觉效果）
• 柱体型（仅连接与指定轴垂直的四个面，且只沿与指定轴平行的方向连接）
  • 默认柱体类型（会考虑源模型已有的几何旋转，只需提供竖直方向的连接柱体纹理，适用于原木等柱状方块）
  • 旋转柱体类型（假定源模型没有已有旋转，需要提供竖直和水平方向的连接柱体纹理，适用于尚未内置柱状行为的方块）
• 全向柱体型（类似柱体型的旋转子类型，但可沿三个轴中的任意轴连接，并按 Y、X、Z 的顺序尝试不同轴）
• 简单地毯型（类似简单型，但仅连接顶面和底面）
• 完整地毯型（类似完整型，但仅连接顶面和底面）

内置连接判定条件：

• 相同方块（两个方块相同时连接）
• 相同状态（两个方块的方块状态相同时连接）
• 匹配方块（两个方块与指定方块匹配时连接）
  • 可指定一个方块供两侧匹配，也可分别指定“自身”方块和“另一侧”方块
• 匹配状态（两个方块的方块状态与指定方块状态匹配时连接）
  • 可指定一个方块状态供两侧匹配，也可分别指定“自身”方块状态和“另一侧”方块状态
• 匹配标签（两个方块与指定方块标签匹配时连接）
  • 可指定一个标签供两侧匹配，也可分别指定“自身”标签和“另一侧”标签

完整详情请参阅维基。

面向模组开发者

ConTex 为希望在内置资源包中使用连接纹理的模组提供了数据生成辅助工具。
由于 ConTex 采用了特定的元数据声明方式，未安装 ConTex 时，包含连接纹理元数据的 blockstate 文件将无法加载。因此，建议希望提供 ConTex 可选集成的模组，将可识别 ConTex 的 blockstate 文件放入单独的内置资源包中，并在安装 ConTex 时通过 AddPackFindersEvent 注册该资源包。

模组还可以通过 RegisterTextureMetaEvent 注册自定义纹理类型和连接判定条件，以添加 ConTex 原生不支持的自定义连接行为。