imbaczek / piston

A user friendly game engine written in Rust

Piston

A user friendly game engine written in Rust

Maintainers: @bvssvni, @Coeuvre

Tutorial

List of games made with Piston

Piston online docs

How to contribute

| Partner Project | Online Docs | |---------|------|------------| | rust-graphics | rust-graphics docs | | rust-image | rust-image docs | rust-sdl2 | rust-sdl2 docs | | rust-sdl2_mixer | rust-sdl2_mixer docs | | rust-sdl2_ttf | rust-sdl2_ttf docs | | glfw-rs | glfw-rs docs | | gl-rs | gl-rs docs | | hgl-rs | hgl-rs docs | | cgmath-rs | cgmath-rs docs |

Start new project with Piston

If you are starting a new project, Rust-Empty will automate the setup of directories for you.

When you have set up your project, you can build Piston. Piston can either be compiled as a static or dynamic library (or both). One way to simplify working with multiple projects on the same machine is to symlink the '.rlib' directly into the next project with the command ln -s <from> <to>.

How to build Piston

1. Install Cargo
2. Open up the Terminal window and type:

git clone https://github.com/PistonDevelopers/piston
cd piston
cargo build

Add libraries to your project

After building Piston, you need to add the '.rlib' files to your '/target/cpu-vendor-os/lib/' folder.

The folder is created first time you build. If you do not see the folder, type make exe.

Goals

2D will be first priority, but we encourage people to experiment with 3D as well.

• Test the design and performance of Rust-Graphics
• Experiment with Rust-ish game design and collect feedback
• Experiment with actor/events AI modelling
• Experiment with multiplayer architectures
• Make more people use Rust for game development
• Multi-platform game development