?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
Player Disguise

Player Disguise

Add new profiles with custom names and skins

250
1
250
1

Compatibility

Minecraft: Java Edition

1.21.1

Platforms

Supported environments

Client-side
Server-side
Client and server

Links

Report issues View source

Tags

Creators

Details

Licensed MPL-2.0
Published last month

Player Disguise banner

Minecraft Version NeoForge Version License

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.