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

# Minecraft Bedrock server properties

> Edit common Minecraft Bedrock Edition settings in server.properties on a Purpify server.

The `server.properties` file controls gameplay, access, networking, performance, and scripting settings for a native Minecraft Bedrock Edition server.

## Edit server.properties

<Steps>
  <Step title="Create a backup">
    Create a [server backup](/server/backups) before changing several settings or an unfamiliar advanced property.
  </Step>

  <Step title="Stop the server">
    Stop the server so it does not overwrite the file while you edit it.
  </Step>

  <Step title="Open the file">
    Open the file manager and select `server.properties` in the server's main directory.
  </Step>

  <Step title="Change the setting">
    Keep one property per line in `name=value` format. Use an accepted value and do not add spaces around `=`.

    ```properties theme={"dark"}
    difficulty=normal
    ```
  </Step>

  <Step title="Save and restart">
    Save the file, start the server, and watch the console for an invalid-value or configuration error.
  </Step>
</Steps>

<Warning>
  Do not change `server-port`, `server-portv6`, or other network fields unless Purpify instructs you to. The server must use its assigned network allocation.
</Warning>

## Gameplay and world properties

| Property               | Accepted value or purpose                                                       |
| ---------------------- | ------------------------------------------------------------------------------- |
| `allow-cheats`         | `true` or `false`; allows commands that require cheats.                         |
| `difficulty`           | `peaceful`, `easy`, `normal`, or `hard`.                                        |
| `gamemode`             | `survival`, `creative`, or `adventure` for new players.                         |
| `force-gamemode`       | `true` forces the configured game mode instead of the world's saved mode.       |
| `level-name`           | Selects the world folder used by the server.                                    |
| `level-seed`           | Sets the seed used when generating a world.                                     |
| `tick-distance`        | Controls how many nearby chunks continue ticking. Supported range: `4` to `12`. |
| `view-distance`        | Limits the number of chunks sent around each player.                            |
| `texturepack-required` | `true` requires players to accept the server resource pack.                     |

## Player and access properties

| Property                          | Accepted value or purpose                                                      |
| --------------------------------- | ------------------------------------------------------------------------------ |
| `allow-list`                      | `true` restricts connections to players in `allowlist.json`.                   |
| `default-player-permission-level` | `visitor`, `member`, or `operator`.                                            |
| `max-players`                     | A positive number limiting simultaneous players.                               |
| `online-mode`                     | Controls Xbox Live authentication; keep enabled for an internet-facing server. |
| `player-idle-timeout`             | Minutes before an idle player is removed; `0` disables the timeout.            |
| `chat-restriction`                | `None`, `Dropped`, or `Disabled`.                                              |
| `disable-custom-skins`            | `true` blocks skins created outside Minecraft's provided assets.               |
| `disable-player-interaction`      | `true` tells clients to ignore interactions involving other players.           |

## Performance and networking properties

| Property                                          | Accepted value or purpose                                                       |
| ------------------------------------------------- | ------------------------------------------------------------------------------- |
| `server-name`                                     | The name advertised by the Bedrock server; do not use a semicolon.              |
| `max-threads`                                     | Maximum server threads; `0` allows all available threads.                       |
| `compression-algorithm`                           | `zlib` or `snappy`.                                                             |
| `compression-threshold`                           | Payload size at which network compression begins.                               |
| `enable-lan-visibility`                           | Controls whether the server responds to LAN discovery.                          |
| `client-side-chunk-generation-enabled`            | Allows supported clients to generate visual chunks beyond interaction distance. |
| `player-position-acceptance-threshold`            | Controls tolerance for client and server position differences.                  |
| `server-authoritative-movement-strict`            | Enables stricter correction of player movement differences.                     |
| `server-authoritative-entity-interactions-strict` | Enables stricter validation of entity interactions.                             |
| `server-authoritative-dismount-strict`            | Enables stricter validation of dismount positions.                              |

## Scripting and diagnostics properties

| Property                          | Accepted value or purpose                                          |
| --------------------------------- | ------------------------------------------------------------------ |
| `content-log-file-enabled`        | Writes content errors to a log file when enabled.                  |
| `allow-inbound-script-debugging`  | Allows the script debugger to listen for a connection.             |
| `allow-outbound-script-debugging` | Allows the script debugger to connect outward.                     |
| `script-debugger-auto-attach`     | `disabled`, `connect`, or `listen`.                                |
| `script-debugger-passcode`        | Passcode used by a permitted debugger connection. Keep it private. |
| `script-watchdog-enable`          | Enables monitoring for scripts that hang or exceed limits.         |
| `script-watchdog-memory-limit`    | Script memory limit in megabytes; `0` disables the limit.          |
| `script-watchdog-memory-warning`  | Combined script memory usage that produces a warning.              |

<Note>
  Leave advanced debugging, movement-validation, compression, and watchdog settings unchanged unless an add-on author or Purpify support gives you a specific value.
</Note>

## Common configuration tasks

<Columns cols={2}>
  <Card title="Enable cheats" icon="terminal" href="/bedrock/enable-cheats">
    Set `allow-cheats` safely and restart the server.
  </Card>

  <Card title="Change difficulty" icon="skull" href="/bedrock/change-difficulty">
    Choose Peaceful, Easy, Normal, or Hard.
  </Card>

  <Card title="Manage the allowlist" icon="user-shield" href="/bedrock/whitelist">
    Restrict the server to approved Xbox Gamertags.
  </Card>

  <Card title="Manage files" icon="folder-open" href="/panel/files-and-sftp">
    Edit configuration files and keep safe copies.
  </Card>
</Columns>