PalSchema is a modding framework for Palworld that lets mod authors add or change things like items, Pals, recipes, and balance values using simple JSON files, instead of writing Lua scripts by hand. It's why a lot of the more popular "content" mods on Nexus Mods (new recipes, rebalanced stats, extra crafting options) list PalSchema as a requirement rather than shipping as a plain .pak.
Step 1: Install PalSchema
- Download the latest release from PalSchema's GitHub releases page. You'll see two download options: the Regular edition, which is what you want if you're just installing other people's mods, and the Dev edition, which adds extra tools for people building their own mods.
- Extract the download on your PC. Inside, you'll find a
PalSchemafolder. - Log into your MintServers panel, Stop your server, and go to the Files tab.
- Navigate to
Pal/Binaries/Win64/ue4ss/Mods/and upload the entirePalSchemafolder into it. - Start your server.
📁 Pal/Binaries/Win64/ue4ss/Mods
📁 PalSchema (the framework itself)
📁 mods (individual PalSchema mods go here)
Step 2: Install A PalSchema Mod
With the framework in place, individual PalSchema mods go inside its own mods subfolder:
- Download the mod, checking its page for any extra files or instructions specific to that mod.
- Stop your server, go to the Files tab, and navigate to
Pal/Binaries/Win64/ue4ss/Mods/PalSchema/mods/. - Upload the mod's folder here, exactly as instructed on its download page.
- Start your server.
PalSchema/mods/ folder afterward — it may have already been placed there for you as part of that install. No need to redo it manually if so.
Keeping PalSchema And UE4SS In Sync
PalSchema is built against a specific version of UE4SS, and Palworld updates have changed engine-level details before that broke older UE4SS builds entirely. If you update one, check that the other is still a matching, current version — installing a PalSchema release built for a different UE4SS version is one of the most common causes of a server that won't start after modding.
🛠️ Troubleshooting
Server crashes or won't start after installing PalSchema:Almost always a version mismatch between PalSchema and UE4SS. Re-download the latest PalSchema release and confirm it lists support for your current UE4SS version.A PalSchema mod isn't loading:Confirm its folder is insidePalSchema/mods/, not directly inside the mainue4ss/Mods/folder alongside PalSchema itself — that's the single most common placement mistake.Mod loads but is missing features, or crashes during play:Check the mod's page for additional required files. Some PalSchema mods need extra assets alongside the JSON files, and skipping them causes partial functionality or crashes rather than an outright failure to load.Got the mod from Steam Workshop and it isn't loading:Some PalSchema mods distributed through Steam Workshop aren't packaged to deploy correctly on a dedicated server on their own. Open the mod's folder atMods/Workshop/<WorkshopId>/— if there's a subfolder inside literally namedPalSchema, copy its contents into a new folder here inPalSchema/mods/, named after the mod'sPackageName(found in itsInfo.json). Leave the original Workshop copy in place too; this adds to it rather than replacing it. Our mod installation guide covers the full Steam Workshop process this fits into.Players can't join a PalSchema-modded server:These are server-side content changes, so players usually need the same mod installed on their own PC too. Share the exact mod and version with your players.
If you're not sure whether a mod you're eyeing actually needs PalSchema, or you get stuck installing one, no worries! Just open a support ticket and our team will be happy to take a look.