# Commands
Name Tag registers the `/nick`, `/randomnick`, and `/nametag` top-level commands.
---
## /nick
The primary nicking command. Supports multiple actions for changing a player's name, skin, or both.
| Action | Usage | Description |
|---|---|---|
| `as` | `/nick <targets> as <name>` | Disguise as another player (name + skin). |
| `with_name` | `/nick <targets> with_name <name>` | Change display name only (keeps original skin). |
| `with_skin` | `/nick <targets> with_skin <name>` | Change skin only (keeps original name). |
| `from_url` | `/nick <targets> from_url <mineskin_url>` | Apply a skin from a Mineskin URL or ID. |
| `reset` | `/nick <targets> reset` | Reset the target's nick and skin to their original identity. |
### /nick subcommands
| Subcommand | Usage | Permission | Description |
|---|---|---|---|
| `reset` | `/nick reset` | `lodestone.nametag.commands.nick.reset` | Reset your own nick. |
| `reset_all` | `/nick reset_all` | `lodestone.nametag.commands.nick.reset_all` | Reset **all** players' nicks and wipe stored data. |
| `save_all` | `/nick save_all` | `lodestone.nametag.commands.nick.save_all` | Force-save all online players' nick data. |
| `save_cached` | `/nick save_cached` | `lodestone.nametag.commands.nick.save_cached` | Force-save all cached player data. |
---
## /randomnick
| Usage | Permission | Description |
|---|---|---|
| `/randomnick` | `lodestone.nametag.commands.randomnick` | Generate and apply a random nick to yourself. |
| `/randomnick <target>` | `lodestone.nametag.commands.randomnick.others` | Generate and apply a random nick to another player. |
Uses the cloud nicking service (if `allow_cloud_nicking: true`) to generate realistic usernames from a pool of real player names. Falls back to the legacy `UsernameGenerator` if the cloud service is unavailable.
---
## /nametag
| Subcommand | Usage | Permission | Description |
|---|---|---|---|
| `version` | `/nametag version` | *(none)* | Displays the current Name Tag version. |
| `refresh_player` | `/nametag refresh_player <target>` | `lodestone.commands.nametag.refresh_player` | Force-refresh a player's profile (re-sends skin/name to all clients). |
| `reload` | `/nametag reload` | `lodestone.commands.nametag.reload` | Reloads the configuration from disk. |
| `debug` | `/nametag debug <target>` | `lodestone.commands.nametag.debug` | Shows a player's original name, UUID, nickname, and nicked UUID. |
---
## Permissions
| Permission | Description |
|---|---|
| `lodestone.nametag.commands.nick` | Use `/nick` to nick yourself. |
| `lodestone.nametag.commands.nick.others` | Nick other players. |
| `lodestone.nametag.commands.nick.reset` | Reset your own nick. |
| `lodestone.nametag.commands.nick.reset_all` | Reset all nicks server-wide. |
| `lodestone.nametag.commands.nick.save_all` | Force-save all online players. |
| `lodestone.nametag.commands.nick.save_cached` | Force-save all cached data. |
| `lodestone.nametag.commands.randomnick` | Use `/randomnick` on yourself. |
| `lodestone.nametag.commands.randomnick.others` | Use `/randomnick` on others. |
| `lodestone.commands.nametag.refresh_player` | Refresh a player's profile. |
| `lodestone.commands.nametag.reload` | Reload configuration. |
| `lodestone.commands.nametag.debug` | View debug info for a player. |
---
## Related Pages
- [[Name Tag/Server Owners/Overview]] — Plugin overview and installation
- [[Name Tag/Server Owners/Configuration]] — Config file reference