<div align="center">

PalworldSaveTools

A comprehensive save file editing toolkit for Palworld

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

---

Download the standalone version from GitHub Releases

---

</div>

Table of Contents

• Features
• Installation
• Quick Start
• Tools Overview
• Guides
• Troubleshooting
• Building Standalone Executable
• 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) | | 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) |

---

Installation

Prerequisites

For standalone (Windows):

• Windows 10/11
• Microsoft Visual C++ Redistributable (2015-2022)

For running from source (all platforms):

• Python 3.11 or higher

Standalone (Windows - Recommended)

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

From Source (All Platforms)

The start scripts automatically create a virtual environment and install all dependencies.

Using uv:

git clone https://github.com/deafdudecomputers/PalworldSaveTools.git
cd PalworldSaveTools
uv venv --python 3.12
uv run start.py

Windows:

git clone https://github.com/deafdudecomputers/PalworldSaveTools.git
cd PalworldSaveTools
start_win.cmd

Linux:

git clone https://github.com/deafdudecomputers/PalworldSaveTools.git
cd PalworldSaveTools
chmod +x start_linux.sh
./start_linux.sh

Branches

• Stable (recommended): git clone https://github.com/deafdudecomputers/PalworldSaveTools.git
• Beta (latest features): git clone -b beta https://github.com/deafdudecomputers/PalworldSaveTools.git

---

Quick Start

1. Load Your Save

   • Click the menu button in the header
   • Select 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
   • Right-click for context menus with additional options

4. Save Your Changes

   • Click the menu button → Save Changes
   • Backups are created automatically

---

Tools Overview

All-in-One Tools (AIO)

The main interface for comprehensive save management with five tabs:

Player Inventory Tab - View and manage all players' inventories on the server

• Edit player stats, inventory, equipped gear.
• Ability to edit quality, add, remove anything from inventory and equipped gear.

Base Inventory Tab - View and manage all bases' inventories on the server.

• Edit base inventory.
• Ability to clear containers, edit quality, add, remove anything from base inventories.
• Filtering included for any possiblities of cheating.

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

<details> <summary>Click to expand map unlock instructions</summary>

1. Copy LocalData.sav from 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 Restore Map tool in the Tools tab to apply the unlocked map to ALL your worlds/servers at once with automatic backups.

</details>

Host → Server Transfer

<details> <summary>Click to expand host to server transfer guide</summary>

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

</details>

Host Swap (Changing Host)

<details> <summary>Click to expand host swap guide</summary>

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.sav → 123xxx.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.sav → 0001.sav
   • (This moves new host's progress in