Contributing to Journey to the Center of Hawkthorne
What the heck to work on
You're looking to help? Great, we're looking for help! You can help out in variety of ways.
- Code new game features
- Record music and sound effects
- Draw sprites and tile sets
- Create new costumes and characters
- Play test the game and find bugs
Music and sound effects
We always need help with new sounds. Take a look at the list of needed music and sound effects and pick an item to work on. Make sure to comment on the issue once you've decided to work on it. Once you're finished, post a link to your completed audio file in the issue and we'll get it into the game.
Please submit your audio files as uncompressed wavs. While hosting isn't important, we like to use Sound Cloud.
There are always new sprites that we need made. Take a gander at the list of needed sprites and pick an item to work on. Make sure to comment on the issue once you've decided to work on it. Once you're finished, post a link to your completed sprite file in the issue and we'll get it into the game.
Would you rather work on organizing sprites? We need people to take existing sprites and organize them into a tileset so that we can make a level. Pick from a tileset we need made and get to work.
We love pull requests. Here's a quick guide:
Fork the repo. Please also create a separate branch
$ git checkout -b my-cool-feature
We don't accept pull requests from master branches.
Make sure the game runs with your change. See the README for details.
Push to your fork and submit a pull request.
At this point you're waiting on us. We like to at least comment on, if not accept, pull requests within a few days. We may suggest some changes or improvements or alternatives.
Write unit tests
We value testing above all else. To run the unit tests, run
$ make test
in the repository.
Some things that will increase the chance that your pull request is accepted
- Use Lua idioms and helpers
- Update the documentation, the surrounding one, examples elsewhere, guides, whatever is affected by your contribution
- Two spaces, no tabs.
- No trailing whitespace. Blank lines should not have any space.
- Follow the conventions you see used in the source already.
Handy Code Templates:
Node Template: used for making objects in the game
Gamestate Template: used for making a new gamescreen(e.g the pause menu)