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

Hide Armor Command