GitHub - deafdudecomputers/PalworldSaveTools: PalworldSaveTools - A comprehensive toolkit designed to fix, transfer, edit, and manage your Palworld save files with ease.

A complete solution for managing, editing, converting, and optimizing Palworld save files.

Download: GitHub Releases · Nexus Mods

⚠️ Palworld Save Tools — Discontinued

Version 2.4.5 is the final release. The project is outdated and several features are broken because Palworld has moved past what this version supports, so continued use is no longer recommended.

It was originally started by Pylar, but things came up for him and he has since moved on. PST has been merged into the successor toolkit PalStudio (formerly Palworld Save Pal), which combines PST and Palworld Save Pal into one modern, maintained tool.

The outdated codebase lives on as a legacy project at PalworldSaveTools-Legacy, under Cyrix, originally Pylar's co-partner, who took it over and keeps it as an outdated archive that now serves as a learning resource for how save editing works. PalStudio is still the better option.

Where development continues — PalStudio:

Website: https://palworldsavepal.app/
Discord: https://discord.gg/YWZFPy9G8J
Nexus Mods: https://www.nexusmods.com/palworld/mods/1827

Thank you to everyone who used and supported Palworld Save Tools. See you on the PalStudio Discord.

Overview

Palworld Save Tools (PST) is a fast, all-in-one desktop application for inspecting and editing Palworld save files. Built with Python and PySide6, it reads and writes the game's compressed save format directly — no game mods required.

Whether you need to manage a dedicated server, migrate between co-op and dedicated servers, clean up abandoned data, or fine-tune individual Pals, PST provides a single unified interface for all of it.

Highlights

Cross-platform — Pre-built binaries for Windows, Linux, and macOS.
Fast native parsing — One of the quickest save file readers available, powered by the palsav engine.
Visual map — Interactive world map with base/player markers, exclusion zones, and coordinate calibration.
Deep Pal editing — Full control over stats, IVs, souls, skills, passives, work suitabilities, rank, and appearance flags.
Server-grade tooling — Bulk deletion, cleanup, conversion, and character transfer built for administrators.
Automatic backups — Every save operation creates a backup before writing.
9 languages — Localized UI, in-app guides, and documentation.

Features

Category	What you can do
Player Management	Edit names, levels, stats, tech points. Bulk manage items, pals, tech across players. Clean up inactive or duplicate players.
Pal Editor	Change stats, IVs, souls, rank, skills, passives, work suitability, boss/lucky flags. Export/import pals. Detect and fix illegal pals. Cheat mode for uncapped editing.
Guild Management	Rename guilds, change leaders, set levels. Unlock lab research. Move players between guilds. Delete empty or inactive guilds.
Base Camp Tools	View all bases with guild info. Export/import blueprints. Clone bases to other guilds. Reposition bases on the map. Adjust radius. Delete inactive bases.
Map Viewer	Interactive world map with base and player markers. Draw exclusion zones. Calibration mode. World Map and Tree Map views. Zoom, pan, fly-to.
Inventory Management	Edit player items, key items, equipment slots. Unlock all fast-travel points. Browse and edit base inventories and containers across all guilds. Manage base worker pals.
Exclusions	Protect players, guilds, and bases from cleanup with persistent exclusion lists. Add entries from context menus.
Save Tools	Convert saves between SAV and JSON. Convert GamePass to Steam. Transfer characters between worlds. Fix host saves. Restore map progress. Expand palbox slots.
Cleanup & Utilities	Delete empty guilds, inactive bases/players, unreferenced data. Remove invalid items/pals/structures. Reset dungeons, oil rig, supply drops. Fix timestamps.

Player Management

View and search all players by name, level, pal count, UID, guild, and last-seen time.
Edit player names, levels, stats, and technology points.
Stats tab — Hero stats (Health, Stamina, Attack, Defense, Work Speed, Weight) with correct in-game computed values; Relic abilities with toggles and spinners.
Max All Stats — Instantly cap all stats at max (50 points).
Bulk operations across multiple players: item management, pal management, and technology unlocks.
Delete inactive players by time threshold; remove duplicates.

