ApertureMapsLib

ApertureMapsLib is a library for Minecraft Forge 1.12.2 that allows large rectangular textures to be used safely in the vanilla atlas.

!Demonstration of non-standard textures in the game - on blocks

If you create wallpapers, panels, tiles, or other patterns that span multiple blocks at once (for example 7×4 or 20×12), you may have run into issues like these:

• texture loading crashes
• cropped or corrupted textures in the atlas
• visual seams and artifacts
• incorrect behavior with CTM

This library is designed specifically to solve those cases.

---

How does it work?

The library does not require any code integration.
You only need to place a .png.mcmeta file next to the texture:

{
  "aperturemapslib": true
}

Example with ConnectedTexturesMod (CTM) Pattern size: 10×5 blocks

{
  "ctm": {
    "ctm_version": 1,
    "type": "pattern",
    "extra": {
      "width": 10,
      "height": 5
    }
  },
  "aperturemapslib": {
    "enabled": true
  }
}

After that, the fixes are applied automatically only to the textures that need them.

---

What does the library do?

• Allows rectangular textures to be used without errors
• Protects them from cropping and atlas conflicts
• Disables problematic transformations such as rotation and scaling
• Fixes pattern-rendering issues when CTM is present

---

Requirements

• Minecraft 1.12.2
• Forge 14.23.x
• CTM (ConnectedTexturesMod)

---

Who is this for?

Modders working with non-standard textures and creating their own block mods with CTM support.

---

Important

• Use the library only where it is actually needed
• Texture dimensions must be divisible by 16
• The atlas may become larger in size — this is the normal tradeoff for correct rendering

---

Credits

Special thanks to the Chisel Team for ConnectedTexturesMod (CTM), which inspired part of the solution and made pattern textures possible in the first place.

Project Telegram channel: KharkivTiles 1:1

GitHub: Github/ApertureMapsLib