kyush/principia
1
0
Fork 0
forked from mirrors/principia
Code Pull requests Activity Actions
Open source physics-based sandbox game.
409 commits 3 branches 6 tags 99 MiB
  • C++ 68.5%
  • C 25.9%
  • Java 5.1%
  • GLSL 0.1%
Find a file
ROllerozxa 7e7aca613f Merge data-pc into data 
Android now uses the JPEG textures that the PC version used, instead of the ETC1 encoded images in `data-mobile`. ETC1 texture loading is also removed as it is now unused.
2025-03-04 22:50:32 +01:00
.github Fix git commit detection for Windows CI 2024-12-08 17:32:06 +01:00
build-android Merge data-pc into data 2025-03-04 22:50:32 +01:00
cmake/Modules Minor CMake cleanups 2025-03-03 22:22:27 +01:00
data Merge data-pc into data 2025-03-04 22:50:32 +01: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 Merge data-pc into data 2025-03-04 22:50:32 +01:00
src Merge data-pc into data 2025-03-04 22:50:32 +01:00
testmaps First public version, compilation on Windows (mingw64) verified 2022-08-06 14:06:22 +02:00
utils Merge data-pc into data 2025-03-04 22:50:32 +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 Merge data-pc into data 2025-03-04 22:50:32 +01:00
Doxyfile Move Box2D up into src/ 2024-09-01 20:48:01 +02:00
LICENSE.md First public version, compilation on Windows (mingw64) verified 2022-08-06 14:06:22 +02:00
README.md Revise README 2024-12-05 16:03:57 +01:00
THANKS.md [ci skip] meta file fixups, merge build instructions with wiki 2024-04-26 00:02:12 +02:00

README.md

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.

Useful Links

Binary builds

Release builds builds of Principia for Windows, Android and Linux are available on the download page.

There are also nightly build artifacts that get automatically built by GitHub Actions CI on each commit and are available for download, see Nightly Builds on the wiki.

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.

For a brief overview on how to get started with contributing to the game, see the Contributing to the Game page on the wiki.

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

Building from source

See Compiling Principia on the wiki for building from source on supported platforms.

(You can also view the plaintext Markdown document here)

License

See LICENSE.md