Pal Editor

A deep editing interface for any Pal owned by any player. Pals are organized by Party (active squad) and Palbox (storage).

Stats & IVs — HP, Attack, Defense (IV 0–100), Level (1–80), Trust Rank (0–10).
Souls — HP, Attack, Defense, Craft Speed (0–20).
Skills — Active skill picker; learn all moves; bulk-sync skills across Pals.
Passive Traits — Passive picker with full game data.
Work Suitability — Set individual work-suitability levels (0–10).
Appearance Flags — Toggle Boss/Alpha, Lucky/Shiny, Predator, Awakened, and Imported/DNA.
Rank & Lock — Set rank and favorite lock level (0–3).
Cheat Mode — Toggle to expand all caps: level, IVs, souls, condenser rank to 255; unlock unlimited active/passive skills with duplicates allowed.
Export/Import — Right-click any pal to export as .pstpal (compressed) or .json. Import into empty slots across party, palbox, DPS, or base workers. Works across saves and players.
Max All Pals — Max all stats (IVs, souls, rank, level) for all pals in party, all palbox pages, or all base workers — respects cheat mode caps.
Fix Illegal Pals — Detect and cap pals with illegal stats, skills, or traits per player.
Bulk Clone/Delete — Species-picker dialog with quantity controls and source toggles (Party/Palbox/DPS) for batch operations.
Add new Pals or quick-delete with double-click.

Guild Management

Two-panel view: guild list on top, member roster below.

Rename guilds, change leaders, set guild level, max guild level.
Unlock all lab research; rebuild all guilds.
Move players between guilds; delete empty or inactive guilds.

Base Camp Tools

View all base camps with guild association.
Export base blueprints to .json; import (single or multi-file) into any guild.
Clone bases to other guilds with offset positioning.
Change Coordinates — Right-click a base marker on the map, pick "Change Coordinates", then click any spot to teleport the base.
Base Nudge — Nudge a base by exact X/Y/Z offsets to fix ground clipping or floating.
Adjust base radius (50%–1000%).
Delete inactive bases and non-base map objects.

Map Viewer

Interactive visualization of your entire world.

Base markers (house icon) and player markers (person icon) with detail panels.
Toggle overlays: Bases, Players, Radius Rings, Exclusion Zones.
Zone drawing — Draw rectangular or polygonal exclusion zones directly on the map.
Calibration mode — Precisely align the map with game coordinates.
World Map and Tree Map views; filter by guild or player name.
Zoom (1.0x–30.0x), pan, double-click to fly to a marker.
Right-click markers and empty space for management actions.

Inventory Management

Player Inventory — Three sub-tabs:

Inventory — All items and equipment in the main bag; edit quantity, add, remove.
Key Items — Quest items, effigies, and technology; bulk-add all effigies/key items.
Stats — Level, HP, Stamina, Attack, Defense, Work Speed, Weight.
Equipment panel for weapon, accessory, food, armor, shield, glider, and module slots.
Unlock all map + fast-travel points in one click.

Base Inventory — Browse and manage items and working Pals across all bases:

View/edit items in containers; clear containers; modify container slots.
Cross-guild item operations (find/remove items across all guilds).
Cross-guild structure deletion.
Base Pals sub-tab — Manage working Pals assigned to each base with full pal-editor context menus.

Exclusions

Protection lists that safeguard players, guilds, and bases from cleanup operations.

Three side-by-side panels: excluded Player UIDs, Guild IDs, and Base IDs.
Add entries via right-click context menus in the Players, Guilds, or Bases tabs.
Save and load exclusion lists persistently.
Build your list before running bulk cleanup.

Save Tools

Accessible from the Tools tab as clickable cards:

