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