# Palworld Server Configuration Generator

PalCenter includes a standalone generator under **Tools → Server Configuration
Generator**. It creates validated `PalWorldSettings.ini` content in the browser
and provides copy and download actions.

> **Current coverage:** The generator supports a curated subset of **24 commonly
> used settings**, not every Palworld setting. The downloaded file is a valid
> standalone partial `OptionSettings` configuration; omitted settings continue
> to use Palworld defaults.

The generator does **not** read, update, restart, or otherwise modify a
connected Palworld server. Password fields and generated content remain in the
current browser tab and are not sent to the PalCenter API or saved in browser
storage. Passwords are redacted in the visual preview by default, but copied
and downloaded configurations contain the configured plaintext credentials.

## Using the generated file

Pocketpair documents these standard locations after the dedicated server has
been started at least once:

- Linux:
  `steamapps/common/PalServer/Pal/Saved/Config/LinuxServer/PalWorldSettings.ini`
- Windows:
  `steamapps\common\PalServer\Pal\Saved\Config\WindowsServer\PalWorldSettings.ini`

Back up the existing file and follow the operating procedure for your Palworld
deployment before replacing it. Editing `DefaultPalWorldSettings.ini` itself
does not apply settings to the server.

## Schema basis and limitations

Schema version 1 was reviewed on 2026-07-25 against Pocketpair's
[Palworld Server Guide](https://docs.palworldgame.com/settings-and-operation/configuration/)
and `DefaultPalWorldSettings.ini` downloaded directly through SteamCMD from
Palworld Dedicated Server app `2394010`, Steam build `24181105` (Palworld 1.0).
The verified template has SHA-256
`4865FA1EB01D07E010B69E6269F955D24AA658E7B66AEA742B81AFB01BA7AC81`.

The initial schema intentionally covers a conservative set of commonly used
settings. Palworld includes additional current, reserved, and deprecated keys
that are not generated. Numeric limits are shown only where documented or
where the value is a valid network port. PalCenter presets are convenience
starting points and are not official Pocketpair recommendations.

## Partial configuration compatibility

The 24-setting partial configuration was validated on 2026-07-25 against the
same Palworld Dedicated Server Steam build `24181105`. The running server
reported version `v1.0.1.100619`.

The validation used a clean, disposable Windows PalServer installation:

1. The server was started with the complete `DefaultPalWorldSettings.ini`
   template, with only the test identity, ports, REST API, and disposable
   administrator credential changed.
2. The authenticated REST API `/v1/api/settings` response was captured as the
   complete-template baseline.
3. The server was stopped cleanly and `PalWorldSettings.ini` was replaced with
   the 24-setting fixture generated by PalCenter.
4. The server started without configuration parsing or startup errors and
   returned 117 effective settings through `/v1/api/settings`.
5. Representative omitted values retained their defaults:
   - numeric multiplier: `BuildObjectHpRate=1.0`
   - integer limit: `DropItemMaxNum=3000`
   - boolean: `bEnableInvaderEnemy=True`
   - URL string:
     `BanListURL="https://b.palworldgame.com/api/banlist.txt"`
6. After a clean shutdown and full process restart, the complete effective
   settings response was unchanged and no parsing errors were reported.

The tested output is retained as
`apps/frontend/test/fixtures/palworld-settings-build-24181105.partial.ini`, and
an automated test confirms that the current serializer still produces that
fixture exactly.

Importing an existing file, preserving unknown settings, comparing
configurations, applying settings to connected servers, and automatic rollback
are not included in this version.