Armor Hider

Armor Hider

A no-dependency mod to the transparency or fully hide armor and equipment with multiplayer support, without any dependencies - supporting a wide range of game versions and available for Fabric, Quilt and NeoForge with a custom built UI that makes it feel like as if it would have been shipped with the game.

Features

Armor Hider features a big selection of customization options to have your player model drawn up to your liking. Additionally, all settings are synchronized in multiplayer and many of them can be adjusted via administration.

• Per-slot opacity sliders for helmet, chestplate, leggings, boots and offhand
• Enchantment glint control to selectively hide the glint on any slot
• Combat detection lets you automatically show armor when in combat
• Visibility settings let you choose whether your armor should be drawn when you've used an invisibility potion
• Full multiplayer sync so other players see your settings when the server has the mod
• Resource pack compatibility for armor non-EMF or EMF armor models, with the option to use vanilla's armor in combat
• Works client-side only too without server mod required
• Live in-game preview of your changes
• Keybindings to quickly toggle Armor Hider or open the settings screen
• Presets to store your favorite configurations - including quick-loading by a keybind you can define yourself
• Individual item configurations provide more freedom if you're using custom items and want them handled by Armor Hider or not
• Adjustable player-configs allow you to choose (if the server allows) how other players are drawn - both generically applied or on a per-player basis
• Admin controls for server operators (see below)

Compatibility

Server Side Plugins

Armor Hider has support for optional server-side running (though Fabric, NeoForge or one of the Paper derivates). None of these server-side mods/plugins has the intention to actually do any armor hiding / visual adjustments - they are complementary to the client-side mod and provide administrative, synchronization and event features to provide a richer client-side experience.
If you enjoy Armor Hider client-side, let your admin know about it's availability for the most popular server loaders. Likewise, if you think the mod suits your server's theme, most client versions are supported for your users.

Other mods

Armor Hider has explicit compatibility with some major mods focused around visuals.

• Essential
• Elytra Trims
• Wildfire Gender / Female Gender Mod
• GeckoLib (any custom armor mod using GeckoLib as intended should work out of the box)
• Fantasy Armor
• LuckPerms
• Iris
• EMF (most custom armor resource packs using EMF for rendering work right out of the box)
• Accessories/Trinkets/Curios (when either of these accessory-providers is available, you are able to choose whether they should be hidden as well or not)
• Mekanism
• Figura (as far as possible, mainly cross-compatibility to Mekanism)
• ModMenu
• Deeper and Darker
• Ice and Fire CE
• Wavey Capes
• Immersive Armors

If you're using a mod not yet supported, please open an issue on GitHub to let me know or drop a message on Discord.

I track issues (including feature requests) via GitHub and do my best to close out any bugs timely (plus, I get way too excited about new features myself..). If you don't have an account, feel free to join the Discord server and let me know there.

If you like my work and would like to support me, you can do so here:

---

Customizability

Find Armor Hider's settings integrated into the game via "Zannagh's Armor Hider" in Options (per default) or in "Skin Customization" (if configured to be shown there in Armor Hider's 'Other Options' segment). When in-game, the mod settings feature a live preview of your changes.

Armor Opacity and Adjustments

