Skip to content

Repository files navigation

PalworldHelper

⚠️ THIS PROJECT IS CREATED BY AI ⚠️

AI designs, writes, documents, tests, and maintains this project.

The human owner reviews the results and gives final approval.

This is not presented as a human-developed software project.

Native Windows desktop helper for Palworld saves and breeding routes

Project model

PalworldHelper is an explicitly AI-created project. Architecture, implementation, user interface, documentation, maintenance, and future development are produced by AI. The human project owner defines goals, provides real-world requirements and test data, reviews the generated work, and approves or rejects changes.

Human approval does not imply human authorship of the implementation.

Current features

  • Server profiles: Save multiple Palworld server connections and switch between them quickly.
  • Secure authentication: Connect over SFTP with password or SSH key support; saved passwords are encrypted with Windows DPAPI for the current user.
  • Save discovery and download: Search the server for Level.sav automatically, use a manual remote path when needed, and download the save into the local app folder.
  • Save parsing and inspection: Select a local Level.sav, parse players, owned Pals, levels, genders, and passive skills, and keep the selected path for the next launch.
  • Bundled breeding data: Ship the versioned repository dataset palworld_breeding_results_v1.0_2026-07-24.json next to the executable.
  • Custom breeding data: Load compatible custom breeding JSON files when you want to test another dataset.
  • Save-aware breeding chains: Pick a desired child Pal, optionally add desired passive skills, and calculate a breeding route using either all Pals or only the Pals found in the loaded save.
  • Parent choice hints: Click a breeding step to see owned parent candidates, levels, genders, passive skills, and how well they match the desired passives.
  • Maintenance tools: Check for updates, install a downloaded release, and uninstall local app data from inside the desktop app.

Next development step

The save parser is currently shipped as a bundled helper in the parser folder next to the executable. The long-term goal remains a native C# parser so the helper can eventually disappear.

Third-party parser sources and license notes are tracked in THIRD-PARTY-NOTICES.md.

Project tracking

Roadmap-sized work is tracked as GitHub issues. Keep ROADMAP.md as the readable overview and link implementation work to issues or pull requests when it becomes active.

Install

Download the latest Windows ZIP from Actions → Build Windows package or from a tagged GitHub release, extract it, and start PalworldHelper.exe.

Keep the extracted files together. The default breeding dataset is loaded from the same folder as the executable, and save parsing uses the bundled parser folder.

Breeding data

The release package includes palworld_breeding_results_v1.0_2026-07-24.json as the default dataset. Use Breeding Chain → Select JSON only when you want to load a custom compatible dataset.

Build from source

Run the Windows package build:

.\build-windows.ps1

The output is written to publish\.

License

PalworldHelper source code is licensed under the MIT License. Bundled third-party parser components have separate notices and obligations in THIRD-PARTY-NOTICES.md.

About

THIS PROJECT IS CREATED AND MAINTAINED BY AI

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages