Skip to content

Repository files navigation

Palbox Studio — Palworld 1.0 compatible

A desktop editor for the Palworld 1.0 Global Palbox.

Windows Version Built with License

Palbox Studio — main editor

Palbox Studio is a desktop application for editing the Global Palbox in Palworld 1.0 save files. It reads GlobalPalStorage.sav directly, presents every Pal in the box, and gives full control over each Pal's attributes through a native interface. It runs as a standalone application: it does not modify the game, install into Palworld, or place files in the game directory. Every save operation writes a verified backup before it touches the original file.

Palbox Studio is scoped to the Global Palbox only. It does not edit world saves, bases, or party Pals.

Click releases on the right hand side to view latest compiled releases, or you can access them here. https://github.com/TheMysticTurtle/PalboxStudio/releases


✨ Features

  • 🐾 Full Pal editing — species, nickname, gender, level, IVs, Pal Souls, condensation, Awakening, passive skills, active and learned moves, work suitabilities, Trust, vitals, and the Lucky and Alpha flags.
  • ⚙️ Live engine-projected stats — level, IV, Soul, condensation, Awakening, and variant changes immediately refresh HP, Attack, and Defense through the Rust engine.
  • 🔋 Persistent MAX shortcuts — optional HP, SAN, Food, and Trust preferences apply whenever a Pal is selected; turn one off whenever you want to enter a custom value.
  • 🛠️ Focused Work Suitabilities — see only the jobs that Pal actually has (plus any saved exception), then type a 1–10 value directly or keep using the arrow controls.
  • Passive presets — save reusable passive combinations or start a new preset from the selected Pal's current passives.
  • 📦 Box explorer — a side panel listing every Pal in the box, or an expanded full-gallery view.
  • 🔍 Filtering and search — by element, work suitability, ride/mount capability, ranch drops, and obtainability, with a name and species search.
  • 🏷️ Groups and tags — user-defined groups for organizing and filtering Pals.
  • 🔄 Species selector — easily change any Pal's species with a searchable, filterable picker.
  • Add, clone, and remove Pals.
  • 💾 Verified backups — each save writes a checked backup, then replaces the original atomically.

All species, stats, moves, Partner Skills, and ranch products are rendered from a bundled game-data database, so displayed values match Palworld 1.0.


🖼️ Overview

📂 Open your box

Click Open Global Palbox and choose your GlobalPalStorage.sav. Your whole box loads into the side panel, ready to browse and edit — and a verified backup is written before any save.

📦 The Global Pal Box

A side panel lists every Pal in the box with search, filters, and tags for quick navigation. Select a Pal to load it into the editor.

Global Pal Box explorer

🔎 Expanded view

The box expands into a full gallery, with each Pal shown as a card carrying its stats, moves, and passives.

Expanded Pal Box gallery

🎴 The editor

The selected Pal is presented on a single card: portrait, typing, stats, Partner Skill, passives, moves, and work suitabilities.

Main editor card

📊 Editable stats

IVs, Pal Souls, condensation, Awakening, level, Trust, vitals, and focused Work Suitabilities, with live engine-calculated combat readouts and support for the extended values reachable in Palworld 1.0. Newly created Pals begin with explicit 50/50/50 IVs.

Editable stats

🔄 Species selector

Easily change any Pal's species with a searchable, filterable picker. Pick a new one and the card updates to match.

Species selector

⚡ Passive skills

Assign passive skills from a searchable, filterable list to find the exact passive you want.

Passive skill picker

🎯 Moves

Choose active skills from a filterable list, with each move's element and power shown.

Move picker


⬇️ Installation

Download the latest build from the Releases page or from Nexus Mods.

  • Installer — run PalboxStudio-<version>-setup.exe. It creates a Start-menu shortcut and installs the WebView2 runtime if it is not already present.
  • Portable — unzip PalboxStudio-<version>-portable.zip and run Palbox Studio.exe. No installation is required; keep the folder contents together.
  • Vortex — the portable folder can be registered as a Vortex tool: on the Palworld dashboard, + Add Tool → New…, and set Target to Palbox Studio.exe. Full steps are in the zip's READ ME FIRST.txt.

Windows 11 includes the required WebView2 runtime. On earlier versions of Windows, install the Microsoft Edge WebView2 Runtime if the application does not start.

🐧 Linux

Download PalboxStudio-<version>-linux.AppImage (portable, runs on most modern distributions) or PalboxStudio-<version>-linux.deb (Debian/Ubuntu).

  • AppImagechmod +x PalboxStudio-<version>-linux.AppImage, then run it. No installation.
  • .debsudo apt install ./PalboxStudio-<version>-linux.deb.

On Linux the app renders through the system WebKitGTK runtime (the counterpart to WebView2 on Windows). Most desktops already ship it; if the app does not start, install it with your package manager — on Debian/Ubuntu: sudo apt install libwebkit2gtk-4.1-0.

If Palworld is installed via Steam/Proton, your Global Palbox lives inside the Proton prefix, and the file picker defaults there: ~/.local/share/Steam/steamapps/compatdata/1623730/pfx/drive_c/users/steamuser/AppData/Local/Pal/Saved/SaveGames/<id>/GlobalPalStorage.sav.

🛡️ A note on antivirus / SmartScreen

Palbox Studio is not code-signed, so Windows SmartScreen or antivirus software may warn about it the first time you run it. This is expected for unsigned, independent software. The complete source is in this repository — you are welcome to review it, and to build the application yourself (see Building from source) rather than run a prebuilt binary.

💾 Save safety

  • A verified backup is written before any save modifies your file.
  • Close Palworld before saving edits.
  • The Global Palbox is located at %LOCALAPPDATA%\Pal\Saved\SaveGames\<id>\GlobalPalStorage.sav.
  • Keeping an independent copy of important saves is recommended.

Building from source

Requirements: Rust (stable-msvc) and Node.

npm install && npm --prefix ui install   # one-time
npm run tauri dev                          # run with UI hot-reload

npm run build builds the frontend and cargo test runs the engine tests. The bundled reference database (data/palbox-reference.db) ships prebuilt, so no data-generation step is needed to build from source.

To produce the installer and portable zip:

powershell -ExecutionPolicy Bypass -File scripts/build-release.ps1

🧩 Architecture

  • core/palbox-core, a headless Rust engine: the Palworld 1.0 save model, load/write, and edit operations, with verified 1.0 limits and unit tests against real save data.
  • src-tauri/ — the Tauri 2 desktop shell bridging the engine to the UI.
  • ui/ — the Svelte 5 + Vite frontend.
  • database/ + data/ — a bundled, read-only SQLite reference database (species, moves, passives, Partner Skills, ranch products, localization) loaded into memory at startup, and a writable user database for groups, tags, presets, and application preferences.

Architecture decisions are documented in docs/decisions/.

🙏 Acknowledgements

Palbox Studio builds on prior Palworld 1.0 save-editing work by the community. Save serialization uses the uesave library. Inspired by PalEdit. Palworld is a trademark of Pocketpair, Inc. Palbox Studio is an unofficial, fan made, independent tool.

📄 License

Palbox Studio is source-available under the PolyForm Strict License 1.0.0. It is free to download and use. Redistribution, and modified or derivative versions, are not permitted without written permission from the author. For collaboration or reuse inquiries, please open an issue.

About

An intuitive Palworld 1.0 Global Palbox Editor

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages