Principia LuaScript API Cheatsheet
By ROllerozxa
This is a reference overview of the Principia LuaScript API in the form of a printable cheatsheet document. It contains lists of all methods and their arguments along with some other notes. Useful to have printed out on your desk or similar when doing Principia Lua scripting.
The cheatsheet is in A4 format. Two PDFs are available, one colour version and one black-and-white version that is optimised for printing with greyscale printers.
It currently documents the API as it exists in Principia 2026.08.16. Information has been sourced from the API reference on the Principia Wiki as well as the game's source code, it has been checked for correctness but mistakes may still happen. Updates to the sheet can be made if issues with it are discovered, please let me know if you find any.
For more information about LuaScript see the full reference documentation on the Principia Wiki.
Download
The cheatsheet was originally released back in 2024 on itch.io as a paid product to support the game. It has since been made free to download thanks to supporters in the August 2026 Donation Drive who reached the funding goal.
The PDF may open directly in your browser's PDF viewer. If you want to specifically download it, right-click the link and click "Save link as..." on desktop.
Source files
The source files for the cheatsheet is available in the GitHub repository under the CC-BY 4.0 license.
Updates/Errata
- rev. 2: Remove notes about set_ambient_light and set_diffuse_light being broken as they have been fixed in 2025.04.05
- rev. 1: Initial release