The mod allows you to define an opacity between 0% (hidden, cancelling the rendering) and 100% (the mod doesn't do anything) for each armor item slot. In addition, it's possible to specify whether skull items (skeleton/wither/... skull) should be affected by the helmet setting and if Elytras should be affected by the chestslot setting.
Furthermore, you can selectively hide the enchantment glint on any of the slots.

Combat Detection

With combat detection enabled, your armor automatically becomes visible when you take or deal damage.

Enabled Combat Detection

Disabled Combat Detection

Vanilla Armor in Combat

When armor resource packs using EMF (or not, default resource packs work out of the box) are installed, you can choose to have armor hider switch to the vanilla armor model once you enter combat.

Visibility Switching

You can choose whether your armor should be drawn when you have the invisibility effect. Admins can override this server-wide to prevent fully-invisible players even if they have armor equipped.

Presets

Armor Hider comes with five presets which you can load by clicking the corresponding button in the settings screen. Alternatively, define a keybind for 'Armor Hider - Load Preset' and afterward pressing this button and any number key between 1 and 5 anywhere in the game.

To change a preset, select it (as described above) and adjust the settings as you like. The preset automatically saves when the options screen gets closed.

Offhand Opacity

Armor Hider additionally offers to hide the offhand slot if you don't want your fancy skin obstructed by a shield or other items.

Accessories

If you have Trinkets/Curios/Accessories installed, you can choose whether a slider that maps to an accessory (hat -> head, necklace -> chest, belt -> leggings, ...) should be affected by Armor Hider too or not. If you're not using any of these mods, Armor Hider will suppress offering these settings.

Synchronization

If the mod is installed on the server you're joining, all of your local preferences will get sent to the server on change or join. The server-side mod then takes care of relaying your preferences to all other clients. That way, if the mod is present on the server, everyone will see your avatar exactly as you've configured it (including combat detection, glint and other features).

Combat events are synchronized and not only client-side, so when the server runs the mod, you'll see another player's armor once they enter combat (granted they have the related setting enabled).

If a host is not yet running the mod, there's a setting available which lets you define whether the then 'unknown' players should have their armor rendering unaffected or carry over your own settings.

Social Settings

Via a social settings button you are able to adjust how Armor Hider handles other players granularly. Three main settings define how this is handled:

• Other Players: Adjust/Vanilla sets if other players visual's get adjusted by Armor Hider at all or not (the server is able to override this)
• Unknown Players: My Config/Global lets you choose whether players that are not running the mod (or when you're connected to a server without Armor Hider) will be rendered using your own configuration on the main screen or the global configuration
• Use Global for Others: On/Off lets you choose whether - no matter what - you'd like the global config used on other players even if you're on an Armor Hider running server (while the server can still override this).

For any other player you can define an individual configuration in addition, that will - if allowed by the server - determine how they are drawn, no matter the above.

Advanced Settings

Disable Armor Hider features

Globally disable Armor Hider on your client. If the server is forcing Armor Hider off, this setting is overridden

Settings Location

You can choose where you want Armor Hider's settings to be displayed. Currently, Armor Hider defaults to adding a 'Zannagh's Armor Hider' button to the option screen. If you flip the advanced setting to display options in Skin Customization to 'ON', Armor Hider will inject its options into the vanilla Skin Customization screen instead

Administrative Settings

For hosts, these settings require moderator/operator permissions (for compatibility reasons, the mod only checks for permission level >= 3) and are applied server-wide, overriding individual player preferences.

• Armor in combat (server): Forces combat detection server-wide — when enabled, armor is always shown for any player in combat, overriding each player's individual combat detection setting - useful for PvP servers
• Force Armor Hider off for all players: Forces Armor Hider to be disabled for all players on the server (especially useful when you're running a PvP server and don't want people to hide other players' armors)
• Armor While Invisible: enforces that armor is rendered when a player has the invisible effect to prevent competitive advantage
• Individual Player Configs: Allows administrators to enable or disable whether connected clients can use the application of individual configurations (both the client-side global and per-player configs) to override how the client sees other players

Server Communication Matrix

Your locally set preferences get sent to the server on change or join. Players joining a server will retrieve the
preference library from the server in order to apply other players' preferences on their client.

The following matrix shows how preferences are resolved depending on where the mod is installed:

Mod on Server	Mod on Client	Behavior
Yes	Yes	Full functionality. Your preferences are synced to the server and relayed to other players. You see other players' actual configured armor opacity.
Yes	No	No effect. The server stores preferences but the vanilla client cannot render transparency changes.
No	Yes	Client-side only. Other players' preferences cannot be determined. Depending on the "individual configuration" settings: your own opacity settings are applied to all players or a global 'other player config' is used. Optionally, all others can be just rendered as with vanilla. Combat events will not be passed around in the server.
No	No	No effect. The mod is not present.

Community

Join the Discord server for support, discussion, and feature requests.

Issues and Feature Requests

As mentioned before, feel free to create an issue on the GitHub repository or reach out on Discord to make me aware of problems or ideas that could make this mod better.