HideArmor

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

1. Download the .jar file
2. Place it in your server's plugins/mods folder
3. Restart the server
4. 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