Configurable LabPBR Player Armor

Configure your armor's material properties in real-time. Defaults to a plastic Minecraft-ish look.

[![Modrinth Downloads](https://img.shields.io/modrinth/dt/configurable-labpbr-player-armor?color=00AF5C&logo=modrinth&style=for-the-badge)](https://modrinth.com/mod/configurable-labpbr-player-armor) [![CurseForge Downloads](https://img.shields.io/curseforge/dt/1662502?color=F16436&logo=curseforge&style=for-the-badge)](https://www.curseforge.com/minecraft/mc-mods/configurable-labpbr-player-armor) [![Modloader: Fabric](https://img.shields.io/badge/Mod%20Loader-Fabric-cabea3?style=for-the-badge)](https://fabricmc.net/use/installer/) [![Modloader: NeoForge](https://img.shields.io/badge/Mod%20Loader-NeoForge-F16436?style=for-the-badge)](https://neoforgs.net/) [![Modloader: Forge](https://img.shields.io/badge/Mod%20Loader-Forge-dfa86a?style=for-the-badge)](https://files.minecraftforge.net/net/minecraftforge/forge/) [![Discord](https://img.shields.io/discord/1382334723333820568.svg?label=Discord&logo=discord&logoColor=white&color=00AFC1&labelColor=555555&style=for-the-badge)](https://discord.gg/SbWMWT3QBW) [![GitHub](https://img.shields.io/badge/Source%20Code-GitHub-00AFC1?labelColor=555555&logo=github&style=for-the-badge)](https://github.com/DawsonBodenhamer/Configurable-LabPBR-Player-Armor) [![Ko-fi](https://img.shields.io/badge/Ko--Fi-28_Coffees-E69A45?labelColor=555555&logo=kofi&logoColor=white&style=for-the-badge)](https://ko-fi.com/dawsonbodenhamer) [![Patreon](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fshieldsio-patreon.vercel.app%2Fapi%3Fusername%3Ddawson_bodenhamer%26type%3Dpatrons&style=for-the-badge&logo=patreon&logoColor=white&labelColor=555555&color=E69A45)](https://www.patreon.com/c/dawson_bodenhamer)

Default diamond armor changing into custom LabPBR armor settings

This is a lightweight client-side mod that generates LabPBR material maps for vanilla humanoid armor. Pick the finish for each armor family, apply the changes, and your compatible shader handles the lighting. ## Why I Made It

Realistic diamond armor showcase

I don't know about you, but I've always thought that Minecraft was not intended to look like this. 👉🏼 Don't get me wrong— I love things like subsurface scattering and PBR textures. But Minecraft has a certain 16x16, blocky, whimsy style. I like applying realistic effects on top of that intended style rather than replacing it. When I first built customizable armor materials in this same way for [Adorable Hamster Pets](https://modrinth.com/mod/adorable-hamster-pets) Hamster Armor, I went with the plastic/cartoonish/stylized result because that way I got my pretty reflections, but it still felt like *Minecraft*. I wanted the same treatment for player armor so I could match my hamsters lol. Then I realized, what if I made it configurable? I had already made the hamster armor materials configurable so I just set it up the same way. ## What This Mod Does - Configures smoothness, reflectance/metal type, porosity/subsurface scattering, and emissiveness. *Yes you can make your armor glow with this*. - Updates its generated resource pack as soon as you apply a change, so you'll see the changes apply in real-time. - Leaves armor textures, models, item sprites, normal maps, and POM alone for great compatibility. - Runs entirely on the client. Servers and other players do not need the mod.

Iron armor LabPBR material showcase Gold armor LabPBR material showcase

Diamond armor LabPBR material showcase Netherite armor LabPBR material showcase

## Easy Material Editing LabPBR is a material format used by many compatible Minecraft shaders. The mod writes a small companion map for each worn armor texture; the shader reads those values and decides how the surface responds to light. Easy squeezy peezy.

Configurable LabPBR Player Armor settings screen with material controls and a hover tooltip

Hover over a setting in the configuration screen to see its LabPBR channel and valid range. Apply changes whenever you want to check the result in-game. ### Real-Metal Cheat Sheet Once upon a time, a small group of powerful people agreed together in a secret meeting that these exact `Reflectance / Metallic` values would be used to emulate eight real life metals: | Metal | Reflectance / Metallic | Porosity / SSS | Emissiveness | | --- | ---: | ---: | ---: | | Iron | `230` | `0` | `255` | | Gold | `231` | `0` | `255` | | Aluminum | `232` | `0` | `255` | | Chrome | `233` | `0` | `255` | | Copper | `234` | `0` | `255` | | Lead | `235` | `0` | `255` | | Platinum | `236` | `0` | `255` | | Silver | `237` | `0` | `255` | `Smoothness` controls the finish, not the metal. A few starting points: | Finish | Smoothness | | --- | ---: | | Rough or weathered | `90` | | Brushed | `160` | | Polished | `220` | | Mirror finish | `255` | The finish values are just recommendations— you do you. Where am I getting these numbers? See [shaderLABS LabPBR Material Standard](https://shaderlabs.org/wiki/LabPBR_Material_Standard). Note that some shader packs do not implement the individual presets and treat `230–255` as custom metal instead. ## Resource-Pack Compatibility The built-in resource pack contains `_s.png` images for vanilla worn-armor and trim paths, plus the LabPBR format declaration. It does not replace diffuse artwork, models, item sprites, `_n` normal maps, or POM.

Player wearing custom armor with LabPBR material effects

That means most resource packs that replace vanilla worn-armor artwork can keep control of the armor's shape and color while this mod controls its material response. Armor added under new modded resource paths will not be affected. If you want me to add it you can commission it. ## Change Management Fzzy Config keeps your experimentation reversible. You can apply a set of changes, revert it, restore to the defaults, or inspect change history from the configuration screen.

Manage Changes screen with apply, revert, restore-defaults, and change-history controls

## Material defaults | Material family | RGBA: smoothness, reflectance, porosity/SSS, emission | | --- | --- | | Leather / turtle | `90, 0, 50, 255` | | Chainmail / iron | `220, 130, 0, 0` | | Gold / diamond / copper | `220, 50, 0, 0` | | Netherite | `120, 20, 0, 0` | | Armor trims | `220, 50, 0, 254` | LabPBR reserves emission value `255` as disabled. Normal maps are unsupported because I think they look weird at the default game resolution, and POM is intentionally unsupported because it doesn't work on entities anyway. ## How to Use 1. Install a [supported Minecraft version and loader](docs/version_matrix.md). 2. Install [Fzzy Config](https://modrinth.com/mod/fzzy-config) and this mod on the client. 3. Use a LabPBR-compatible shader to see the generated material response. 4. Open the client config screen, choose an armor family, adjust its values, and apply. Without a compatible shader, the generated maps are inert. See the [compatibility notes](docs/compatibility.md) for artwork-pack support and deliberate exclusions. --- ## Check out my other mod, Adorable Hamster Pets

Configurable LabPBR Player Armor

Compatibility

Minecraft: Java Edition

Platforms

Supported environments

Links

Tags

Creators

Details