# ⌨️ Commands Overview

{% hint style="warning" %}
Most command names and aliases are configurable in each module YAML file.

The commands shown here are the default commands shipped with NexusProxy.
{% endhint %}

***

### Core Commands

These commands are part of the main NexusProxy administration system.

| Command                       | Description                              |
| ----------------------------- | ---------------------------------------- |
| `/nexusproxy reload`          | Reloads NexusProxy.                      |
| `/nexusproxy reload <module>` | Reloads a specific module, if supported. |
| `/nexusproxy modules`         | Shows loaded NexusProxy modules.         |
| `/nexusproxy storage`         | Shows Redis and database storage status. |
| `/nproxy`                     | Alias for `/nexusproxy`.                 |
| `/np`                         | Alias for `/nexusproxy`.                 |

***

### Main Module

| Command             | Description                                         |
| ------------------- | --------------------------------------------------- |
| `/alert`            | Sends a network-wide alert message.                 |
| `/alertraw`         | Sends a raw formatted network-wide alert.           |
| `/find`             | Finds a player on the network.                      |
| `/glist`            | Shows the global player list.                       |
| `/plist`            | Shows the proxy player list.                        |
| `/send`             | Sends a player to a backend server.                 |
| `/server`           | Shows or switches backend servers.                  |
| `/shutdown`         | Shuts down the proxy using the configured behavior. |
| `/velocity plugins` | Shows Velocity plugin information.                  |
| `/velocity info`    | Shows Velocity proxy information.                   |
| `/velocity reload`  | Reloads Velocity.                                   |
| `/velocity sudo`    | Forces a player to run a command.                   |
| `/velocity uptime`  | Shows proxy uptime.                                 |

***

### Messaging Module

| Command                   | Description                                       |
| ------------------------- | ------------------------------------------------- |
| `/msg <player> <message>` | Sends a private message to a player.              |
| `/reply <message>`        | Replies to the last private message conversation. |
| `/ignore <player>`        | Ignores or unignores a player.                    |
| `/socialspy`              | Toggles social spy mode.                          |
| `/msgtoggle`              | Toggles receiving private messages.               |

***

### Lobby Module

| Command  | Description                                    |
| -------- | ---------------------------------------------- |
| `/lobby` | Sends the player to a configured lobby server. |
| `/hub`   | Alias for the lobby command.                   |
| `/hubs`  | Alias for the lobby command.                   |

***

### MultiLobby Module

| Command       | Description                                                      |
| ------------- | ---------------------------------------------------------------- |
| `/multilobby` | Sends the player to a lobby using the MultiLobby routing system. |
| `/mlobby`     | Alias for the MultiLobby command.                                |

***

### Staff Module

| Command      | Description                                              |
| ------------ | -------------------------------------------------------- |
| `/staffchat` | Sends or toggles staff chat, depending on configuration. |
| `/adminchat` | Sends or toggles admin chat, depending on configuration. |
| `/donorchat` | Sends or toggles donor chat, depending on configuration. |
| `/stafflist` | Shows the online staff list.                             |
| `/staffafk`  | Toggles staff AFK status.                                |

***

### Maintenance Module

| Command                  | Description                                                        |
| ------------------------ | ------------------------------------------------------------------ |
| `/maintenance status`    | Shows the current maintenance status.                              |
| `/maintenance on`        | Enables maintenance mode.                                          |
| `/maintenance off`       | Disables maintenance mode.                                         |
| `/maintenance countdown` | Starts a maintenance countdown.                                    |
| `/maintenance abort`     | Aborts an active maintenance countdown.                            |
| `/maintenance whitelist` | Manages the maintenance whitelist.                                 |
| `/maintenance scopes`    | Shows available maintenance scopes.                                |
| `/maintenance scope`     | Manages or toggles scoped maintenance, depending on configuration. |

***

### Placeholders Module

| Command                | Description                               |
| ---------------------- | ----------------------------------------- |
| `/nplaceholder <text>` | Tests proxy-side placeholder replacement. |
| `/npapi <text>`        | Alias for the placeholder test command.   |

***

### Stream Module

| Command                    | Description                                             |
| -------------------------- | ------------------------------------------------------- |
| `/stream <platform> <url>` | Announces a stream using the selected platform and URL. |

***

### Announcer Module

