How cheahjs/palworld-save-tools works
Project type and purpose
• This is an open-source, command-line tool and Python library (“palworld-save-tools”) for converting Unreal-based Palworld “.sav” save files into JSON and back, with deep parsing of game-specific structures.
• It is not a full-stack web app but a standalone CLI utility and library, intended for local file I/O, scripting, and embedding in other tools.
File structure
• Top-level:
• convenience_tools/convert.cmd – Windows batch wrapper
• palworld_save_tools/ – core Python package
• scripts/ – one-off Python utilities
• tests/ – pytest suite + testdata
• pyproject.toml & hatch.toml – packaging/config
• .github/workflows – CI (package, pre-merge, publish)
• Inside palworld_save_tools/:
• commands/convert.py, resave_test.py – CLI subcommands
• archive.py – compress/decompress save archives
• gvas.py – low-level Unreal “Gvas” reader/writer
• json_tools.py – JSON <-> intermediate data mappings
• palsav.py – top-level orchestrator (SAV ↔ JSON)
• paltypes.py – type definitions & custom decode paths
• rawdata/… – per-structure parsers (group, character, map, work, etc.)
README for additional insights
• Python 3.9+ requirement, no extra runtime dependencies by design.
• CLI usage: drag-and-drop or python convert.py with flags (--to-json, --from-json, etc.).
• Packaging via PyPI; CI does builds and publishes.