# Subnautica Nitrox Admin Commands & Permissions (/docs/subnautica/admin-commands)



import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
import { Step, Steps } from 'fumadocs-ui/components/steps';

Nitrox has a layered permission system. Players get basic chat commands; moderators can kick and broadcast; admins can change server settings and grant permissions; the server console (HOST tier) can do everything.

Permission Tiers [#permission-tiers]

Permissions are ordered low → high. A higher tier inherits everything below it.

| Tier        | Who                     | Can run                                                                                     |
| ----------- | ----------------------- | ------------------------------------------------------------------------------------------- |
| `NONE`      | Banned / restricted     | Nothing                                                                                     |
| `PLAYER`    | Default for new joiners | Basic chat: `help`, `list`, `whisper`, `whois`                                              |
| `MODERATOR` | Trusted players         | Player management: `kick`, `mute`, `broadcast`, plus all Player commands and vanilla cheats |
| `ADMIN`     | Server admins           | Server settings: `op`, `promote`, `gamemode`, password changes, plus all Moderator commands |
| `HOST`      | Server console only     | Everything, including `stop` and `restart`                                                  |

The `DefaultPlayerPerm` setting in `server.cfg` controls what permission new players get on first join. Default is `PLAYER`.

Becoming an Admin In-Game [#becoming-an-admin-in-game]

<Steps>
  <Step>
    Find the admin password [#find-the-admin-password]

    Open `File Manager` in the [panel](https://panel.xgamingserver.com) and read `AdminPassword` from `.config/Nitrox/saves/My World/server.cfg`. Nitrox generates a random one on first boot.
  </Step>

  <Step>
    Open chat in-game [#open-chat-in-game]

    Connect to the server, then press `Y` to open the chat input.
  </Step>

  <Step>
    Run /login [#run-login]

    ```
    /login YourAdminPassword
    ```

    You're now `ADMIN` for this session. Permissions reset on disconnect; promote yourself with `/op` if you want it persistent.
  </Step>
</Steps>

To make the promotion permanent across sessions, log in as admin once and then run:

```
/op YourPlayerName
```

Or set a specific tier:

```
/promote YourPlayerName MODERATOR
```

Where to Run Commands [#where-to-run-commands]

Nitrox commands run in two places:

* **In-game chat** -- press `Y`, type `/command args`. Permissions checked against your in-game tier.
* **Server console** in the panel's `Console` tab -- type `command args` (no `/`). Always runs at `HOST` tier.

Some commands (e.g. `/teleport`, `/back`) only make sense in-game and can't run from the server console.

Command Reference [#command-reference]

<Tabs items={['Player', 'Moderator', 'Admin', 'Host']}>
  <Tab value="Player">
    Available to everyone, including new joiners.

    | Command                       | Description                                 |
    | ----------------------------- | ------------------------------------------- |
    | `/help` or `/?`               | List all commands available to you          |
    | `/help <command>`             | Show usage for a specific command           |
    | `/list`                       | Show who's online                           |
    | `/whoami`                     | Show your own permission tier               |
    | `/whois <player>`             | Show info about another player              |
    | `/whisper <player> <message>` | Send a private message                      |
    | `/login <password>`           | Authenticate as admin using `AdminPassword` |
  </Tab>

  <Tab value="Moderator">
    Player management. Includes everything from Player tier.

    | Command                 | Description                         |
    | ----------------------- | ----------------------------------- |
    | `/kick <player>`        | Kick a player from the server       |
    | `/mute <player>`        | Mute a player in chat               |
    | `/unmute <player>`      | Unmute a player                     |
    | `/broadcast <message>`  | Send a server-wide announcement     |
    | `/save`                 | Force an immediate world save       |
    | `/teleport <x> <y> <z>` | Teleport to coordinates             |
    | `/back`                 | Teleport back to your last location |
    | `/warp <player>`        | Teleport to a player                |
    | `/summary`              | Show summary of persisted save data |
    | `/time <modification>`  | Change the in-game time of day      |

    Moderators also have access to vanilla Subnautica cheat commands (e.g. `item`, `spawn`, `nodamage`).
  </Tab>

  <Tab value="Admin">
    Server settings and permissions. Includes everything from Moderator tier.

    | Command                            | Description                                                      |
    | ---------------------------------- | ---------------------------------------------------------------- |
    | `/op <player>`                     | Promote a player to `ADMIN`                                      |
    | `/deop <player>`                   | Demote an admin back to `PLAYER`                                 |
    | `/promote <player> <perm>`         | Set a player to a specific tier (`PLAYER`/`MODERATOR`/`ADMIN`)   |
    | `/gamemode <mode>`                 | Change game mode (`survival`, `freedom`, `hardcore`, `creative`) |
    | `/changeserverpassword <password>` | Change or clear (no arg) the server password                     |
    | `/changeadminpassword <password>`  | Change the admin password                                        |
    | `/autosave <on\|off>`              | Enable or disable auto-save                                      |
    | `/setkeepinventory <true\|false>`  | Toggle whether players keep items on death                       |
    | `/pvp <on\|off>`                   | Enable or disable PvP                                            |
    | `/aurora <action>`                 | Trigger Aurora story events                                      |
    | `/sunbeam <event>`                 | Trigger Sunbeam story events                                     |
    | `/fast <hatch\|grow> <on\|off>`    | Speed up egg hatching or plant growth                            |
    | `/config`                          | Open the server config file                                      |
  </Tab>

  <Tab value="Host">
    Only available from the server console (the `Console` tab in the panel). Includes all lower tiers.

    | Command   | Description             |
    | --------- | ----------------------- |
    | `restart` | Restart the server      |
    | `stop`    | Stop the server cleanly |

    The server console runs at `HOST` tier so every command listed under Player/Moderator/Admin also works there -- without the leading `/`.
  </Tab>
</Tabs>

Common Recipes [#common-recipes]

**Promote a friend to admin permanently:**

```
/op AlexUnderwater
```

**Open the server temporarily for a public event:**

```
/changeserverpassword
/broadcast Public night! Server is open.
```

**Switch to creative for building, then back to survival:**

```
/gamemode creative
... building happens ...
/gamemode survival
```

**Force a save before shutting down:**

```
/save
```

Then in the server console:

```
stop
```

Permission Errors [#permission-errors]

**"You're not allowed to update X's permissions"** -- you can't promote someone whose current permissions are higher than yours. Promote yourself first via the server console or have a `HOST`-tier admin do it.

**"Your permissions must be higher than the perms you want to assign"** -- you can't grant a tier above your own. An `ADMIN` cannot create another `HOST`; that requires the server console.

**"You can't promote yourself"** -- self-promotion is blocked by design. Run `/op` from the server console for an out-of-band promotion.

Related [#related]

* [Server Password](/docs/subnautica/server-password) -- setting and rotating passwords
* [Configure Your Server](/docs/subnautica/configure-your-server) -- full settings reference