HideHelmet / HideArmor

Hide or show your own armor pieces only in your own view, without changing inventory, stats, or how other players see you.

This is a visual-only convenience mod, perfect for players who want a cleaner look or better screenshots while keeping full armor bonuses.

⚠️ About the flicker:

The mod works correctly, but Hytale's client can briefly show armor during fast actions before the server corrects it. This is a limitation of server-side modding, not a bug. The game doesn't give mods full control over cosmetic rendering yet.

I'm in contact with the modding community and have reached out to Hypixel Studios to explore if future SDK updates can provide better cosmetic control.

Features

Self-only visuals — only you see the change
No gameplay impact — inventory, stats, and durability stay the same
Per-slot control — toggle armor individually or all at once
Persistent settings — your preferences save automatically

Supported Armor Slots

Helmet
Chestplate
Gloves / Hands
Leggings

Hands refers to the armor slot, not tools in your hands.

⌨️ Commands

Activate commands:

/op self (or variants)

`/hidehelmet`

Quick toggle for helmet only.

Run once → hide helmet
Run again → show helmet

HideHelmet: ON

`/hidearmor`

Full armor control command.

Show help and current status:

/hidearmor

Check which slots are hidden:

/hidearmor status

Toggle a specific slot:

/hidearmor head
/hidearmor chest
/hidearmor hands
/hidearmor legs

Force hide or show a slot:

/hidearmor on head
/hidearmor off chest

Hide or show everything at once:

/hidearmor all
/hidearmor on all
/hidearmor off all

Example output:

Hidden: Chest, Hands, Legs

Persistence

Your settings are saved automatically
Hidden armor stays hidden after reconnecting or restarting the server

Permissions

By default, you need op permission to use commands
Server owners can restrict access using their permission system if desired

📦 Installation

Download the .jar file
Place it in your server's plugins/mods folder
Restart the server
Done! Use /hidehelmet or /hidearmor in-game

🧩 Configuration (Optional)

HideHelmet includes an optional configuration section stored in players.json. If the file already exists, you can manually add the config section.

{
  "players": {
    "player-uuid-here": 15
  },
  "config": {
    "invalidateCooldownMs": 150,
    "pickupImmediate": true
  }
}

Available Options

Option	Description
`invalidateCooldownMs`	Controls how often the mod re-syncs hidden armor visuals during fast or repeated actions. Lower values (e.g. `150`) → faster correction. Higher values (e.g. `250–300`) → fewer re-syncs, slightly slower correction.
`pickupImmediate`	Forces an immediate re-sync when picking up items. `true` (default): helps reduce flicker during pickups. `false`: reduces re-sync frequency if performance is a concern.

For most setups, the default values should work well and do not require changes.

⚠️ Known Limitation (Visual)

This behavior is not new, but has been significantly reduced in recent versions.

After extensive testing and multiple mitigation attempts, a visual limitation remains:

During very fast or repeated actions (breaking blocks, attacking rapidly, mass item pickup, inventory spam), armor may briefly become visible for a fraction of a second.
The armor is automatically hidden again without requiring any player action.

Why This Happens

This does not appear to be caused by incorrect server logic:

The server sends the correct hidden equipment state.
The armor is properly masked in all outgoing equipment updates.

The most likely cause is client-side rendering behavior:

During certain rapid actions, the client may temporarily re-render armor locally before applying the next server update.
With the current state of the game and available server-side APIs, this behavior cannot be fully prevented.

We genuinely tried several approaches to eliminate this completely, but at this point we have reached a technical boundary of what can be done purely server-side.

What the Mod Does Now

Actively re-applies the hidden armor state during gameplay actions.
Corrects the visual state almost immediately in most situations.
Keeps gameplay, inventory, stats, and other players completely unaffected.

About Future Improvements

If future game updates, SDK changes, or client-side options become available, this limitation may be revisited.

If you are familiar with the client internals, rendering pipeline, or have ideas on alternative approaches, feel free to reach out or contribute — feedback and collaboration are very welcome.

⚠️ Notes

This mod is self-only by design
Other players will always see your real armor
Tools and weapons in hands are never affected

🔗 Source Code

GitHub Repository