#utility #ggez #game-engine #points #brooks-builds

bbggez

Utility functions by the Brooks Builds community for the Rust game engine GGEZ

13 releases (2 stable)

1.1.0 Dec 1, 2019
1.0.0 Oct 29, 2019
0.8.1 Oct 19, 2019

#1433 in Game dev

23 downloads per month

MIT license

26KB
195 lines

Brooks Builds Community GGEZ Crate

This project is by and for all of us Brooks Builds community members who are using GGEZ to learn how to program in Rust, and of course make some games. Brooks will be reviewing pull requests and issues regularly on his stream.

The origin story for this library is Hacktoberfest. It can be daunting to begin contibuting to open source software, especially if we are new to a language or framework. This project is meant to be a jumping off point for beginners and veterans to Rust and GGEZ alike get some pull requests in and get their t-shirt!

Are there GGEZ utility crates already? Of course there are. But this one is special as its by and for this community. We may be re-implementing some of the features that the other GGEZ libraries have but this is primarily a learning experience project.

Code of Conduct

We are using the Brooks Builds code of conduct.

Contributing

There are many ways to contibute to this project. The easiest way is to submit and message on issues. We can't promise that we will implement every request that we get, but we can discuss why we want to go in a certain direction.

If you want to get involved and write some code then follow these steps to contribute.

It doesn't matter what level of developer you or how much Rust you know. If you want to pair with a community member please mention this in the comments and I can pair with you.

  1. Find an issue that isn't currently being worked on that sounds interesting (there will be a comment stating that the developer is working on the issue if it is being worked on)
  2. Write a comment stating that you're going to work on the issue
  3. Feel free to ask any clarifying questions about the issue. It is possible that some issues won't have pull requests accepted as they don't match the direction that we want to go with the project.
  4. Fork the repository
  5. Clone the repository to your local environment
  6. Make sure you have Rust installed
  7. Run the tests with the command cargo test to make sure that everything is working as expected
  8. Make your changes locally
  9. Add tests for any code you write
  10. Add documentation for any code you write
  11. Run the tests again to make sure that the tests are still working
  12. If you added or changed a feature add or change the appropriate example
  13. Push your code to your GitHub account
  14. Pull request your changes

If you are adding a pull request for Hacktoberfest, note that your pull request doesn't need to be accepted to get counted. Get that t-shirt!

We are more than happy to have documentation pull-requests, they are a great way to get started with open source.

Using the Library

You can run an example to show how to use the library with the command `cargo run --example

Dependencies

~29–39MB
~503K SLoC