Home

Awesome

[!NOTE] Because apparently it needs to be stated here as well as in the NexusMods; the application is unsigned and therefore can flag up a False Positive with some anti-virus software. If you are really scared about it being a virus, download the application and compile it yourself. Look through the source code. You can see a virus report here

<h1 align="center">PalEdit</h1> <div align="center">

GitHub Pull Requests GitHub Issues Python <br> A simple tool for editing and generating Pals within PalWorld saves.

</div>

⚠️ Before Opening a new Issue: Please check the 🚧 Project roadmap section to ensure that your concern or feature request hasn't already been addressed or is planned for a future release. Also check the Open Issues.

📚 Table of Contents

🚀 Installation

Download the compiled executable from Nexus Mods or over on the Releases Page.

⚠️ A word of warning

[!CAUTION] It is advised that you backup ALL save files before using the tool; it will eventually do this on it's own but doesn't yet. For more information on how to do this, see the 📦 Backing up your save section.

🕹️ Usage

  1. Open PalEdit
  2. Select your save file
  3. Edit your Pals
  4. Save
  5. Done

💾 Cloning Pals

  1. Load a save
  2. Select a Pal
  3. Click "Dump Pal", and choose a filename (any name)
  4. Click "Add Pal" and select the file you just made
  5. Edit the clone

📦 Backing up your save

It is advised that you backup ALL save files before using the tool. Although the tool will eventually do this on its own, it doesn't yet.

On Windows, the saves can be found in the following locations:

If you’ve installed Palworld via Steam, you can also access your save files by following these steps:

  1. Open your Steam library.
  2. Right-click on Palworld, then select Manage > Browse local files.
  3. This will open the folder where Palworld’s installed files are stored, named Pal.
  4. From here, go to Saved > SaveGames to access your save files for the game.

🛠️ Building from source (on Windows)

  1. Install Python, at least version 3.10 (for the CI/CD pipeline we are using Python 3.12.1). You can get it from here. Don't forget to check the box to add Python to your PATH.

  2. Open a PowerShell window in the root of the project.

  3. Create a virtual environment:

    python -m venv venv

  4. Run the following command to activate the virtual environment:

    .\venv\Scripts\Activate.ps1

    If you get an error about running scripts, you may need to run the following command first:

    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process

  5. Install the required packages:

    pip install -r requirements.txt

  6. Build the binary file. Once done, it will be located in the dist folder:

    pyinstaller --noconfirm --onefile --windowed --icon "palworld_pal_edit/resources/MossandaIcon.ico" --hidden-import=PIL "PalEdit.py"

    If you get any error about virus, check the top of this README file. Also this issue comment with some further explanation may interest you: Issue #41

  7. Copy the resources folder into the dist folder. This is required to display the images inside PalEdit:

    cp -r palworld_pal_edit\resources dist

  8. Run your newly built binary file and enjoy.

Alternatively, to run PalEdit without compiling it, follow steps 1 to 5 and then run the following command:

python PalEdit.py

🚧 Project roadmap

[!NOTE] We could really use the help of the community to make this tool better. If you think you can help us deliver any of the features listed below, please feel free to open a pull request.