How To Configure Your Starbound Server

Starbound servers are configured through the starbound_server.config file, which is a JSON-formatted file containing all server settings.

Open the XGamingServer Panel

Stop Your Server

Make sure your server is stopped before making changes.

Open Files

In the sidebar, click Files.

Open starbound_server.config

Find and click on starbound_server.config in the server root directory to open it in the editor.

Adjust Settings

Here are the key settings you can modify:

{
    "serverName" : "My Starbound Server",
    "maxPlayers" : 8,
    "serverPort" : 21025,
    "serverPassword" : "",

    "allowAnonymousConnections" : true,
    "allowAssetsMismatch" : true,

    "serverUsers" : {},

    "bannedIPs" : [],
    "bannedUuids" : [],

    "checkAssetsDigest" : false,
    "clearUniverseFiles" : false,
    "clearPlayerFiles" : false
}

Understanding Key Settings

Setting	Description
`serverName`	The name displayed for your server
`maxPlayers`	Maximum concurrent player count
`serverPort`	The port the server listens on
`serverPassword`	Password required to join (empty = no password)
`allowAnonymousConnections`	Allow players without server accounts to join
`allowAssetsMismatch`	Allow players with different assets (mods) to connect
`checkAssetsDigest`	Enforce matching game assets between server and clients
`clearUniverseFiles`	Clear world data on server start
`clearPlayerFiles`	Clear player data on server start

Save and Start Your Server

Click Save and then Start your server.

⚠️ Warning: The configuration file is JSON-formatted. Make sure your syntax is valid (proper commas, quotation marks, and brackets). Invalid JSON will prevent the server from starting.

💡 Tip: If you want to run a modded server, set allowAssetsMismatch to false and checkAssetsDigest to true to ensure all players have the same mods installed. See the Install Mods guide for more details.