> ## Documentation Index
> Fetch the complete documentation index at: https://pumpkings.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# PumpkinMsg Commands Reference: All Commands Listed

> Full reference for every PumpkinMsg command — player messaging, ignore, togglemsg, socialspy, cmdspy, and the admin reload command with all aliases.

PumpkinMsg registers all of its commands on both Paper and Velocity using the same command names and aliases. Player-facing commands require no special permission node. Staff and admin commands are gated behind dedicated permissions described in the [Permissions](/msg/permissions) page.

## Player Commands

These commands are available to every player on your server or proxy by default.

| Command                   | Aliases                   | Description                                                                          |
| ------------------------- | ------------------------- | ------------------------------------------------------------------------------------ |
| `/msg <player> <message>` | `/w`, `/tell`, `/message` | Sends a private message to the named player. Tab-completion suggests online players. |
| `/reply <message>`        | `/r`                      | Replies to the last player who messaged you (or to whom you last sent a message).    |
| `/ignore <player>`        | —                         | Toggles the ignore state for the named player. Run it again to unignore them.        |
| `/togglemsg`              | `/tmsg`, `/pmtoggle`      | Enables or disables all incoming private messages for yourself.                      |

### `/msg`

`/msg` opens or continues a private conversation with another online player. The first argument is the target player's username; everything after it is the message body.

```bash theme={null}
/msg Steve Hey, are you at the shop?
/w Alex Come to spawn!
/tell Notch Long time no see.
```

<Note>
  You cannot message yourself. If your own private messages are disabled via `/togglemsg`, the plugin will tell you before attempting to deliver the message.
</Note>

### `/reply`

`/reply` sends a message to the last player involved in your conversation — either the last person who wrote to you or the last person you wrote to. The reply target resets if that player goes offline.

```bash theme={null}
/reply I'll be there in a minute.
/r On my way!
```

### `/ignore`

`/ignore` is a toggle. Running it once blocks all incoming messages from the named player. Running it again removes the block. Ignore state persists across server restarts.

```bash theme={null}
/ignore Griefer123
```

<Tip>
  Staff members with the `pumpkinmsg.staff.bypass` permission can still message players who have ignored them, ensuring moderators always have a way to reach any player.
</Tip>

### `/togglemsg`

`/togglemsg` switches your private message availability on or off. When your messages are off, no one can send you a `/msg` — unless they hold the bypass permission.

```bash theme={null}
/togglemsg
/tmsg
/pmtoggle
```

## Staff Commands

Staff commands require specific permission nodes. See the [Permissions](/msg/permissions) page for details.

| Command                              | Aliases   | Permission                | Description                                                                                   |
| ------------------------------------ | --------- | ------------------------- | --------------------------------------------------------------------------------------------- |
| `/socialspy [player]`                | `/spy`    | `pumpkinmsg.staff.spy`    | Toggles global SocialSpy, or watches a single player's conversations when a name is provided. |
| `/spycommands [server\|global\|off]` | `/cmdspy` | `pumpkinmsg.staff.cmdspy` | Toggles command monitoring with optional scope filtering.                                     |

### `/socialspy`

Running `/socialspy` with no argument toggles global spy mode — you will see all private messages on the network. Running it with a player name pins your spy feed to that player's conversations only.

```bash theme={null}
/socialspy            # toggle global spy on/off
/socialspy Steve      # watch only Steve's conversations
/spy Alex             # alias form
```

### `/spycommands`

`/spycommands` lets you monitor the commands players run. On Velocity you can scope the feed to a specific backend server.

```bash theme={null}
/spycommands          # toggle cmdspy on/off (global)
/spycommands survival # watch only the "survival" server
/spycommands global   # watch all servers
/spycommands off      # disable cmdspy
/cmdspy               # alias form
```

<Warning>
  Sensitive commands are automatically masked in the cmdspy output and never shown to staff. The masked commands are: `/login`, `/register`, and `/changepassword`. This protects player account credentials regardless of cmdspy settings.
</Warning>

## Admin Commands

| Command          | Aliases | Permission                | Description                                                       |
| ---------------- | ------- | ------------------------- | ----------------------------------------------------------------- |
| `/pumpkinreload` | —       | `pumpkinmsg.admin.reload` | Hot-reloads `config.toml` without restarting the server or proxy. |

### `/pumpkinreload`

`/pumpkinreload` reads the current state of `config.toml` and applies all changes immediately. Format strings, message strings, and any other configuration values update without a restart.

```bash theme={null}
/pumpkinreload
```

A green confirmation message (`reload-success`) appears if the file loaded successfully. If the TOML file contains a syntax error, the plugin logs a warning and keeps the previously loaded configuration active.