promotional bannermobile promotional banner
premium banner
A Hytale plugin that allows players to toggle the visibility of their armor pieces while maintaining full protection benefits.

Description

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