Skip to content

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

License

Notifications You must be signed in to change notification settings

deafdudecomputers/PalworldSaveTools

Repository files navigation

PalworldSaveTools Logo

PalworldSaveTools

A comprehensive save file editing toolkit for Palworld

Downloads License Discord NexusMods

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


Download the standalone version from GitHub Releases


Table of Contents

  • [Features]
  • [Installation]
  • [Quick Start]
  • [Tools Overview]
  • [Guides]
  • [Troubleshooting]
  • [Contributing]
  • [License]

Features

Core Functionality

Feature Description
Fast Save Parsing One of the quickest save file readers available
Player Management View, edit, rename, change level, unlock techs, and manage players
Guild Management Create, rename, move players, unlock lab research, and manage guilds
Pal Editor Full editor for stats, skills, IVs, rank, souls, gender, boss/lucky toggle
Base Camp Tools Export, import, clone, adjust radius, and manage bases
Map Viewer Interactive base and player map with coordinates and details
Character Transfer Transfer characters between different worlds/servers (cross-save)
Save Conversion Convert between Steam and GamePass formats
World Settings Edit WorldOption and LevelMeta settings
Timestamp Tools Fix negative timestamps and reset player times

All-in-One Tools

The All-in-One Tools suite provides comprehensive save management:

  • Deletion Tools

    • Delete Players, Bases, or Guilds
    • Delete inactive players based on time thresholds
    • Remove duplicate players and empty guilds
    • Delete unreferenced/orphaned data
  • Cleanup Tools

    • Remove invalid/modded items
    • Remove invalid pals and passives
    • Fix illegal pals (cap to legal max stats)
    • Remove invalid structures
    • Reset anti-air turrets
    • Unlock private chests
  • Guild Tools

    • Rebuild All Guilds
    • Move players between guilds
    • Make player guild leader
    • Rename guilds
    • Max guild level
    • Unlock All Lab Research
  • Player Tools

    • Edit player pal stats and skills
    • Unlock All Technologies
    • Unlock Viewing Cage
    • Level up/down players
    • Rename players
  • Save Utilities

    • Reset missions
    • Reset dungeons
    • Fix timestamps
    • Trim overfilled inventories
    • Generate PalDefender commands

Additional Tools

Tool Description
Edit Player Pals Full pal editor with stats, skills, IVs, talents, souls, rank, and gender
SteamID Converter Convert Steam IDs to Palworld UIDs
Fix Host Save Swap UIDs between two players (e.g., for host swap)
Swap Player UIDs Swap UIDs between two players
Slot Injector Increase palbox slots per player
Restore Map Apply unlocked map progress across all worlds/servers
Rename World Change world name in LevelMeta
WorldOption Editor Edit world settings and configuration
LevelMeta Editor Edit world metadata (name, host, level)
Coordinate Converter Convert in-game coordinates

Installation

Prerequisites

For standalone (Windows):

For running from source (Linux or development):

  • Python 3.10 or higher
  • pip (Python package manager)

Standalone (Windows - Recommended)

  1. Download the latest release from GitHub Releases
  2. Extract the zip file
  3. Run PalworldSaveTools.exe

From Source (Linux or for development)

git clone https://github.com/deafdudecomputers/PalworldSaveTools.git
cd PalworldSaveTools
pip install -r requirements.txt
python start.py

Quick Start

  1. Load Your Save

    • Click File → Load Save
    • Navigate to your Palworld save folder
    • Select Level.sav
  2. Explore Your Data

    • Use the tabs to view Players, Guilds, Bases, or the Map
    • Search and filter to find specific entries
  3. Make Changes

    • Select items to edit, delete, or modify
    • Use context menus for additional options
  4. Save Your Changes

    • Click File → Save Changes
    • Backups are created automatically

Tools Overview

All-in-One Tools (AIO)

The main interface for comprehensive save management with three tabs:

Players Tab - View and manage all players on the server

  • Edit player names, levels, and pal counts
  • Delete inactive players
  • View player guilds and last online time

Guilds Tab - Manage guilds and their bases

  • Rename guilds, change leaders
  • View base locations and levels
  • Delete empty or inactive guilds

Bases Tab - View all base camps

  • Export/import base blueprints
  • Clone bases to other guilds
  • Adjust base radius

Map Viewer

