Rankcognito

# 🎭 Rankcognito **Simple. Configurable. Invisible ranks.** *Hide LuckPerms ranks in tab, nametags, and chat — without breaking TAB, spectator mode, or your network's polish.* (https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/invite/VQjTVKjs46) (https://img.shields.io/badge/bStats-View%20Metrics-0069c4?style=for-the-badge)](https://bstats.org/plugin/bukkit/rankcognito/31779) --- !(https://cdn.modrinth.com/data/cached_images/c944f5879da2c0a80a66f721761280da7e2af1c5_0.webp) --- ## 🎯 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 (https://bstats.org/signatures/bukkit/rankcognito.svg)](https://bstats.org/plugin/bukkit/rankcognito/31779) Anonymous usage stats help improve Rankcognito. Disable with `metrics.enabled: false` in config. --- ## ❓ Support (https://img.shields.io/badge/Click_Here_To-Join_Disco