🎭 Rankcognito

Simple. Configurable. Invisible ranks.

Hide LuckPerms ranks in tab, nametags, and chat — without breaking TAB, spectator mode, or your network's polish.

---

!banner

---

🎯 Why Rankcognito?

Staff want to blend in. Creators want to play without flashing Admin tags. Competitive players want privacy. Rankcognito gives every player a clean one-command way to mask their rank everywhere it matters — tab list, overhead nametag, and chat — while staying compatible with the plugins you already run.

No duplicate nametag wars. No “I toggled hide but spectator broke it again.” Built for Paper, Purpur, and Folia from 1.20.6 through 26.x.

---

✨ Features

• 🎭 True Rank Concealment: Replace LuckPerms prefixes/suffixes with a configurable masked identity across tab, nametag, and chat.
• ⚡ One-Command Toggle: Default /hiderank with aliases hr, rc, rankcognito — fully renameable in config.
• 👻 Mask Presets: Switch between Player, Minimal, and Ghost styles — or roll your own MiniMessage prefix/suffix.
• 🔄 Spectator-Safe: Automatically re-applies your mask after leaving spectator — fixes the #1 desync other hide-rank plugins leave behind.
• 💾 Persistent State: Hidden players survive restarts via hidden-players.yml.
• 🎵 Polished Feedback: Optional sounds, action bar, and branded MiniMessage chat — feels premium out of the box.
• 🌿 Folia-Ready: Region-safe schedulers on multi-threaded servers — no “async on main thread” surprises.
• 📉 Lightweight: Focused scope, minimal overhead — rank hiding without turning your server into a framework.

---

🔌 Integrations

Rankcognito respects your stack. Enable or disable each bridge in config.yml:

Integration	What it does
🟦 TAB	Tab list + nametag overrides; optional pauseTeamHandling to stop team conflicts
🍀 LuckPerms	Cache refresh when ranks are shown again
📋 PlaceholderAPI	%rankcognito_hidden%, %rankcognito_mask_prefix%, %rankcognito_mask_suffix%
🛡️ Fallback	Works without soft-deps using scoreboard team rc_hidden

Soft dependencies: TAB, LuckPerms, PlaceholderAPI (all optional).

---

🖥️ Compatibility

Software	Support
Paper	✅ 1.20.6 – 26.x
Purpur	✅ Matching Paper versions
Folia	✅ folia-supported: true
Spigot / CraftBukkit	❌ Requires Paper APIs
Velocity / Bungee	❌ Backend plugin only

Java 21+ required on the server.

---

🎮 Commands

Command	Permission	Description
/hiderank	rankcognito.use	Toggle your rank hide
/hiderank hide / show	rankcognito.use	Force concealed or visible
/hiderank status	rankcognito.use	Check if you're hidden
/hiderank help	—	In-game command reference
/hiderank <player>	rankcognito.admin.others	Toggle another player
/hiderank reload	rankcognito.admin.reload	Reload config + refresh masks

Command names and aliases are 100% configurable under commands: in config.yml.

---

⚙️ Configuration

• mask-presets — player, minimal, ghost, or custom MiniMessage
• commands — primary command + alias list
• feedback — toggle sounds, action bar, broadcast-on-toggle
• fixes.spectator-gamemode-refresh — auto re-mask after spectator (delay configurable)
• integrations — per-plugin enable toggles for TAB, LP, PAPI
• metrics.enabled — opt out of anonymous bStats anytime

---

📋 Placeholders

Placeholder	Returns
%rankcognito_hidden%	true / false
%rankcognito_mask_prefix%	Active mask prefix
%rankcognito_mask_suffix%	Active mask suffix

Perfect for scoreboards, TAB conditions, and custom menus.

---

🛠️ Quick Start

1. Drop Rankcognito in plugins/ (Paper 1.20.6+).
2. Install TAB + LuckPerms (recommended).
3. Set your default mask in config.yml.
4. Players run /hiderank — done.

Tip: Keep TAB pause-team-handling: true when using TAB nametags to avoid team fighting.

---

📊 Metrics

Anonymous usage stats help improve Rankcognito. Disable with metrics.enabled: false in config.

---

❓ Support

MIT Licensed — use freely on your network.