ApertureMapsLib 是用于 Minecraft Forge 1.12.2 的一个库,它允许在原版纹理图集(atlas)中安全地使用大型矩形纹理。

如果您正在制作跨越多个方块的一次性壁纸、面板、瓷砖或其他图案(例如 7×4 或 20×12),您可能遇到过以下问题:
- 纹理加载崩溃
- 图集中纹理被裁剪或损坏
- 视觉接缝和伪影
- 与 CTM 配合时行为异常
本库正是为了解决这些情况而设计的。
工作原理
该库无需任何代码集成。
您只需在纹理旁边放置一个 .png.mcmeta 文件:
{
"aperturemapslib": true
}
带有 ConnectedTexturesMod (CTM) 模式的示例:模式大小为 10×5 个方块
{
"ctm": {
"ctm_version": 1,
"type": "pattern",
"extra": {
"width": 10,
"height": 5
}
},
"aperturemapslib": {
"enabled": true
}
}
此后,修复措施将自动仅应用于需要它们的纹理。
库的功能
- 允许无错误地使用矩形纹理
- 防止纹理被裁剪及图集冲突
- 禁用旋转和缩放等存在问题的变换操作
- 修复存在 CTM 时的图案渲染问题
依赖要求
- Minecraft 1.12.2
- Forge 14.23.x
- CTM (ConnectedTexturesMod)
适用人群
使用非标准纹理并创建支持 CTM 的自定义方块模组的模组开发者。
注意事项
- 仅在真正需要的地方使用该库
- 纹理尺寸必须能被 16 整除
- 图集体积可能会变大——这是正确渲染的正常代价
致谢
特别感谢 Chisel Team 开发的 ConnectedTexturesMod (CTM),其部分解决方案启发了本库,并使图案纹理成为可能。
项目 Telegram 频道:KharkivTiles 1:1
GitHub:Github/ApertureMapsLib
ApertureMapsLib is a library for Minecraft Forge 1.12.2 that allows large rectangular textures to be used safely in the vanilla atlas.

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
评论 0
登录后参与评分
还没有评论,来抢沙发吧