Hide Armor Command

HideArmor - Advanced Armor Visibility Control

A Hytale plugin that allows players to toggle the visibility of their armor pieces while maintaining full protection benefits. Now featuring a privacy-focused mutual opt-in system for multiplayer interactions, LuckPerms integration, and comprehensive admin controls.

Check some of my other mods as well:

• Equipment Plus Hud - Check on HUD for your current item durability, and ammunition count

⚠️ Important: Permission System Changes in 0.7.2

Commands now require proper permissions! By default, permission nodes may be ALLOWED unless explicitly denied. For security, we recommend using LuckPerms and explicitly denying admin commands for default players. See Permission Setup below.

Changelog

v0.8.0-alpha - Internationalization & UI Improvements

• Added multi-language support (EN, ES, PT, FR, DE, RU)
• New three-column layout for both user and admin UIs
• Language selector in both /hidearmor and /hidearmoradmin GUIs
• Server-wide default language setting with persistence

0.7.2-alpha - LuckPerms Integration & Permission Enforcement

• LuckPerms auto-detection - permissions managed via /lp when installed
• Proper permission enforcement for ALL commands
• Better Modlist logo support
• Updated documentation

0.7.1-alpha - Stability Fixes

• Fixed Ancient Gateways world transition lag spike
• Fixed permission button ID mismatch

0.7.0-alpha - Admin Features

• Admin configuration menu (/hidearmoradmin)
• Default & force override settings

---

Features

Hide Individual Armor Pieces - Toggle visibility for helmet, chestplate, gauntlets, and leggings independently
Multiplayer Support - Hide other players' armor with a Mutual Opt-In system (requires permission from both parties)
Privacy Control - Granular "Allow Others" permissions ensure you maintain control over your appearance
Persistent State - All preferences are automatically saved and restored
Native GUI - Modern, interactive Hytale UI with three distinct configuration sections
LuckPerms Integration - Seamless permission management when LuckPerms is installed
Better Modlist Support - Shows mod logo when Better Modlist is installed

Multi-Language Support

Built-in translations for English, Spanish, Portuguese, French, German, and Russian. Change language directly from the UI or via /hidearmor language <code>.

---

⚡ Known Behavior: Armor Flickering

When armor visibility updates during inventory changes (equipping/unequipping), a brief flicker may occur. This is due to Hytale's packet system processing the original item before our filter applies.

Mitigation Options:

• Adjust refreshDelayMs in players.json (default: 50ms, range: 10-1000ms)
• Higher values reduce flicker frequency but add slight delay
• This is a visual-only effect and doesn't impact gameplay

---

Commands

Player Commands

Command	Permission	Description
/hidearmor	dev.nxtime.hidearmor.command.hidearmor	Open armor visibility menu
/hidearmor {piece}	dev.nxtime.hidearmor.command.hidearmor	Toggle specific armor piece
/hidehelmet	dev.nxtime.hidearmor.command.hidehelmet	Quick helmet toggle

Admin Commands

Command	Permission	Description
/hidearmoradmin	dev.nxtime.hidearmor.command.hidearmoradmin	Admin configuration menu
/hidearmoradmin reload	dev.nxtime.hidearmor.command.hidearmoradmin	Reload config from disk

---

Permission Setup

⚠️ SECURITY WARNING

By default, Hytale may ALLOW commands if permissions are not explicitly set. This includes admin commands! Always configure permissions properly.

---

Option 1: LuckPerms (Recommended) ✅

Install LuckPerms for advanced permission management. HideArmor automatically detects LuckPerms and uses it for all permission checks.

Deny admin access by default:

/lp group default permission set dev.nxtime.hidearmor.command.hidearmoradmin false

Grant player commands to a group:

/lp group member permission set dev.nxtime.hidearmor.command.hidearmor true
/lp group member permission set dev.nxtime.hidearmor.command.hidehelmet true

Grant admin commands to admins only:

/lp group admin permission set dev.nxtime.hidearmor.command.hidearmoradmin true

---

Option 2: Native Permissions (permissions.json)

Quick Setup

Use the "Setup Permissions" button in /hidearmoradmin to automatically configure player permissions!

Manual Setup

Modify your permissions.json:

{
  "users": { ... },
  "groups": {
    "Default": [],
    "OP": ["*"],
    "Adventure": [
      "dev.nxtime.hidearmor.command.hidearmor",
      "dev.nxtime.hidearmor.command.hidehelmet"
    ]
  }
}

Note: Do NOT add dev.nxtime.hidearmor.command.hidearmoradmin to player groups - this should be admin-only!

---

Configuration

Settings are stored in plugins/HideArmor/players.json:

Setting	Default	Description
defaultMask	0	Default visibility for new players
forcedMask	0	Force hide (overrides player preferences)
refreshDelayMs	50	Delay before armor refresh (10-1000ms)

---

Compatibility

• Hytale Version: Early Access SDK
• LuckPerms: Auto-detected, optional but recommended
• Better Modlist: Logo support included