Interactive visualization of your world:

  • View all base locations and player positions
  • Filter by guild or player name
  • Click markers for detailed information
  • Generate killnearestbase commands for PalDefender

Character Transfer

Transfer characters between different worlds/servers (cross-save):

  • Transfer single or all players
  • Preserves characters, pals, inventory, and technology
  • Useful for migrating between co-op and dedicated servers

Fix Host Save

Swap UIDs between two players:

  • Transfer progress from one player to another
  • Essential for host/co-op to server transfers
  • Useful for swapping host role between players
  • Useful for platform swaps (Xbox ↔ Steam)
  • Resolves host/server UID assignment issues
  • Note: Affected player must have a character created on the target save first

Guides

Save File Locations

Host/Co-op:

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

Dedicated Server:

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

Map Unlock

Click to expand map unlock instructions
  1. Copy LocalData.sav from src\resources\
  2. Find your server/world save folder
  3. Replace the existing LocalData.sav with the copied file
  4. Launch the game with a fully unlocked map

Note: Use the Tools → Restore Map option in PST to apply the unlocked map to ALL your worlds/servers at once with automatic backups.

Host → Server Transfer

Click to expand host to server transfer guide
  1. Copy Level.sav and Players folder from host save
  2. Paste to dedicated server save folder
  3. Start server, create a new character
  4. Wait for auto-save, then close
  5. Use Fix Host Save to migrate GUIDs
  6. Copy files back and launch

Using Fix Host Save:

  • Select the Level.sav from your temporary folder
  • Choose the old character (from original save)
  • Choose the new character (you just created)
  • Click Migrate

Host Swap (Changing Host)

Click to expand host swap guide

Background:

  • Host always uses 0001.sav — same UID for whoever hosts
  • Each client uses a unique regular UID save (e.g., 123xxx.sav, 987xxx.sav)

Prerequisites: Both players (old host and new host) must have their regular saves generated. This happens by joining the host's world and creating a new character.

Steps:

  1. Ensure Regular Saves Exist

    • Player A (old host) should have a regular save (e.g., 123xxx.sav)
    • Player B (new host) should have a regular save (e.g., 987xxx.sav)
  2. Swap Old Host's Host Save to Regular Save

    • Use PalworldSaveTools Fix Host Save to swap:
    • Old host's 0001.sav123xxx.sav
    • (This moves old host's progress from host slot to their regular player slot)
  3. Swap New Host's Regular Save to Host Save

    • Use PalworldSaveTools Fix Host Save to swap:
    • New host's 987xxx.sav0001.sav
    • (This moves new host's progress into the host slot)

Result:

  • Player B is now the host with their own character and pals in 0001.sav
  • Player A becomes a client with their original progress in 123xxx.sav

Base Export/Import

Click to expand base export/import guide

Exporting a Base:

  1. Load your save in PST
  2. Go to Bases tab
  3. Right-click a base → Export Base
  4. Save as .json file

Importing a Base:

  1. Go to Bases tab or Base Map Viewer
  2. Right-click on the Guild you want to import the base to
  3. Select Import Base
  4. Select your exported .json file

Cloning a Base:

  1. Right-click a base → Clone Base
  2. Select target guild
  3. Base will be cloned with offset positioning

Adjusting Base Radius:

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

Troubleshooting

"VCRUNTIME140.dll was not found"

Solution: Install Microsoft Visual C++ Redistributable

struct.error when parsing save

Cause: Outdated save file format

Solution:

  1. Load the save in the game (Solo, Coop, or Dedicated Server mode)
  2. This triggers an automatic structure update
  3. Ensure the save was updated on or after the latest game patch

GamePass converter not working

Solution:

  1. Close the GamePass version of Palworld
  2. Wait a few minutes
  3. Run the Steam → GamePass converter
  4. Launch Palworld on GamePass to verify

Building from Source

# Clone the repository
git clone https://github.com/deafdudecomputers/PalworldSaveTools.git

# Install dependencies
pip install -r requirements.txt

# Run the application
python start.py

For building the standalone executable, use the build script:

python scripts/build.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 backup 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


License

This project is licensed under the MIT License - see the LICENSE file for details.


Acknowledgments

  • Palworld developed by Pocketpair, Inc.
  • Thanks to all contributors and community members who have helped improve this tool

Made with ❤️ for the Palworld community

⬆ Back to Top

About

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

Resources

License

Stars

Watchers

Forks

Languages