> ## Documentation Index
> Fetch the complete documentation index at: https://catalyst.leifiyo.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Server properties

> Edit server.properties from the Catalyst detail page.

The **Properties** tab reads and writes the server's `server.properties` file. Catalyst parses the file into editable key-value rows and saves changes back to disk.

## Common properties

| Property              | Typical use                                               |
| --------------------- | --------------------------------------------------------- |
| `motd`                | Server list message.                                      |
| `max-players`         | Player limit shown to clients and enforced by the server. |
| `difficulty`          | World difficulty.                                         |
| `pvp`                 | Enable or disable player combat.                          |
| `view-distance`       | Chunk view distance.                                      |
| `simulation-distance` | Tick simulation radius.                                   |
| `white-list`          | Enable whitelist enforcement.                             |
| `enforce-whitelist`   | Kick players who are removed from the whitelist.          |

<Warning>
  Many server properties are only read during startup. Save the file, then restart the server when changing ports, whitelist behavior, view distances, or gameplay rules that the server caches.
</Warning>

## Workflow

<Steps>
  <Step title="Open the server detail page">
    Select a server from Dashboard or Servers.
  </Step>

  <Step title="Choose Properties">
    Use search to filter long property lists.
  </Step>

  <Step title="Edit values">
    Catalyst saves plain strings, numbers, and booleans exactly as the server expects them in `server.properties`.
  </Step>

  <Step title="Save and restart when needed">
    Save writes the file. Restart if the property is not hot-reloaded by the server software.
  </Step>
</Steps>

<Info>
  Backend handlers exist for whitelist and banlist files. In the current UI, the visible tab navigation does not expose a separate player-list editor, so use server commands or the Files tab for those files.
</Info>