Euphoria Companion
by Eclipse_Sol
Euphoria Companion is a client-side utility for shader developers that checks shaderpack block definitions against the blocks registered in the running game.
What it does
The mod scans shaderpacks, both folders and zip archives, for block.properties files. It compares the blocks those files define with the blocks registered in the game, so a shaderpack author can see which blocks were never added to the shader and which render layers may not match because of other mods interfering. Lists are written to the logs folder, and the scan is repeated with the F6 key after a file is edited, without restarting the game.
The mod also lists the entities loaded in the game and writes them to a log file under logs/euphoriacompanion. Version 2.0.0 is a rewrite that the author describes as faster and more reliable than the earlier builds. Only the player's game needs it, and servers run without it. Fabric API, Forgified Fabric API and Sinytra Connector are required dependencies, and NotEnoughItems Unofficial 1.7.10 is an optional one. The code is released under CC0 1.0 Universal and is open source, with a public source repository and issue tracker.
Key features
Shaderpack analysis
Directory and zip shaderpacks are scanned for block.properties files, so their block definitions can be read.
Block comparison
Blocks registered in the game are matched against those defined in a shaderpack, showing what the shader is missing.
Entity listing
Entities loaded in the game are written to a log file under logs/euphoriacompanion for inspection.
Reload with F6
After editing a block.properties file, the F6 key processes it again without relaunching the game.
Compatibility
Latest build for each game version and loader.
1.21.x9 of 9 versions with builds
1.20.x7 of 7 versions with builds
1.19.x5 of 5 versions with builds
1.18.x3 of 3 versions with builds
1.17.x2 of 2 versions with builds
1.16.x6 of 6 versions with builds
1.12.x1 of 1 version with builds
1.7.x1 of 1 version with builds
This mod also publishes snapshot builds. Snapshots are not shown in the matrix.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Use cases
Who it’s for: Shaderpack authors and players who debug shader rendering on the client. The mod has no effect on a server or on a game that runs without shaders.
Questions
Does Euphoria Companion need Fabric API?
Does a server need Euphoria Companion?
Which game versions does Euphoria Companion support?
In the catalog
Euphoria Companion is one of 36,990 Utility mods on ModsFinder, and one of 25,772 Utility mods for Fabric. 19,862 mods support Minecraft 1.21.11.
Similar mods
What the author says
New 2.0.0 rewrite of the mod, should be a lot faster and more reliable.
Official listing
- Modrinth page
- modrinth.com/mod/euphoria-companion
- Owner
- Eclipse_Sol
- Published
- 2025-02-15
- Updated on Modrinth
- 2026-03-16
- Facts verified
- 2026-10-15