# Installing Mods on a Palworld Server (/docs/palworld/mod-installation)



import { File, Folder, Files } from 'fumadocs-ui/components/files';

Palworld supports several types of mods through its native mod system and the UE4SS modding framework.

Mod Types [#mod-types]

| Type           | Path                             | Description                    |
| -------------- | -------------------------------- | ------------------------------ |
| PAK mods       | `Pal/Content/Paks/LogicMods/`    | Compiled Unreal Engine mods    |
| UE4SS Lua mods | `Mods/NativeMods/UE4SS/Mods/`    | Script mods using UE4SS loader |
| Native mods    | Managed via `PalModSettings.ini` | First-party mod system         |

Installing PAK Mods [#installing-pak-mods]

1. Stop your server
2. In the [XGamingServer Panel](https://panel.xgamingserver.com), click **Files**
3. Navigate to (or create) `Pal/Content/Paks/LogicMods/`
4. Upload the `.pak` file
5. Start your server

<Files>
  <Folder name="Pal" defaultOpen>
    <Folder name="Content" defaultOpen>
      <Folder name="Paks" defaultOpen>
        <Folder name="LogicMods" defaultOpen>
          <File name="MyMod.pak" />
        </Folder>
      </Folder>
    </Folder>
  </Folder>
</Files>

Installing UE4SS Mods [#installing-ue4ss-mods]

UE4SS is a modding framework that enables Lua and Blueprint mods.

1. Download and install UE4SS into your server
2. Place mods in `Mods/NativeMods/UE4SS/Mods/{ModName}/`
3. Each mod needs its own subfolder
4. Restart the server

Native Mod System (PalModSettings.ini) [#native-mod-system-palmodsettingsini]

After first launch, the server generates `Mods/PalModSettings.ini`:

```ini
[PalModSettings]
bGlobalEnableMod=true
ActiveModList=ModName1
ActiveModList=ModName2
```

Add one `ActiveModList=` line per mod. The name must match the `PackageName` from the mod's `Info.json`.

Allowing Modded Clients [#allowing-modded-clients]

In `PalWorldSettings.ini`, enable:

```
bAllowClientMod=True
```

Without this, clients with mods installed will be rejected.

Important Notes [#important-notes]

* Only mods with `"IsServer": true` in their `Info.json` work on dedicated servers
* Server must be restarted after adding/removing mods
* Console (Xbox/PS5) players cannot install mods — they can still join if the server has server-side-only mods
* Use `-NoMods` startup flag to temporarily disable all mods

> ⚠️ **Note on Proton:** If running the Windows version via Proton (for mod compatibility), console output is broken. Use RCON or REST API for server management instead.

Related Guides [#related-guides]

* [Server Configuration](/docs/palworld/server-settings)
* [Performance Optimization](/docs/palworld/optimize-performance)
* [Crossplay Setup](/docs/palworld/crossplay-setup)