# Name Tag
Name Tag is a nick plugin for Paper servers. It allows players to change their display name, skin, and optionally their UUID — with full persistence across restarts, TAB plugin integration, and automatic death/advancement/join message rewriting.
---
## Requirements
- **Java 21** or higher
- **Paper** 1.21+ (Folia supported)
## Features
- **Nickname as Player** — Fully disguise as another player name + skin with `/nick <player> as <name>`.
- **Name-Only Nicking** — Change just the display name with `/nick <player> with_name <name>`.
- **Skin-Only Changes** — Apply another player's skin with `/nick <player> with_skin <name>`.
- **Mineskin Support** — Apply skins from Mineskin URLs or IDs with `/nick <player> from_url <url>`.
- **Random Nicking** — Generate a random realistic username via the cloud service, with legacy fallback.
- **Persistent Storage** — Local YAML or MongoDB storage. Nicks survive restarts and re-apply on join.
- **TAB Integration** — Automatically updates the TAB plugin's tab list when a nick is applied or reset.
- **Message Rewriting** — Death messages, advancement messages, join/quit messages, and commands all use the nicked name.
- **UUID Spoofing** — Optionally spoof the player's UUID to match the nicked identity (experimental).
- **Cloud Nicking** — Anonymized username pool powered by Lodestone's cloud service for realistic random nicks.
## Installation
1. Download Name Tag from [lode.gg](https://lode.gg/plugin/nametag).
2. Place the JAR into your server's `plugins/` directory.
3. Restart the server.
---
## Related Pages
- [[Name Tag/Server Owners/Configuration]] — Config file reference
- [[Name Tag/Server Owners/Commands]] — Full command and permission listing
- [[Name Tag/Developers/Overview]] — Developer integration guide
- [[Name Tag/Developers/API Reference]] — Name Tag API class reference