Tool	Description
Convert Saves	Convert between SAV and JSON formats
Convert GamePass → Steam	Convert Xbox/GamePass saves to Steam format
Convert SteamID	Convert Steam IDs to Palworld UIDs
Restore Map	Apply fully unlocked map progress to all worlds/servers
Slot Injector	Increase palbox slots per player
Modify Save	Open and modify raw save data
Character Transfer	Transfer characters between different worlds/servers (cross-save)
Fix Host Save	Swap UIDs between two players (host swap, platform migration)

Cleanup & Utility Functions

Accessible via Menu → Functions, these server-grade operations include:

Deletion — Delete empty guilds, inactive bases/players, duplicate players, unreferenced data.
Cleanup — Remove invalid/modded items, invalid pals & passives, invalid structures; fix illegal pals (cap to legal max); reset anti-air turrets; unlock private chests; repair all structures.
Resets — Reset missions, dungeons, oil rig, invader, supply drops.
Timestamps — Fix negative timestamps; reset player times.
PalDefender — Generate killnearestbase commands.

Installation

Standalone Builds (Recommended)

Pre-built binaries are available for all three major platforms from GitHub Releases:

Platform	Download	Requirements
Windows	`PalworldSaveTools-*.exe`	Windows 10/11, VC++ Redistributable (2015–2022)
Linux	`PalworldSaveTools-*-linux.AppImage`	Any modern distro
macOS	`PalworldSaveTools-*-macos.dmg`	macOS 12+ (Monterey or later)

Also available on Nexus Mods.

Download the appropriate build for your platform.
Extract (if archived) and run the executable.
That's it — no Python or dependencies needed.

Windows: If you see "VCRUNTIME140.dll was not found," install the Microsoft Visual C++ Redistributable.

Linux: You may need to mark the file executable: chmod +x PalworldSaveTools-*-linux.AppImage

macOS: If Gatekeeper blocks the app, right-click → Open the first time, or run xattr -d com.apple.quarantine /path/to/app.

From Source (All Platforms)

PST uses uv for dependency management. The start script automatically creates a virtual environment and installs everything.

Prerequisites: Python 3.11+ and uv.

git clone https://github.com/CyrixJD115/PalworldSaveTools-Legacy.git
cd PalworldSaveTools
uv run start.py

Windows (double-click launcher):

start.cmd

The launcher creates a .venv, installs dependencies via uv sync, and boots the app. It cleans up the lockfile on exit so each run is reproducible.

Quick Start

Load Your Save
- Click Menu → Load Save, or drag-and-drop a .sav file onto the window.
- Navigate to your Palworld save folder and select Level.sav.
Explore Your Data
- Use the tabs — Map, Tools, Players, Guilds, Bases, Player Inventory, Base Inventory, Pal Editor, Exclusions — to explore your save.
- The stats bar shows live counts; quick-nav icons jump to each section.
Make Changes
- Left-click to select; right-click almost anything for contextual actions.
- Double-click to quick-edit or quick-delete (see the in-app guides for details).
Save Your Changes
- Click Menu → Save Changes. Backups are created automatically.

Tip: Each tab has a built-in guide — click the help icon in any tab to see exactly what it can do. For deeper knowledge, hover over any button, field, or control to reveal detailed tooltips at the header. The in-app tooltip help system is your best reference for understanding exactly what every feature does and how to use it.

Guides

Save File Locations

Host / Co-op (Windows):

%localappdata%\Pal\Saved\SaveGames\YOURID\RANDOMID\

Dedicated Server:

steamapps\common\Palworld\Pal\Saved\SaveGames\0\RANDOMSERVERID\

Map Unlock

PST can unlock the full map (all fast-travel points) for your save:

Load your save in PST.
Open the Player Inventory tab and click Unlock All Map + Fast Travel for a single player, or
Use the Restore Map tool in the Tools tab to apply unlocked map progress across all your worlds/servers at once.
Save changes. Automatic backups are created.

