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

Download: GitHub Releases · Nexus Mods

English | 简体中文 | Deutsch | Español | Français | Русский | 日本語 | 한국어

---

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.
• 8 languages — Localized UI, in-app guides, and documentation.

---

Table of Contents

• Features

• Installation

• Quick Start

• Guides

• Troubleshooting

• Building from Source

• Contributing

• The Palworld Team

• Support

• License

• Acknowledgments

---

Features

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.
• 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, Awakened, and Imported/DNA.
• Rank & Lock — Set rank and favorite lock level (0–3).
• 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.
• 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	Any modern distro
macOS	PalworldSaveTools-*-macos.dmg	macOS 12+ (Monterey or later)

Also available on Nexus Mods.

1. Download the appropriate build for your platform.
2. Extract (if archived) and run the executable.
3. 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

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/deafdudecomputers/PalworldSaveTools.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

1. 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.

2. 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.

3. 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).

4. 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:

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

Host → Server Transfer

Click to expand

1. Copy Level.sav and the Players folder from your host save.
2. Paste them into the dedicated server save folder.
3. Start the server, create a new character, and wait for an auto-save.
4. Close the server.
5. Use Fix Host Save in PST to migrate the old character's GUID to the new one.
6. Copy files back and launch the server.

Host Swap (Changing Host)

Click to expand

Background: The host always uses the 0001.sav slot — the same UID for whoever hosts. Each client gets a unique regular save (e.g., 123xxx.sav).

Prerequisite: Both the old and new host must have a regular save generated by joining and creating a character.

Steps:

1. Use Fix Host Save to swap the old host's 0001.sav → their regular save (e.g., 123xxx.sav). This moves their progress out of the host slot.
2. Use Fix Host Save to swap the new host's regular save (e.g., 987xxx.sav) → 0001.sav. This moves their progress into the host slot.

Result: The new host now occupies 0001.sav with their own character and Pals; the old host becomes a client with their original progress intact.

Character Transfer (Cross-Save)

Click to expand

Transfer characters between different worlds or servers while preserving characters, Pals, inventory, and technology:

1. Open the Character Transfer tool from the Tools tab.
2. Select the source save and target save.
3. Transfer a single player or all players.
4. Useful for migrating between co-op and dedicated servers.

Base Export / Import / Clone

Click to expand

Exporting a Base:

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

Importing a Base:

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

Cloning a Base:

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

Adjusting Base Radius:

1. Right-click a base → Adjust Radius.
2. Enter a new radius (50%–1000%).
3. 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

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

Linux / macOS binary won't launch

• Linux: chmod +x PalworldSaveTools-*-linux 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 .7z package:

scripts\build_cx.cmd

This creates PST_standalone_v{version}.7z 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.

1. Fork the repository.
2. Create your feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. 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