| Command              | Description                                                  |
| -------------------- | ------------------------------------------------------------ |
| `/announcer toggle`  | Toggles receiving announcements, depending on configuration. |
| `/announcer preview` | Previews an announcement.                                    |
| `/announcer send`    | Sends a manual announcement.                                 |
| `/announcements`     | Alias for the announcer command.                             |

***

### Donations Module

| Command                | Description                                |
| ---------------------- | ------------------------------------------ |
| `/donations status`    | Shows the current Donations module status. |
| `/donations broadcast` | Sends a manual donation broadcast.         |
| `/donations test`      | Sends a test donation broadcast.           |
| `/donationbroadcast`   | Alias for donation broadcast features.     |
| `/dnotify`             | Alias for donation notification features.  |

***

### Friends Module

| Command                      | Description                                                    |
| ---------------------------- | -------------------------------------------------------------- |
| `/friends`                   | Opens or shows the main friends command.                       |
| `/friends add <player>`      | Sends a friend request to a player.                            |
| `/friends accept <player>`   | Accepts a friend request.                                      |
| `/friends remove <player>`   | Removes a player from your friends list.                       |
| `/friends where <player>`    | Shows where a friend is playing.                               |
| `/friends transmit <player>` | Sends or connects you to a friend, depending on configuration. |

***

### HelpOp Module

| Command     | Description                                                              |
| ----------- | ------------------------------------------------------------------------ |
| `/helpop`   | Sends a help request to staff.                                           |
| `/helpcore` | Main HelpOp management command, depending on configuration.              |
| `/homove`   | Moves a HelpOp ticket, depending on configuration.                       |
| `/hor`      | Replies to a HelpOp ticket, depending on configuration.                  |
| `/hr`       | Short alias for replying to a HelpOp ticket, depending on configuration. |

***

### Report Module

| Command                     | Description                                                          |
| --------------------------- | -------------------------------------------------------------------- |
| `/report <player> <reason>` | Submits a report against a player.                                   |
| `/reports list`             | Shows pending reports, depending on configuration.                   |
| `/reports resolve`          | Resolves a pending report, depending on configuration.               |
| `/reports notify`           | Toggles or manages report notifications, depending on configuration. |

***

### Custom Commands Module

Custom commands are defined in the module configuration file.

Default example commands may include:

| Command    | Description                                |
| ---------- | ------------------------------------------ |
| `/discord` | Shows the network Discord link or message. |
| `/store`   | Shows the network store link or message.   |
| `/web`     | Shows the network website link or message. |

{% hint style="info" %}
Custom command names, aliases, permissions, cooldowns, and actions are configured in `customcommands.yml`.
{% endhint %}

***

### Queue Module

| Command       | Description                                           |
| ------------- | ----------------------------------------------------- |
| `/queue`      | Joins or manages a queue, depending on configuration. |
| `/leavequeue` | Leaves the current queue.                             |
| `/queuelist`  | Shows queue information, usually for staff or admins. |

***

### Ping Module

| Command          | Description                  |
| ---------------- | ---------------------------- |
| `/ping`          | Shows your own ping.         |
| `/ping <player>` | Shows another player's ping. |

***

### Modules Without Default Player Commands

Some modules do not provide default player commands and are mainly controlled through configuration.

| Module            | Notes                                                            |
| ----------------- | ---------------------------------------------------------------- |
| MOTD              | Configured through `motd.yml`.                                   |
| HealthIndicator   | Configured through `healthindicator.yml`. Requires PacketEvents. |
| TabCompleteFilter | Configured through `tabcompletefilter.yml`.                      |

***

### Command Conflicts

If another plugin registers the same command, edit the command name or aliases inside the related module configuration file.

Example:

```
plugins/NexusProxy/modules/messaging/messaging.yml
```

or:

```
plugins/NexusProxy/modules/friends/friends.yml
```

{% hint style="info" %}
If a command does not work, always check whether another proxy plugin or backend plugin is already using the same command.
{% endhint %}

***

### Recommended Setup Tips

* Keep player commands simple and easy to remember.
* Avoid giving administrative commands to lower staff ranks.
* Review permissions before opening commands to players.
* Rename commands if they conflict with another plugin.
* Use aliases for common shortcuts.
* Use LuckPerms to control command access by rank.
* Test commands with a normal player account before releasing the setup publicly.
* Check each module YAML file before assuming a command name is fixed.

***

### Next Page

Continue to the Permissions page to view the default NexusProxy permissions by module.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://nexusproxy.nemesismc.net/commands-and-permissions/commands-overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
