Player Disguise

Pick a name. Pick a skin. Step into a new identity on the server, for everyone, in real time.

Player Disguise is a custom-alias system for servers, character-driven worlds, and anyone who wants a fresh identity without leaving their account. Build a book of profiles client-side, then present any one of them to the rest of the server: chat, tab, nameplates, F5 self-view, voice icons, map markers, and more.

Runs on NeoForge 1.21.1. A Fabric port is planned.

What’s in the box

• A profile book. Create profiles with a custom name and skin PNG. Wide and slim model support. Skins are validated against vanilla specs (64×64 or 64×32, ≤64 KB) before they ever touch the server.
• Server-wide visibility. Once you join, everyone on the server sees your alias and skin: chat, tab list, nameplates, F5 self-view.
• Persistent claims. Your alias and skin stay reserved on the server across logouts. Other players can’t snatch a name you’re using.
• Cooldown on release. When you switch profiles, your previous alias enters a per-player cooldown so a quick rejoin doesn’t lose it.
• Efficient skin transfer. Two-step handshake: the server only requests data when it doesn’t already have the skin saved. No re-uploading on every login.
• Storage hygiene. Server-side cleanup routines keep the skin cache bounded.

For server admins

Aliases exist for fun, not for hiding. Operators always have a real-name lookup:

• /whois <alias> — name-anchored. Returns every player who has ever used that alias, with timestamps.
• /namehistory <player> — player-anchored. Returns every alias that player has ever held, including their real-name intervals.
• Standard moderation commands (/ban, /kick, etc.) operate on real names, not aliases.
• Real-name collision kick. If a player joins under their real Mojang name and someone else is currently disguised as that name, the disguised player is temporarily kicked. Your real name is always your real name.
• Reserved-name list. A player can never claim an alias that matches another player’s real Mojang name.

Compatibility

| Mod | What it does |
| — | — |
| Simple Voice Chat | Voice icons follow the disguised identity |
| BlueMap | Map markers reflect the disguise |
| JourneyMap | Map markers reflect the disguise |
| Chat Heads | Chat avatars match the disguised skin |

Data & privacy

Skin PNGs and aliases travel only between the modded client and the modded server you’re joining. There are no external skin hosts, no third-party APIs, no telemetry. Vanilla servers will still see your real Minecraft identity.

Credits

By WeaversWorkshop. Licensed under MPL-2.0.

Found a bug? Open an issue.