Add README and CONTRIBUTORS
This commit is contained in:
parent
c72e260a23
commit
e72bfc339b
2 changed files with 88 additions and 0 deletions
19
CONTRIBUTORS.md
Normal file
19
CONTRIBUTORS.md
Normal file
|
@ -0,0 +1,19 @@
|
|||
Original idea
|
||||
=============
|
||||
- [Gram Games Team](http://gram.gs/)
|
||||
|
||||
Programming
|
||||
===========
|
||||
- [Lonami Exo](https://lonamiwebs.github.io/)
|
||||
|
||||
Art
|
||||
===
|
||||
- [Lonami Exo](https://lonamiwebs.github.io/)
|
||||
|
||||
Sounds
|
||||
======
|
||||
- `game_over` by [BerduSmith](http://freesound.org/people/BerduSmith/sounds/335395/`)
|
||||
- `piece_drop` by [cabled_mess](http://freesound.org/people/cabled_mess/sounds/350906/)
|
||||
- `invalid_drop` by [fins](http://freesound.org/people/fins/sounds/146726/)
|
||||
- `strip_clear` by [Kastenfrosch](http://freesound.org/people/Kastenfrosch/sounds/162461/)
|
||||
- `take_pieces` by [LloydEvans09](http://freesound.org/people/LloydEvans09/sounds/321806/)
|
69
README.md
Normal file
69
README.md
Normal file
|
@ -0,0 +1,69 @@
|
|||
Klooni 1010!
|
||||
============
|
||||
Play 1010! for free! Add your own themes! Contribute! Make the game yours!
|
||||
|
||||
This project is licensed under the [MIT License](LICENSE).
|
||||
|
||||
**Table of contents**:
|
||||
1. [Disclaimer](#disclaimer)
|
||||
2. [Description](#description)
|
||||
3. [Building](#building)
|
||||
4. [Playing](#playing)
|
||||
5. [Contributing](#contributing)
|
||||
6. [Contributors](#contributors)
|
||||
|
||||
Disclaimer
|
||||
----------
|
||||
**Klooni 1010!** is a [libGDX](https://libgdx.badlogicgames.com/)-based game
|
||||
which is a *klooni* from the original [1010!](http://1010ga.me/) game by the
|
||||
[Gram Games](http://gram.gs/) team. I am **not affiliated** in any way with
|
||||
them and this is only a project I made for fun, and to improve the gaming
|
||||
experience of the open source community.
|
||||
|
||||
Description
|
||||
-----------
|
||||
*Klooni 1010!* is an open source copy of *1010!* with the same game-play
|
||||
dynamics of the original game. I tried to mimic it as much as possible,
|
||||
yet, not everything is exactly the same. For example, the customize screen
|
||||
is different, there are no ads or in-app purchases, different sounds, etc.
|
||||
|
||||
Building
|
||||
--------
|
||||
Building the project should be very straight forward:
|
||||
1. `git clone https://github.com/LonamiWeb/Klooni1010.git`.
|
||||
2. `cd Klooni1010`
|
||||
3. Now you can choose to either build for `desktop` or `android`:
|
||||
1. For desktop, use `./gradlew desktop:dist`
|
||||
2. For Android, use `./gradlew android:assembleRelease`
|
||||
4. You're done! The generated files are under `build`:
|
||||
1. Desktop build is under `desktop/build/libs/*.jar`
|
||||
2. Android build is under `android/build/outputs/apk/*.apk`
|
||||
|
||||
Playing
|
||||
-------
|
||||
If you're on desktop, you should be able to play the game by either double
|
||||
clicking the built game `.jar` (Windows) or running `java -jar {file}.jar`.
|
||||
|
||||
If you want to play the game on Android, move the built `.apk` to your phone's
|
||||
internal memory, find it with an Android file explorer and install it.
|
||||
Make sure you have `Unknown sources` (`Settings -> Security`) enabled!
|
||||
|
||||
Contributing
|
||||
------------
|
||||
Found a bug? Did you add new sounds? Explosions (that would be cool)? Did
|
||||
you create a new theme you'd like to see in the game? That's **awesome**!
|
||||
Every pull request is appreciated (or even drop an issue if you don't know
|
||||
how these work), although they will probably be discussed before merging!
|
||||
|
||||
All you need to do is make sure you did not violate any of the following:
|
||||
- New sounds must be either *yours* or be under a `Creative Commons` license.
|
||||
The same applies to new textures.
|
||||
- There is no real rule when writing code to patch a bug or adding features.
|
||||
Just make sure it's readable enough and, if you write a method which name
|
||||
is not self-explanatory, document it and explain what it does.
|
||||
- Make sure you add yourself (in **alphabetical order**) to the
|
||||
`CONTRIBUTORS.md` file :)
|
||||
|
||||
Contributors
|
||||
------------
|
||||
Check out the [`CONTRIBUTORS.md`](CONTRIBUTORS.md) file!
|
Loading…
Reference in a new issue