What the mod does
Polytone is a client-side mod built by MehVahdJukaar. It gives resource packs direct control over visuals and sounds in Minecraft. You don't need server-side files or backend changes to make it work. Instead, you drop files into resource packs to change things that vanilla packs normally can't touch.
It fits pack makers and players who want deeper visual adjustments. The mod was designed to stay light and fast while offering lots of configuration options.
Resource pack customization options
Pack creators can modify many specific parts of the world.
For colors, you can set custom colormaps for blocks and fluids. You can define map colors, dye colors, and the tint on spawn eggs. The mod also lets you set custom sky colors and custom biome colors. Honestly, you can change the color of particles too.
Visual tweaks go beyond simple palette changes. You can set up custom lightmaps and biome variant textures. Anyone can set block offset types. Anyone can even move existing GUI slots around or add new GUI elements directly to menus.
Audio and particle handling are open for edits as well. You can change block sounds, add custom client-side sounds, and register fresh sound events. On top of that, you can add custom client-side particles and tune custom biome effects.
Optifine compatibility and environment support
If you've got older packs, Polytone handles them. The mod includes backwards compatibility for the color.properties setup previously found in Optifine. Packs made with those legacy configuration files continue to work.
The system functions in vanilla setups and modded setups. It works across custom blocks, custom biomes, and custom particles from other mods.
Documentation and an example pack live on the official project wiki. When you publish a resource pack that uses these features, you should list Polytone under the optional dependency section.
Technical details and requirements
Polytone is strictly client-side. It's required on the client and unsupported on dedicated servers.
The mod supports Fabric and Neoforge loaders. Supported Minecraft versions include 26.2, 26.1.2, and 1.21.1. The project is released under the GNU General Public License v3.0 or later.
