Palworld Pal Editor

English · 简体中文

A feature-rich Palworld save editor for players, Pals, Technology, inventories, and more — available as a desktop GUI, WebUI, CLI, and Docker container.

 

Caution

Back up your save before editing it. The editor creates backups, but you should keep your own copy as well.

Warning

This software is free and open source. If you paid for it on another platform, request a refund. Support the author only through this repository or links embedded in official builds of the editor.

Table of Contents

• Overview
• Download
• Quick Start
• Features
  • General
  • Pals
  • Templates and bulk operations
  • Players
  • Inventory
• Installation and Running
• Command-line Options
• Guides
• Supporting this Project
• Contributing
• Credits
• License

Overview

A Palworld Pal Editor developed by _connlost with ❤️.

Palworld Pal Editor is a feature-rich save editor that supports player, Pal, Technology, inventory, and other save modifications. Run it as a desktop GUI, WebUI, CLI, or Docker container.

Note

Steam save root: %LOCALAPPDATA%\Pal\Saved\SaveGames

Save folder: %LOCALAPPDATA%\Pal\Saved\SaveGames\<Steam ID>\<Save ID>

Select the folder that contains Level.sav.

The editor currently supports Steam-format saves. Use PalworldSaveTools to convert between Xbox Game Pass and Steam saves. Always back up your saves first; conversion compatibility may lag behind game updates.

Palworld Pal Editor fully supports Deutsch, English, Español, Español (México), Français, Bahasa Indonesia, Italiano, 日本語, 한국어, Polski, Português (Brasil), Русский, ไทย, Türkçe, Tiếng Việt, 简体中文, and 繁體中文.

Download

• GitHub Releases — official releases and changelogs
• Nexus Mods — download the latest release from Nexus
• Nightly Release — automatically updated development builds

For most users, the pre-built desktop application is recommended. It does not require a separate Python installation.

Quick Start

1. Back up the save folder you want to edit.
2. Start the desktop application.
3. Choose the folder containing Level.sav, then select Load Save.
4. Select a player, base camp, or Pal and make your changes.
5. Select Save Changes, then verify the result in game.

Features

General

• List players and their Pals
• Edit base-camp Pals
• Search Pals
• Sort Pals
• Filter Pals
• Show Pals outside their normal containers
• Enable normally unavailable options through cheat mode

Pals

• Edit Pal species
• Toggle Alpha Pal
• Toggle Lucky Pal
• Supports modifying the following forms that cannot be obtained normally in the game: Tower, Raid, Predator, Oil Rig, and Boss Rush variants.
• Edit Pal nickname
• Edit Pal gender
• Edit Pal skin
• Edit Pal priority
• View and toggle Global Pal Storage import (DNA) status
• Edit Pal level
• Edit Trust level
• Edit Potential
• Edit Awakening
• Edit Soul upgrades
• Edit condensation rank
• Edit work suitability
• Edit equipped active skills
• Edit learned active skills
• Edit passive skills
• Heal and revive Pals
• Heal all Pals
• Maximize Pal progression within legal limits
• Delete Pals

Templates and bulk operations

• Create active-skill templates
• Create passive-skill templates
• Create reusable Pal templates
• Add Pals
• Clone Pals
• Import Pals from JSON
• Export Pals to JSON

Players

• Edit player name
• Edit player level
• Edit player stats
  • Health
  • Stamina
  • Attack
  • Carrying Capacity
  • Work Speed
• Edit unused Stat Points
• Edit Pal Effigy abilities
  • Capture Power
  • Satiety Duration
  • Swimming Ability
  • Food Preservation
  • Jump Power
  • Flight Capacity
  • Climbing Proficiency
  • Status Resistance
  • Endurance
  • Sphere Tracking
  • EXP Gain
  • Rainbow Fortune
  • Movement Speed
• Edit Technology Points
• Edit Ancient Technology Points
• Toggle normal and Ancient Technology unlocks
• Unlock all Technology

Inventory

• Edit backpack items
• Edit key items
• Edit weapons
• Edit armor
• Edit shields
• Edit gliders
• Edit accessories
• Edit Pal Sphere modules
• Edit equipped food
• Edit item quantities
• Clear inventory slots

Installation and Running

Desktop Application

Download a release, extract it, and run the executable. If the embedded window does not work on your system, open the displayed WebUI address in a modern browser.

Docker

1. Download sample-docker-compose.yml and save it as docker-compose.yml.
2. Edit these values in docker-compose.yml:
   • In ports, change the left side of 8080:58888 to the host port you want. Keep container port 58888 unchanged.
   • In volumes, replace /Host/Path/To/The/GameSave/AF518B19A47340B8A55BC58137981393 with the save folder containing Level.sav. Keep /mnt/gamesave unchanged.
   • Replace the default PASSWORD with a strong password. You may also change APP_LANG and, on Linux, PUID/PGID to match the host user.
3. In the directory containing the Compose file, run docker compose up -d.

The sample maps the editor to http://localhost:8080. A password is strongly recommended whenever the server is reachable by another device.

Run from Source

Install Python 3.11+ and Node.js, clone the repository, then run:

.\setup_and_run.ps1

On Linux or macOS:

./setup_and_run.sh

The setup scripts install the repository's pinned dependencies, build the WebUI, and start the editor. PyPI builds are no longer published.

WebUI and Remote Access

Start the editor in web mode and set a password:

palworld-pal-editor.exe --mode web --port 58080 --password "choose-a-strong-password"

When using a separately hosted frontend, choose the backend from the server menu at the top-right of the entry page.

Command-line Options

--lang LANG          Interface language
--path PATH          Save-folder path
--mode MODE          cli, gui, or web
--port PORT          WebUI port
--password PASSWORD  WebUI access password
--debug              Development-only debug mode
--nocli              Disable the interactive CLI in GUI/WebUI mode

Run palworld-pal-editor.exe --help for the current list. Command-line values override config.json; the application manages that file automatically.

Guides

• Palworld Pal Editor 1.0 showcase on Bilibili
• Older showcase on YouTube
• Older WebUI/GUI guide
• Older Docker guide

Only the 1.0 showcase reflects the current editor. The other videos are kept as older workflow references.

Supporting this Project

This project is developed and maintained by _connlost in spare time.

• Join the Discord community to ask questions and help other users.
• Report reproducible bugs with logs and save details that are safe to share.
• Contribute focused, maintainable fixes through pull requests.
• Support continued maintenance through Ko-fi, PayPal, AliPay, or WeChat Pay.

Contributing

Search existing issues before opening a report or request. For code changes, work from the latest development branch, keep each pull request focused, explain user-visible behavior, and include screenshots for interface changes.

Credits

• Take-Me1010 — Japanese translation
• MagicBear — fast save-loading approach
• palworld-save-tools — Palworld save serialization
• Palworld Server Toolkit — early project reference

License

Palworld Pal Editor is released under the GNU General Public License v3.0.