Settings

Read and update server settings (server.properties). Supports Java and Bedrock.

GET/servers/:id/settings

Get current server settings. Returns different fields based on server type.

curl "https://www.mado-hosting.com/api/v1/servers/srv_abc123/settings" \
  -H "Authorization: Bearer rsk_your_key"

Java Settings

Fields

Name	Type	Required	Description
`motd`	string	No	Message of the Day
`maxPlayers`	number	No	Maximum players
`difficulty`	string	No	peaceful, easy, normal, hard
`gamemode`	string	No	survival, creative, adventure, spectator
`pvp`	boolean	No	PvP enabled
`viewDistance`	number	No	View distance in chunks
`spawnProtection`	number	No	Spawn protection radius
`whitelist`	boolean	No	Whitelist enabled
`whitelistEnforce`	boolean	No	Enforce whitelist
`hardcore`	boolean	No	Hardcore mode
`allowNether`	boolean	No	Allow Nether
`allowFlight`	boolean	No	Allow flight
`enableCommandBlock`	boolean	No	Enable command blocks
`onlineMode`	boolean	No	Online mode (Mojang auth)
`spawnAnimals`	boolean	No	Spawn animals
`spawnMonsters`	boolean	No	Spawn monsters
`spawnNpcs`	boolean	No	Spawn NPCs
`generateStructures`	boolean	No	Generate structures

Bedrock Settings

Additional Fields

Name	Type	Required	Description
`serverName`	string	No	Server name
`allowCheats`	boolean	No	Allow cheats
`allowList`	boolean	No	Allow list
`tickDistance`	number	No	Tick distance
`playerIdleTimeout`	number	No	Idle timeout in minutes
`levelName`	string	No	World name
`levelSeed`	string	No	World seed
`defaultPlayerPermissionLevel`	string	No	Default permission level
`texturepackRequired`	boolean	No	Texturepack required
`forceGamemode`	boolean	No	Force gamemode

PUT/servers/:id/settings

Update server settings. Server is automatically restarted.

curl -X PUT "https://www.mado-hosting.com/api/v1/servers/srv_abc123/settings" \
  -H "Authorization: Bearer rsk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "maxPlayers": 50, "difficulty": "hard", "pvp": false }'

The server is automatically restarted after the update for changes to take effect.