Co-op → Dedicated Server

Click to expand

Move your co-op world (where you host from your PC) to a dedicated server so others can play even when you're offline.

How it works: Co-op saves use 0001.sav for the host player. Dedicated servers don't — every player has a regular UID. Fix Host Save exchanges two player files (like trading seats), not a copy. Your co-op character in 0001.sav gets swapped into the server's slot.

Copy your co-op save to the server.
- Co-op save location: %localappdata%\Pal\Saved\SaveGames\YOURID\RANDOMID\
- Copy Level.sav and the Players folder from there.
- Paste into the server save folder: steamapps\common\Palworld\Pal\Saved\SaveGames\0\RANDOMSERVERID\
Join the server and create a temporary character.
- Start the server, join it, and create a new character (any name/ appearance — this is just a placeholder).
- Wait for an auto-save, then shut down the server.
Swap your co-op character into the server slot.
- Open PST → Tools → Fix Host Save.
- Browse to the server's Level.sav.
- Source Player: Select your co-op character (the one in 0001.sav — listed as the host).
- Target Player: Select the temporary character you just created.
- Click the button to run the swap.
Start the server.
- Your original co-op character (with all progress, Pals, bases) is now linked to the server. The temporary placeholder is gone.

Dedicated Server → Co-op

Click to expand

Take your dedicated server character back to a local co-op save — useful if you stop renting a server or want to play offline.

How it works: Same GUID swap in reverse — Fix Host Save exchanges two files, not a copy. Your server character (regular UID) gets swapped into 0001.sav (the host slot) so you can host co-op with your server progress.

Copy your server save to your local PC.
- Server save location: steamapps\common\Palworld\Pal\Saved\SaveGames\0\RANDOMSERVERID\
- Copy Level.sav and the Players folder from there.
- Paste into your local co-op folder: %localappdata%\Pal\Saved\SaveGames\YOURID\RANDOMID\
Host a co-op game and create a temporary character.
- Start Palworld, host a co-op session, and create a new character.
- Let it auto-save, then close Palworld.
Swap your server character into the host slot.
- Open PST → Tools → Fix Host Save.
- Browse to the local co-op Level.sav.
- Source Player: Select your dedicated server character (listed by its UID).
- Target Player: Select the temporary co-op character (the one in 0001.sav — listed as the host).
- Click the button to run the swap.
Host co-op normally.
- Your server character is now the host (0001.sav). All progress, Pals, and bases intact.

Changing Host (Co-op Swap)

Click to expand

Two players want to switch who hosts. Player A has been hosting — their character lives in 0001.sav. Player B joins as a client — their character lives in 1234.sav. Now they want Player B to become the host, but the host slot is always 0001.sav.

Key concept — Fix Host Save always SWAPS two players. It exchanges their save files, like two people trading seats. It does NOT copy one onto the other. After any swap, both players still exist — they're just in different files.

Since one swap moves Player B into the host slot but leaves Player A's data sitting in B's old file, a second swap is needed to put Player A's original character back. Here's how:

Starting state:

0001.sav  = Player A (current host)
1234.sav  = Player B (current client)

Step 1 — Swap A and B.

Open PST → Tools → Fix Host Save.
Browse to your co-op Level.sav.
Source: Player A (0001.sav). Target: Player B (1234.sav).
Click the button. Fix Host Save exchanges the two files.

After step 1:

0001.sav  = Player B  ← now the host with B's character
1234.sav  = Player A  ← A's data is here, but this UID no longer exists in the game

Step 2 — Player B hosts, Player A joins.

Player B hosts the world. Player A joins.
Since A is no longer the host, Palworld assigns a brand-new UID for A's temporary character (e.g., 9999.sav).
Player A reaches Level 2 with the temp character, then everyone exits the game.

After step 2:

0001.sav  = Player B (host, correct)
1234.sav  = Player A's original data (not linked to any active UID)
9999.sav  = Player A's temporary character (fresh, Level 2+)

