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.
