[1.8 - 1.21.1] ⭐ Nick / Disguise Plugin ⭐ Fork

# NickPlugin v2.4 - High Performance Nicking System

**❗Disclaimer❗ This is a modernized fork of the [SpigotMC Nick Plugin]( https://www.spigotmc.org/resources/1-8-1-21-1-⭐-nick-disguise-plugin-⭐.109050/) built for modern Paper versions, Mojang Authlib 7.x & Java 21.**

Disguise yourself or other players seamlessly on your server! NickPlugin supports custom skins, overhead nametags, tablist names, LuckPerms real rank copying, TAB/NametagEdit integration, databases, and full compatibility with modern Minecraft versions (**Paper 1.21.1+** & **Java 21**).

---

## Features

- **Skin & Name Disguise:** Change skin, overhead nametag, and tablist display dynamically.
- **Real Target Rank Copying:** When disguised as a real player, automatically fetches and applies their actual LuckPerms ranks/groups.
- **Persistent Rank Backup (`saved_ranks.yml`):** Safely backs up original player ranks on disk so your true rank is never lost across plugin reloads or server restarts.
- **Tablist & Prefix Integration:** Fully compatible with TAB v5.x/v6.x, NametagEdit, and LuckPerms.
- **Modern Paper Chat & MiniMessage:** Native Paper `AsyncChatEvent` renderer with support for MiniMessage color gradients (`<gradient:...>`, `<bold>`) without chat duplication.
- **Essentials `/msg` Support:** Sets player display names so Essentials `/msg`, `/r`, `/tell`, and `/list` display the disguised nickname.
- **Nick on Join:** Automatically disguise players when they join (with an option to keep their previous nickname).
- **Name Blacklist & Random Names:** Configure custom pools of random nicknames and blacklist forbidden names.
- **Cooldown System:** Prevent command spam with configurable cooldown timers.
- **Database Support:** Choose between SQLite or MySQL for cross-server/persistent nickname storage.
- **PlaceholderAPI Support:** Integrated placeholders for Scoreboards, TAB, Chat, or GUI menus.
- **Modern & Java 21-Ready:** Built for Paper 1.21.1+, Mojang Authlib 7.x & Folia/Paper threading architecture.


---

## Commands

| Command | Description | Permission |
| :--- | :--- | :--- |
| `/nick` | Nick/unnick yourself (random name) | `nick.nick` |
| `/nick <name>` | Nick yourself with a specific name | `nick.custom.name` |
| `/nick <group>` | Nick yourself with a specific group | `nick.custom.group` |
| `/nick <group> <name>` | Nick yourself with specific group & name | `nick.custom.group` & `nick.custom.name` |
| `/nick <player>` | Nick/unnick another player (random name) | `nick.other` / `nick.other.nick` |
| `/nick <player> <name>` | Nick another player with a specific name | `nick.other.custom.name` |
| `/nick <player> <group>` | Nick another player with a specific group | `nick.other.custom.group` |
| `/nick <player> <group> <name>` | Nick another player with group & name | `nick.other.custom.group` & `nick.other.custom.name` |
| `/nick realname <player>` | Reveal the real name of a nicked player | `nick.realname` |
| `/nick reload` | Reload plugin configuration files | `nick.reload` |
| `/nick help` | Show in-game command help overview | `nick.nick` |
| `/unnick` | Unnick yourself | `unnick.self` |
| `/unnick <player>` | Unnick another player | `unnick.other` |

---

## Permissions

### Nick Permissions (Self)
- `nick.nick` - Allows using `/nick` (disguise & unnick).
- `nick.custom.name` - Allows choosing a custom nickname.
- `nick.custom.group` - Allows choosing a custom rank/group.
- `nick.custom.group.<GroupName>` - Allows choosing a specific group (e.g. `nick.custom.group.vip`).
- `unnick.self` - Allows using `/unnick`.

### Nick Permissions (Others)
- `nick.other` / `nick.other.nick` - Allows nicking other players.
- `nick.other.custom.name` - Allows nicking other players with a custom name.
- `nick.other.custom.group` - Allows nicking other players with a custom group.
- `nick.other.custom.group.<GroupName>` - Allows assigning a specific group to another player.
- `unnick.other` - Allows using `/unnick <player>`.

### Admin & Bypass Permissions
- `nick.reload` - Grants access to `/nick reload`.
- `nick.realname` - Grants access to `/nick realname <player>`.
- `nick.bypasscooldown` - Bypasses the nick command cooldown.
- `nick.bypassblacklist` - Bypasses blacklisted nicknames.

---

## PlaceholderAPI (PAPI) Placeholders

When PlaceholderAPI is installed, you can use the following placeholders:

- `%nick_name%` - Shows the player's nickname (or real name if not nicked).
- `%nick_realname%` - Shows the player's actual real username.
- `%nick_is_nicked%` (or `%nick_is_disguised%`) - Returns `true` if the player is disguised, `false` otherwise.

---

## Supported Plugins

- **TAB** (by NEAMOR) - Tablist sorting, headers, footers & prefixes
- **LuckPerms** - Permission management & group handling
- **PlaceholderAPI** - Universal placeholder expansion