# Commands

# Commands

All commands use the base command `/ksnameplate` with aliases `/nameplate`, `/np`, `/tag`, `/tags`.

## Player Commands

These commands are available to all players.

### Open Tag Browser

```
/ksnameplate open
```

Opens the Tag Browser UI where players can view available tags, toggle them and see a live preview. Aliases: `menu`, `ui`.

Running `/ksnameplate` without a subcommand shows the list of subcommands.

All player commands need `ks.nameplate.user.use`, which every player has by default. Tags themselves can need their own permission (see [Permissions](./permissions)).

### List Tags

```
/ksnameplate list
```

Lists all available tags in chat. Shows a checkmark for tags the player has permission for and an X for locked tags.

### Activate Tag

```
/ksnameplate set <tag>
```

Activates a tag by its ID (e.g., `vip`, `builder`). The player must have the required permission.

### Deactivate Tag

```
/ksnameplate remove <tag>
```

Deactivates a specific tag by its ID.

### Clear All Tags

```
/ksnameplate clear
```

Removes all active tags from the player.

## Admin Commands

Admin commands require **both** `ks.nameplate.admin` and the permission defined in `config.json` (`permissions.adminPermission`, default: `kyuubisoft.nameplates.admin`).

### Admin Panel

```
/ksnameplate admin panel
```

Opens the Admin UI for managing tags (create, edit, delete).

### Reload Tags

```
/ksnameplate admin reload
```

Reloads all tags from `tags.json` and updates all player nameplates.

### Give Tag

```
/ksnameplate admin give <player> <tag>
```

Activates a tag for another player, bypassing permission checks.

### Take Tag

```
/ksnameplate admin take <player> <tag>
```

Deactivates a tag from another player.