principia/utils/README.md
ROllerozxa 66923575b4 Merge in featured-list-creator into utils/
Originally a C program (previously Python script) at https://github.com/principia-game/featured-list-creator for creating fl.cache files for the community site, merge into the main repository so it is with all the other util programs.
2026-06-02 00:31:44 +02:00

1.1 KiB

utils

This directory contains utility scripts and programs used for Principia development or for working with file formats.

Scripts

  • prepare_release_builds.sh: Download and prepare release builds when making a release
  • set_version.lua: Update the version number across the codebase when preparing a release (See Making a Release).
  • update-sandbox-menu.sh: Update the pre-rendered sandbox and item menu

Programs

Most of these programs rely on source files from the main Principia codebase and need to be compiled to run. Likely only works on Linux. You can use the Makefile in each directory or run make in the utils directory to build all of them.

  • featured-list-creator: Generate a fl.cache file for use on the Principia community site
  • lvl-icon-extractor: Extract the embedded level icon in a Principia level file
  • lvlbuf-decompressor: Decompress the level buffer of a Principia level file
  • lvledit: Edit metadata of Principia level files
  • progress-get: Get leaderboard score for a given level from a data.bin file