ConTeX

ConTex is a library that enables resource pack creators to incorporate block models featuring connected textures. Connection metadata is specified within the block's state file, while geometry is derived from standard variants and/or multipart definitions present in the same state file.

For Resource Pack Creators

The library incorporates several built-in types of connected textures and connection conditions.

Available texture types:

• Simple (connects on all six faces, checks the four axis-aligned directions, ignoring diagonal block presence)
• Full (connects on all six faces, checks axis-aligned and diagonal directions for enhanced visual appeal)
• Pillars (connects only on the four faces perpendicular to a specified axis, aligned parallel to that axis)
  • Standard pillars (accounts for existing geometry rotation in the source model, requires only a vertical pillar texture, suitable for logs and similar blocks)
  • Rotating pillars (assumes no pre-existing model rotation, requires both vertical and horizontal pillar textures, suitable for blocks lacking inherent pillar behavior)
• Omni-directional pillars (similar to the rotating subtype but connects along any of the three axes in Y, X, Z order)
• Simple carpet (like simple type but limited to top and bottom surfaces)
• Full carpet (like full type but limited to top and bottom surfaces)

Built-in connection conditions:

• Same block (connects if both blocks are identical)
• Same state (connects if the block states match)
• Matching block (connects if blocks correspond to the specified block)
  • Can specify either one block for both or a "self" block and an "other" block
• Matching state (connects if block states correspond to the specified state)
  • Can specify either one state for both or a "self" state and an "other" state
• Matching tag (connects if blocks correspond to the specified block tag)
  • Can specify either one tag for both or a "self" tag and an "other" tag

For full details, refer to the wiki.

For Mod Developers

ConTex provides automated data generation tools for mod creators intending to use connected textures within their built-in resource packs. Since metadata is defined in block state files, loading these requires ConTex to be installed. To achieve optional integration, it's recommended to place ConTex-aware state files in a separate built-in resource pack registered via AddPackFindersEvent when the library is present.

Mods can also register custom texture types and connection conditions via RegisterTextureMetaEvent to incorporate unique connection behaviors beyond ConTex's standard offerings.