Masquerades

A craftable masquerade mask that disguises you as another player — their name and skin
item image

Description

🎭 Masquerade: Wear Someone Else's Face

Masquerades adds a craftable mask that turns you into another player — their name, their skin, their silhouette — for five minutes. Craft the mask, rename it in an anvil to the nickname of your victim, and put it on: everyone around you sees a different person. The mask is consumed when worn, and the disguise always ends on its own.

Your real identity never leaves the server. The tab list, your UUID, your permissions and your commands stay yours — only the face changes.

🎯 Why Your Server Needs This Plugin

A real disguise, not just a name tag. The plugin swaps the actual player profile: the skin is copied too, so the impostor looks like the victim from across the arena, not just in the namelist.

Safe by design. The nickname in the tab list, your UUID, your permissions and every command you run stay untouched. A disguised player cannot use their disguise to bypass bans, permissions or staff tools — they only borrow a face.

Five minutes, not forever. Every disguise runs on a 5-minute timer with a countdown in the action bar (4-3-2-1 minutes, 30 seconds, 10…1). No permanent impersonation, no accidental «I am still that guy tomorrow».

One command to clean up. /masquerade clear <player> removes a disguise instantly — the real face comes back in the same tick, even if the player is mid-fight or hiding from an admin.

Admin-friendly. One command with tab-completion to hand out masks, a single config option for the default language, and a debug switch for troubleshooting.

Localized. Every player sees texts in their own language (EN / RU) — chat messages, action bar, item name and lore, and the crafting preview. English clients see English, Russian see Russian.

Performance-first. One shared timer for all active disguises, skin lookups off the main thread, zero dependencies

💡 How It Works

  1. Craft the mask (recipe below) or receive it from an admin.
  2. Put it in an anvil and rename it to the nickname of the player you want to disguise as (3–16 characters: letters, digits and underscore). Any other text is rejected by the anvil.
  3. Put the mask on your head. It is consumed immediately, and the disguise starts with «You put on <nick>'s mask. 5 min remaining.»
  4. From this moment your name above your head and in chat belongs to the victim, and the skin is theirs as well.
  5. The action bar counts the disguise down (4-3-2-1 min → 30 s → 10…1 s).
  6. When the timer runs out: a sound, a puff of smoke, and «The masquerade is destroyed.» The real name and skin come back instantly.

The disguise also ends if you die, if you leave the server, or if an administrator clears it. Your identity is always restored — the game never shows the «formerly known as …» line.

The mask

Item Duration Copies Keeps Ends on
Masquerade Mask (leather helmet base, custom name and lore) 5 minutes (300 seconds) Displayed name in chat and above the head, and the skin Tab-list nickname, UUID, permissions, commands, real skin Timer, death, leaving the server, /masquerade clear

Crafting recipe (shaped, 3×3 crafting table)

🎭 Masquerade Mask (result: Masquerade Mask)

⬛ Netherite Ingot 🔷 Echo Shard ⬛ Netherite Ingot
🔷 Echo Shard 💀 Wither Skeleton Skull 🔷 Echo Shard
⬛ Netherite Ingot 🔷 Echo Shard ⬛ Netherite Ingot

📖 How to Obtain a Mask

Source Details
Crafting Shaped 3×3 recipe above; the crafting preview shows the mask in the crafter's own language
Admin /masquerade give <player> — the item name and lore are baked in the receiver's language

⌨️ Commands (permission: masquerade.admin)

/masquerade give <player>   — give a mask to a player (created in that player's language)
/masquerade clear <player>  — remove a player's disguise right now

The permission defaults to operators. Tab-completion covers player names.

⚙️ Technical Advantages for Administrators

Performance: one shared one-second timer drives every active disguise (no per-player tasks). Skin resolution — reading SkinsRestorer's files or querying the Mojang profile API — happens off the main thread; only the profile swap runs in the main thread. Nothing ticks in the background when no one is disguised.

Safety: the item's identity lives in the PersistentDataContainer (PDC) — a renamed leather helmet can never trigger a disguise. The real profile is snapshotted once and restored strictly synchronously on exit, death or /masquerade clear, so the player data never stores a masked name.

Localization: EN/RU per player (client locale), a default-language option for the console and for the crafting template, and item names and lore baked in the receiver's language at the moment of creation.

Compatibility: Paper 26.3 (Java 25), pure Paper API, no NMS, no external dependencies. Works offline out of the box.

🔑 Two Setup Paths — Skins Work Everywhere

Server type What to do Result
Licensed server (online-mode=true) Nothing to install Skins are taken from the victim's live profile and from Mojang's API — the disguise copies the real skin
Unlicensed / offline-mode server Install SkinsRestorer Cracked accounts have no Mojang profile, so the plugin reads the victim's saved skin from SkinsRestorer's storage. Without it, disguises of players who are offline copy the name only, not the skin

⚠️ Known Third-Party Issue (not a plugin bug)

If the server runs the spark profiler, its ping monitor may throw a single exception when a disguised player and their victim are online at the same time (spark builds an ImmutableMap keyed by profile name, and duplicate names are not allowed). This is an upstream spark bug — it happens with any plugin that changes a profile name — and it is harmless: the ping-monitor task simply stops, the server keeps running normally.

📦 Perfect For

Roleplay and story servers that need a face for a scene — witnesses, impostors, undercover agents.

Event and tournament servers: hand out masks as a rare reward and let the hunt begin.

Horror and Halloween builds: the victim walks in, someone else walks out.

Faction and gang servers: a masked member slips past the enemy camp.

SMP servers that want a bit of mischief without a permanent identity swap.

Install Masquerades and let your players wear someone else's face!


Chat, requests to add versions, bugs, creating plugins for your needs — discord

Support the author: donate

Masquerades Team

profile avatar
  • 11
    Projects
  • 125
    Downloads

Developer specializing in unique solutions for modpacks and server builds. Open for individual custom commissions. Let's bring your ideas to life!

More from NaotoDevView all