Step 3 — Swap A's original data into A's new UID.

Open Fix Host Save again with the same Level.sav.
Source: 1234.sav (Player A's original data). Target: 9999.sav (Player A's temporary character).
Click the button. They swap again.

After step 3:

0001.sav  = Player B (host, correct)
1234.sav  = Player A's temp character (unused, can delete)
9999.sav  = Player A's original character  ← restored!

Done. Player B hosts with Player B's original character. Player A joins with Player A's original character. The leftover 1234.sav can be ignored or deleted.

Why two swaps? Fix Host Save exchanges two files — it's not a copy. The first swap puts B in the host slot, but A's data ends up in B's old UID (which no longer exists in-game). The second swap moves A's data into A's new client UID. Two swaps, all progress preserved.

Character Transfer (Cross-Save)

Click to expand

Copy a player (with all Pals, inventory, technology, and progress) from one world to another — useful for moving your character between a co-op world and a dedicated server, or between two servers.

How it works: Unlike Fix Host Save (which exchanges two files), Character Transfer copies a player from one Level.sav into another. The source save is untouched.

Open PST → Tools → Character Transfer.
Load the source save — click the Source button and select the Level.sav that has the character you want to copy (e.g., your old server).
Load the target save — click the Target button and select the Level.sav you want to copy into (e.g., your new server).
Select the player to transfer from the Source player list on the left.
Choose where to place them in the Target player list on the right — you can overwrite an existing player or leave it empty for a fresh slot.
Click Transfer. The character, Pals, inventory, and guild membership are copied to the target save.
Save changes. Automatic backups are created.

You can also transfer all players at once using the "Transfer All" button.

Base Export / Import / Clone

Click to expand

Exporting a Base:

Go to the Bases tab (or use the Map Viewer).
Right-click a base → Export Base.
Save as a .json blueprint file.

Importing a Base:

Right-click on the target guild (in the Bases tab, Map Viewer, or Guilds tab).
Select Import Base (single file) or Import Bases (Multi-File).
Select your exported .json file(s).

Cloning a Base:

Right-click a base → Clone Base.
Select the target guild.
The base is cloned with offset positioning.

Adjusting Base Radius:

Right-click a base → Adjust Radius.
Enter a new radius (50%–1000%).
Save and reload the save in-game for structures to be reassigned.

Troubleshooting

"VCRUNTIME140.dll was not found" (Windows)

Install the Microsoft Visual C++ Redistributable (2015–2022).

`struct.error` when parsing a save

The save file format is outdated. Load the save in-game (Solo, Co-op, or Dedicated Server) once to trigger an automatic structure update, then try again. Ensure the save was updated on or after the latest game patch.

GamePass converter not working

Fully close the GamePass version of Palworld.
Wait a few minutes for file handles to release.
Run the GamePass → Steam converter.
Launch Palworld on GamePass to verify.

Linux / macOS binary won't launch

Linux: chmod +x PalworldSaveTools-*-linux.AppImage to mark it executable.
macOS: If blocked by Gatekeeper, right-click → Open, or run xattr -d com.apple.quarantine /path/to/app.

Building from Source

PST supports two build paths. The CI/CD pipeline uses Nuitka for cross-platform release binaries; cx_Freeze is used for the local Windows installer.

Nuitka (Cross-Platform — Used by CI/Releases)

Requires Python 3.11+ and uv. Nuitka is installed automatically.

# One-file build (Windows / Linux)
uv run python build/nuitka/build_nuitka.py --onefile

# One-directory build (macOS .app)
uv run python build/nuitka/build_nuitka.py --onedir

Outputs go to dist/:

Windows → dist/PalworldSaveTools-*.exe
Linux → dist/PalworldSaveTools-*-linux
macOS → dist/PalworldSaveTools.app → packaged as .dmg

cx_Freeze (Windows Installer)

