Computencio

Computencio is a funny educational game written in C++ using Cocos2d-x Framework which purpose is to provide a slight idea about computer programming layers but has the desire to have all kinds of possible levels to understand the concepts related to computer science like sortings algorithms, hardware implementation, etc..:

This pyramid represents the layers that I primarily want to introduce. Each layer is known by different game levels. Also this game is very extensible thanks to the open/close principle. In the HOW_TO_CONTRIBUTE.md file is explained very well different ways to contribute to this game, is highly recommended to read this file specially if it's the first time you want to contribute to a open source software project.

Used Framework

This game is based on cocos2d-x framework. Is an open source software framework. You can search a lot of useful sites for master it:

Dependencies

You will have to download all the dependencies you need depending the platform you want to develop on.

About this repo

In the Classes folder are all source codes of this game (cpp and h files).
Files like proj.android or proj.linux are folders containing basic configuration of its platform. Also there are proj.android-studio folder so you can use this project easily with Android Studio IDE.
The Resources folder contain just that, resources such images and fonts.

How to contribute

1. Clone Project

First thing you have to do to contribute is to clone this project and

git clone https://github.com/Computencio/computencio.git

2. Create a symbolic link

Now create a symbolic link named cocos2d to our downloaded cocos2d-x library.

cd computencio
ln path-to-cocos-lib cocos2d

3. Create platform specific build folder

Now you have to create platform-build folder like linux-build, go inside and construct it with cmake (CMakeLists.txt file at root of this repo). Finally execute make to create configuration files for all platforms (this will delay few minutes). In case to have some errors you can visit the cocos2d forum

mkdir linux-build
cd linux-build
cmake ..
make

4. Execute it

If everything has been executed successfully now you can compile and execute the game (the first time it will delay few minutes):

cocos run -p android

cocos run -p linux

Run command will compile and execute the project. Its recommended to have a look to cocos2d console manual

5. Adding new source code

If you want add new source code files to project ensure that you add the respective path to following files:

CMakeList.txt
proj.android/jni/Android.mk

I highly recommend to have a look to HOW_TO_CONTRIBUTE.md if you want to add new levels or functionalities to Computencio.

Cicko/Computencio