CONTRIBUTING 1.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253
  1. This file has been dedicated to the public domain, to the extent
  2. possible under applicable law, via CC0. See
  3. http://creativecommons.org/publicdomain/zero/1.0/ for more
  4. information. This file is offered as-is, without any warranty.
  5. ========================================================================
  6. Any contributions to this project should be based on the latest revision
  7. found in the Git repository. This repository can be found here:
  8. https://savannah.nongnu.org/git/?group=hexoshi
  9. This document is designed to help you understand how to make changes,
  10. how to run the version of the game from the repo, and how to forward
  11. your changes upstream.
  12. MAKING CHANGES
  13. To make changes to the main game program, simply edit "hexoshi.py". If
  14. you like, you can add your own copyright notice to the top of the file.
  15. To add any sort of game data, place it in the appropriate section of the
  16. "data" directory, and add licensing information to "data/LICENSES".
  17. Note: Any data contribution which is not given a proper libre license
  18. WILL BE REJECTED. Please adhere to the formatting of the rest of the
  19. entries in the LICENSES file as closely as possible.
  20. Whatever your contributions, please ensure that you add your name to
  21. data/credits.json in the appropriate section(s). Make sure to test your
  22. modification of this file with the "Credits" option from the main menu
  23. of the game.
  24. RUNNING THE GAME
  25. Running the version of the game from the repo is similar to running the
  26. source code releases, but the main difference is that dependencies are
  27. not included. The main dependencies are:
  28. - SGE Game Engine - http://stellarengine.nongnu.org
  29. - xSGE - http://xsge.nongnu.org
  30. - Six - https://pypi.python.org/pypi/six
  31. Of course, all dependencies of these libraries must also be installed.
  32. FORWARDING YOUR CHANGES
  33. To forward your changes, please clone the Git repo, push it to your own
  34. Git repo (any Git service will do), and send me a link to your repo.