Acuity Library 1.12.2 is a core mod with an API modders can use to implement multi-layered textures, emissive rendering and fancy visual effects (shaders) for block rendering with good performance on moderate to high-end hardware, all without using TileEntitySpecialRenderer. This mod is client-side only and can be quickly enabled and disabled at run time via configuration settings. When the mod is disabled, the game uses normal Minecraft rendering.

Acuity Library


  • Blocks should render a little faster with Acuity enabled.
  • Mod authors can create blocks with multiple texture layers (for example, base color + decorative texture + border) that render in a single pass without transparency. (It’s possible to do this in vanilla, but requires three quads and possibly one or more transparency sorts unless you can get by with cutout textures)
  • Mod authors can implement custom shaders that will be automatically activated per-quad.
  • Mod authors can use emissive rendering per-quad, and also per-texture layer within the same quad.


Baseline vanilla forge render performance with complex terrain and 16-chunk render distance. After all chunks are loaded, FPS is around 70/second.

Acuity Library Screenshots 1

Same scene rendered with Acuity enabled. After all chunks are loaded, FPS is around 80/second. Note there is a defect here: Acuity renders slightly darker.

Acuity Library Screenshots 2

Massive lava flows rendered with a custom pipeline.

Acuity Library Screenshots 3


Minecraft Forge

How to install:

  1. Make sure you have already installed Minecraft Forge.
  2. Locate the minecraft application folder.
    • On windows open Run from the start menu, type %appdata% and click Run.
    • On mac open finder, hold down ALT and click Go then Library in the top menu bar. Open the folder Application Support and look for Minecraft.
  3. Place the mod you have just downloaded (.jar file) into the Mods folder.
  4. When you launch Minecraft and click the mods button you should now see the mod is installed.

Acuity Library 1.12.2 Download Links:

For Minecraft 1.12.2

Download from Server 1Download from Server 2