Open source physics-based sandbox game.
  • C++ 68.5%
  • C 25.9%
  • Java 5.1%
  • GLSL 0.1%
Find a file
2024-07-17 16:12:13 +02:00
.github Bump Android API and SDK versions 2024-07-12 15:43:45 +02:00
build-android Bump Android version code for F-Droid rebuild 2024-07-17 16:12:13 +02:00
cmake/Modules Initial Emscripten web port 2024-06-17 21:36:44 +02:00
data-mobile Merge sound dirs, remove unused sounds and reencode some sounds 2024-03-05 22:13:54 +01:00
data-pc Merge sound dirs, remove unused sounds and reencode some sounds 2024-03-05 22:13:54 +01:00
data-shared Remove is_very_shitty and related code 2024-05-19 22:19:09 +02:00
data-src Don't set executable bit on level files 2024-03-11 23:32:27 +01:00
doc Add Doxyfile and generate Doxygen docs in CI 2024-05-27 20:52:09 +02:00
fastlane/metadata/android/en-US Principia 2024.07.12 2024-07-12 15:50:43 +02:00
packaging Principia 2024.07.12 2024-07-12 15:50:43 +02:00
src Principia 2024.07.12 2024-07-12 15:50:43 +02:00
testmaps First public version, compilation on Windows (mingw64) verified 2022-08-06 14:06:22 +02:00
utils Add helper script for updating version info everywhere 2024-02-02 00:00:16 +01:00
.gitattributes Remove old util programs that have been moved to principia-utils and some other stuff, update gitignore 2024-02-01 21:44:13 +01:00
.gitignore Add Doxyfile and generate Doxygen docs in CI 2024-05-27 20:52:09 +02:00
.gitmodules Add Android dependency repo as submodule 2024-07-17 15:58:14 +02:00
AUTHORS.md [ci skip] meta file fixups, merge build instructions with wiki 2024-04-26 00:02:12 +02:00
CMakeLists.txt Refactor cURL networking code into own source file 2024-07-07 23:21:10 +02:00
Doxyfile Add Doxyfile and generate Doxygen docs in CI 2024-05-27 20:52:09 +02:00
LICENSE.md First public version, compilation on Windows (mingw64) verified 2022-08-06 14:06:22 +02:00
README.md Update README 2024-05-11 21:32:02 +02:00
THANKS.md [ci skip] meta file fixups, merge build instructions with wiki 2024-04-26 00:02:12 +02:00

Principia Open Source Project

Principia

Principia is a sandbox physics game originally released in November 2013. It is the successor to the 2011 Android hit game "Apparatus". In August of 2022 Principia was released as open source, and is now being developed as an open source project by the Principia community.

Principia runs on anything with a recent enough version of Windows, Linux or Android. Experimental ports to Haiku OS and macOS are also available, and work to port Principia to other platforms are very welcome.

Binary builds

Binary builds of Principia for Windows, Android and Linux are available on the downloads page.

There are also nightly build artifacts for Windows, Android and Linux that get automatically built by GitHub CI on each commit, see Actions. Keep in mind these may be broken at times during development, and you are recommended to use the release builds instead.

Getting involved

Feel free to fork this project and send in your pull requests. This is a community project and the community decides how the project evolves.

Most of our discussion and development happens in the #development channel of the Principia Discord server, make sure to join it if you want to discuss and participate in the development of the game.

Also be sure to follow @principia on Fosstodon for more updates about the project.

Building from source

See Compiling Principia on the Principia Wiki.

(You can also view the plaintext Markdown document here)

License

See LICENSE.md