Nick Hider

Nick Hider

Client-side privacy masking for Minecraft player names, skins, capes and UUIDs.

What This Mod Does

Nick Hider masks player identity details in common vanilla client rendering and text paths.

• Local player: replace your shown name, skin, and cape.
• Other players: replace names with a template and swap skins/capes from configured source accounts.
• Global switch: instantly enable or disable all masking behavior.

Quick Start Tutorial

1. Download the jar for your exact Minecraft + loader combination.
2. Put the jar in your Minecraft mods folder.
3. Launch the game and open settings from Mod Menu (Fabric + Mod Menu), Mod List (Forge/NeoForge), keybind Open Nick Hider Settings (default unbound), or command /nickhider.
4. First-time setup suggestion: enable Hide Local Name, Hide Local Skin, and Hide Local Cape, then set Local Replacement Name to a neutral alias.
5. Join a world/server and verify your own name and skin/cape are masked; enable Hide Other Names/Skins/Capes if you also want to mask other players.
6. After config save/reload, Nick Hider automatically refreshes skin/cape sources in the background.

Features At A Glance

| Area | Behavior |
| —————– | —————————————————— |
| Local name | Replaces your local displayed name |
| Local skin | Replaces your local rendered skin |
| Local cape | Replaces your local cape and cape-based elytra texture |
| Other names | Template-based replacement with [ID] token support |
| Other skins/capes | Shared configured source usernames |
| External fallback | Optional mineskin.eu + api.capes.dev (default: off) |
| Runtime toggle | Global Enable Nick Hider on/off switch |
| Open config | Keybind + /nickhider command |

Compatibility

• Supported Minecraft versions: 1.20.1 and 1.21.1
• Loader support policy:
• 1.20.1: Fabric, Forge
• 1.21.1: Fabric, NeoForge

Short matrix:

• 1.20.1: Fabric, Forge
• 1.21.1: Fabric, NeoForge

Configuration

Toggle Controls

• Hide local: name, skin, cape
• Hide others: names, skins, capes
• Global master toggle: Enable Nick Hider
• Optional switch: Enable External Skin/Cape Fallbacks (default: off)

Replacement Inputs

• Local replacement name
• Local skin source username
• Local cape source username
• Other players name template
• Other players skin source username
• Other players cape source username

Validation and Fallbacks

• Replacement usernames must be empty or match [A-Za-z0-9_]{3,16}.
• Local replacement name must match [A-Za-z0-9_]{3,16}.
• If cape masking is enabled but no valid cape source resolves, cape rendering is hidden instead of showing the original cape.
• External fallbacks are queried only after official skin/cape lookups fail.
• Saving or reloading config clears runtime cache and starts an automatic source prefetch.

Diagnostics Logs

• Skin/cape runtime diagnostics use stable NH-* codes (for example NH-SKIN-FETCH, NH-SKIN-RECOVERED, NH-HOOK-FAIL).
• Repeated identical failures are throttled per source user to avoid console spam.
• Hook failures log the first incident as warning, and subsequent repeats as debug.

Known Limits

Nick Hider is aggressive on vanilla client paths, but masking is still best-effort. Third-party mods or custom render/UI pipelines can display unmasked data outside covered paths.

License

Licensed under the GNU Affero General Public License v3.0 (AGPLv3).
See LICENSE.

Maintainer and Links

• Author: przxmus
• Source: GitHub Repository
• Issues: GitHub Issues