🎭 Rankcognito

Simple. Configurable. Invisible ranks.

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

---

---

🎯 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.