# How to Connect to Your Soulmask Server (/docs/soulmask/join-server)



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

Find Your Server Address [#find-your-server-address]

<Steps>
  <Step>
    Open the panel [#open-the-panel]

    Log in to the [XGamingServer Panel](https://panel.xgamingserver.com) and select your Soulmask server.
  </Step>

  <Step>
    Copy the IP and port [#copy-the-ip-and-port]

    Click **Network** in the sidebar. Your game address uses port **8777** (UDP) by default.

    {/* Screenshot needed: Network page showing IP and port */}
  </Step>
</Steps>

Connect to Your Server [#connect-to-your-server]

<Tabs items={['Direct Connect', 'Server Browser', 'Invitation Code']}>
  <Tab value="Direct Connect">
    <Steps>
      <Step>
        Open the connect menu [#open-the-connect-menu]

        Launch Soulmask, click **Online Game**, then click **Connect to server directly** at the bottom.
      </Step>

      <Step>
        Enter the address [#enter-the-address]

        Type your server IP and port:

        ```
        123.45.67.89:8777
        ```

        Enter the server password if one is set.
      </Step>

      <Step>
        Connect [#connect]

        Click **Join** to connect.
      </Step>
    </Steps>
  </Tab>

  <Tab value="Server Browser">
    <Steps>
      <Step>
        Open the browser [#open-the-browser]

        Click **Online Game** > **Private Servers**.
      </Step>

      <Step>
        Find your server [#find-your-server]

        Use the search/filter to find your server by name. The name is set via `-SteamServerName` in startup parameters.
      </Step>

      <Step>
        Join [#join]

        Select your server and click **Join**. Enter the password if prompted.
      </Step>
    </Steps>
  </Tab>

  <Tab value="Invitation Code">
    Soulmask servers have a unique invitation code found in the server log.

    1. In the panel, go to **Console** and look for **"SERVER UNIQUE ID"** in the startup output
    2. In-game, enter this code in the invitation code field
    3. Click Join
  </Tab>
</Tabs>

Required Ports [#required-ports]

| Port      | Protocol | Purpose                      |
| --------- | -------- | ---------------------------- |
| **8777**  | UDP      | Game traffic                 |
| **27015** | UDP      | Steam query (server browser) |

Can't Connect? [#cant-connect]

| Problem               | Fix                                                                                   |
| --------------------- | ------------------------------------------------------------------------------------- |
| Server not in browser | Wait for it to fully start (can take 2–3 min). Check **Console** for "Server started" |
| "Version mismatch"    | Update the server — see [Update Guide](/docs/soulmask/update-guide)                   |
| Wrong password        | Check `-PSW` in **Startup**                                                           |
| Connection timeout    | Verify the server is running and ports are correct in **Network**                     |
| Mods mismatch         | Server and client must have matching mods. See [Mod Setup](/docs/soulmask/mod-setup)  |

Related Guides [#related-guides]

* [Server Configuration](/docs/soulmask/server-config)
* [Set a Password](/docs/soulmask/server-password)