For a local Windows .zip package:

scripts\build_cx.cmd

This creates PST_standalone_v{version}.zip in the project root.

Interactive Builder

An interactive menu to pick a build mode:

uv run python build/build_interactively.py

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository.
Create your feature branch (git checkout -b feature/AmazingFeature).
Commit your changes (git commit -m 'Add some AmazingFeature').
Push to the branch (git push origin feature/AmazingFeature).
Open a Pull Request.

Disclaimer

Use this tool at your own risk. Always back up your save files before making any modifications.

The developers are not responsible for any loss of save data or issues that may arise from using this tool.

Support

Discord: Join us for support, base builds, and more!
GitHub Issues: Report a bug
Nexus Mods: Download & discuss

License

This project is licensed under the MIT License — see the license file for details.

The Palworld Team

This project wouldn't exist without the people behind it.

Active Maintainers

Pylar — The man who started it all. Every line of this tool traces back to his vision and relentless work on the save engine, the GUI, and the features you use every day.

cyrix — Refactorer and sub-maintainer. Focused on code quality, simplification, and structural improvements — keeping the codebase clean, smaller, and easier to maintain as the project grows.

Contributors

dkoz — The man behind the IDs. Provides game data IDs, structural insight on the ID codes, and the deep knowledge of how Palworld's data is wired together that keeps the tool accurate with every game update.

oMaN-Rod — Provided the original save parser that this project forked from. Without his foundational work on cracking the Palworld save format, none of this would exist. The fork streamlined and simplified his parser into what PST is today.

Okaetsu — Modding insights that made base import/export possible. His understanding of how Palworld structures base data from the modding side bridged the gap between modding and save editing, making this feature a reality.

Acknowledgments

A huge thank you to:

Palworld developed by Pocketpair, Inc. — for the game that brought us all together.
The bug reporters — every issue filed, every edge case found, every log pasted in Discord. You make this tool more robust with each report.
The Palworld modding community — fellow modders, tool developers, and tinkerers who share knowledge, reverse-engineer formats, and push the ecosystem forward. This project stands on the shoulders of that collective effort.
All contributors and community members — whether you've submitted a PR, answered a question in Discord, or simply told a friend about PST — thank you.

Made with ❤️ for the Palworld community

⬆ Back to Top

Name		Name	Last commit message	Last commit date
.github		.github
.opencode		.opencode
build		build
resources		resources
scripts		scripts
src		src
tests		tests
.gitignore		.gitignore
AGENTS.md		AGENTS.md
README.md		README.md
changelogs.md		changelogs.md
license		license
pyproject.toml		pyproject.toml
requirements.txt		requirements.txt
start.cmd		start.cmd
start.py		start.py
test.cmd		test.cmd

Latest commit

History

Folders and files

Repository files navigation

⚠️ Palworld Save Tools — Discontinued

Overview

Highlights

Table of Contents

Features

Player Management

Pal Editor

Guild Management

Base Camp Tools

Map Viewer

Inventory Management

Exclusions

Save Tools

Cleanup & Utility Functions

Installation

Standalone Builds (Recommended)

From Source (All Platforms)

Quick Start

Guides

Save File Locations

Map Unlock

Co-op → Dedicated Server

Dedicated Server → Co-op

Changing Host (Co-op Swap)

Character Transfer (Cross-Save)

Base Export / Import / Clone

Troubleshooting

"VCRUNTIME140.dll was not found" (Windows)

struct.error when parsing a save

GamePass converter not working

Linux / macOS binary won't launch

Building from Source

Nuitka (Cross-Platform — Used by CI/Releases)

cx_Freeze (Windows Installer)

Interactive Builder

Contributing

Disclaimer

Support

License

The Palworld Team

Active Maintainers

Contributors

Acknowledgments

About

Resources

Stars

Watchers

Forks

Releases

Used by

Contributors

Languages

`struct.error` when parsing a save