History

ROllerozxa 01236f4b31 Move util programs back into main repository Also includes new Makefiles for building them and a README in the main utils dir		2026-05-30 01:04:34 +02:00
..
lvledit	Move util programs back into main repository	2026-05-30 01:04:34 +02:00
progress-get	Move util programs back into main repository	2026-05-30 01:04:34 +02:00
.gitignore	Move util programs back into main repository	2026-05-30 01:04:34 +02:00
Makefile	Move util programs back into main repository	2026-05-30 01:04:34 +02:00
prepare_release_builds.sh	Add script to prepare release builds	2025-09-11 23:44:28 +02:00
README.md	Move util programs back into main repository	2026-05-30 01:04:34 +02:00
set_version.lua	set_version.lua: Update AppStream metainfo version info	2025-09-24 00:24:11 +02:00
update-sandbox-menu.sh	Minor fixes to the sandbox menu texture creation pipeline	2026-03-12 21:13:00 +01:00

README.md

`utils`

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

Scripts

prepare_release_builds.sh:
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.

lvledit: Edit metadata of Principia level files
progress-get: Get leaderboard score for a given level from a data.bin file