---
url: https://lc.m1sk9.dev/docs/reference/commands.md
---

# Command Reference

A reference for all commands available in LunaticChat.

## Direct Messages

### `/tell <player> <message>` / `/tell <player>@<server> <message>`

Sends a direct message to a player.

When a server name is specified, the message is sent to the player on that server.

* **Aliases**: `t`, `msg`, `m`, `w`, `whisper`
* **Permission**: `lunaticchat.command.tell`

### `/reply <message>`

Replies to the last player who sent you a message.

* **Aliases**: `r`
* **Permission**: `lunaticchat.command.reply`
* **Prerequisite**: Quick reply feature must be enabled

## Main Command (`/lc`)

**Aliases**: `lunaticchat`

### `/lc status`

Displays the plugin version, health, enabled features, and configuration values.

* **Aliases**: `st`
* **Permission**: `lunaticchat.command.lc.status`

### `/lc reload`&#x20;

Re-reads `config.yml` and applies the `messageFormat` settings, then reports which of the remaining changes still need a restart. See [Applying Changes](/docs/configuration#applying-changes).

* **Permission**: `lunaticchat.command.lc.reload` (op by default)
* **Usable from the console and RCON**
* A `config.yml` that cannot be read in full is refused, and the running configuration is kept

### `/lc debug [category] [on|off]`&#x20;

Shows which debug categories are logging, or switches one. `all` stands for every category. See [Debug Logging](/docs/configuration#debug-logging).

* **Permission**: `lunaticchat.command.lc.debug` (op by default)
* **Usable from the console and RCON**
* The change is not written to `config.yml`; a restart or `/lc reload` puts the file back in charge

### `/lc dump`&#x20;

Writes a diagnostics report to `plugins/LunaticChat/debug/` and confirms it in chat; the exact path is left to the server log. It holds versions, enabled features, connection state and store sizes, and no message text, player name or UUID.

* **Permission**: `lunaticchat.command.lc.dump` (op by default)
* **Usable from the console and RCON**

### `/lc settings [key] [on|off]`

Views or changes your personal settings. Without arguments, displays the settings list.

* **Aliases**: `set`
* **Permission**: `lunaticchat.command.lc.settings`
* **Setting keys**: `japanese`, `notice`, `chNotice` (see [Player Settings](/docs/reference/player-settings) for details)

## Channel Commands (`/lc channel`)

**Aliases**: `ch`

Only available when the channel chat feature is enabled.

### Create & Browse

#### `/lc channel create <channelId> <name> [description] [isPrivate]`

Creates a new channel. The creator becomes the owner.

* **Aliases**: `new`
* **Permission**: `lunaticchat.command.lc.channel.create`
* `channelId`: 3-30 characters; only alphanumeric characters, underscores, and hyphens are allowed
* `name`: Cannot be blank
* `isPrivate`: `true` / `false` (default: `false`)

#### `/lc channel list [page]`

Displays a list of public channels (10 per page).

* **Aliases**: `ls`
* **Permission**: `lunaticchat.command.lc.channel.list`

#### `/lc channel info [channelId]`

Displays detailed information about a channel. Without arguments, shows information about the active channel. A private channel is shown only to its members and to players with `lunaticchat.channelbypass`; to anyone else it is reported as not found.

* **Aliases**: `i`
* **Permission**: `lunaticchat.command.lc.channel.info`

### Join & Leave

#### `/lc channel join <channelId>`

Joins a channel. A private channel can only be joined with an invitation, which this command accepts and uses up.

* **Aliases**: `j`
* **Permission**: `lunaticchat.command.lc.channel.join`

#### `/lc channel leave`

Leaves the active channel.

* **Aliases**: `l`
* **Permission**: `lunaticchat.command.lc.channel.leave`

#### `/lc channel switch <channelId>`

Switches the active channel to another channel you have already joined.

* **Aliases**: `sw`
* **Permission**: `lunaticchat.command.lc.channel.switch`

#### `/lc channel status`

Displays your channel membership status (active channel and list of joined channels).

* **Aliases**: `st`
* **Permission**: `lunaticchat.command.lc.channel.status`

### Moderation (Owner / Moderator)

#### `/lc channel invite <playerName>`

Invites an online player to the active channel. The player is not added until they accept with `/lc channel join <channelId>` within 5 minutes, which also admits them to a private channel. Their active channel is left unchanged until then.

* **Aliases**: `inv`
* **Permission**: `lunaticchat.command.lc.channel.invite`
* **Required role**: OWNER or MODERATOR

#### `/lc channel kick <playerName>`

Kicks a player from the active channel. Only a player with a lower role than yours can be kicked, so a moderator can kick members but not the owner or other moderators.

* **Aliases**: `k`
* **Permission**: `lunaticchat.command.lc.channel.kick`
* **Required role**: OWNER or MODERATOR

#### `/lc channel ban <playerName>`

Bans a player from the active channel. Banned players cannot rejoin. As with kicks, only a player with a lower role than yours can be banned.

* **Permission**: `lunaticchat.command.lc.channel.ban`
* **Required role**: OWNER or MODERATOR

#### `/lc channel unban <playerName>`

Unbans a player from the channel.

* **Permission**: `lunaticchat.command.lc.channel.unban`
* **Required role**: OWNER or MODERATOR

### Administration (Owner Only)

#### `/lc channel delete <channelId>`

Deletes a channel.

* **Aliases**: `del`
* **Permission**: `lunaticchat.command.lc.channel.delete`
* **Required role**: OWNER (can be bypassed with `lunaticchat.channelbypass` permission)

#### `/lc channel mod <playerName>`

Grants or revokes moderator privileges for a channel member.

* **Permission**: `lunaticchat.command.lc.channel.mod`
* **Required role**: OWNER

#### `/lc channel ownership <playerName>`

Transfers channel ownership to another member.

* **Aliases**: `own`
* **Permission**: `lunaticchat.command.lc.channel.ownership`
* **Required role**: OWNER

## Velocity Commands (`/lcv`)

**Aliases**: `lunaticvelocity`

### `/lcv status`

Displays the connection status with the Velocity proxy, protocol version, and online player count.

* **Aliases**: `st`
* **Permission**: `lunaticchat.command.lcv.status`
* **Default**: op only