Shaders Companion

Shaders Companion

Shader packs can only reflect what is on your screen. Shaders Companion gives them the rest of the world: water and stained or tinted glass become real mirrors that show yourself, the mobs and buildings behind you and the terrain far away.

It comes with ABZA Shader, which uses it out of the box: install the mod and pick "ABZA Shader.zip" in the shader pack list. Oculus and Embeddium are required.

---

Requirements

What	Version
Forge	47
Side	Client only
Oculus	1.8.0
Embeddium	0.3.31
Distant Horizons	Optional, 3.3.2
Shader pack	Apocalypse Begins [Sundial Lite Fork], included

---

With And Without

Without The glass has nothing to show	With You, entities, and other blocks are reflected

The same spot and settings: a wall of black stained glass with everything else behind the camera.

---

Gallery

Mobs And Players You and the mobs next to you, up close	Distant Horizons The city behind you, far terrain included
Gun And Armour What you hold and wear, in black glass	Many Features Combined You, the town and the sky in one glass wall
Indoors A hallway with furniture and plants	Rain At Night A lit house in the rain

All shots with ABZA Shader, which comes with the mod.

---

What It Does

• Mirrors: the largest water surface or wall of stained or tinted glass on screen shows a sharp reflection of the world, your own player included, with the shader pack's own light and shadows.
• Every other reflecting surface shows what is behind, beside and above you, where it used to show nothing.
• What you see in them: terrain, water, glass, mobs, other players, your gun and armour, chests and other block entities, and Distant Horizons' far terrain.
• Water and glass in reflections: with ABZA Shader, reflected water has its colour, waves and sky, and reflected stained glass tints what lies behind it.
• Dry under glass roofs: with ABZA Shader, the ground under glass roofs stays dry in rain, where the rain itself stops.
• No cost when unused: the mod only draws while the active shader pack uses it. /shaderscompanion off stops it at once, and /shaderscompanion on starts it again.

NOTE: clear glass is see-through and doesn't act as a mirror. Stained and tinted glass, ice and water do.

---

ABZA Shader Included

The mod puts ABZA Shader into your shaderpacks folder as "ABZA Shader.zip" when the game starts.

• Updates: a newer version of the mod replaces its own copy of the pack and keeps your shader settings.
• Turning it off: set installBundledPack = false in config/shaderscompanion-client.toml.

---

Commands

Command	What it does
/shaderscompanion on	Starts the mod's drawing
/shaderscompanion off	Stops it, without a restart; reflections go back to the shader pack's own
/shaderscompanion status	Shows what is being drawn and what it costs
/shaderscompanion debug	Shows the mod's views in the corner of the screen
/shaderscompanion dump	Saves the views to the screenshots folder

---

For Shader Pack Authors

Any shader pack can use the mod's views and its map of where rain falls, and a pack that uses them still works without the mod. The format and reference code are in API.md on GitHub.

---

Known Limits

• Particles aren't reflected.
• One mirror at a time: other reflecting surfaces on screen get the less sharp reflection.
• Other versions of Oculus, Embeddium and Distant Horizons than the ones above may not work.

---

Credit

Shaders Companion comes with ABZA Shader as a separate file under its own licence (GPL-3.0). ABZA Shader is a fork of Sundial Lite by GeForceLegend; its source is on GitHub. Oculus is made by NanoLive, dima_dencep and the Iris team, and Embeddium by embeddedt. Neither is affiliated with this mod. The mod's own code is 0BSD and on GitHub.