Welcome to the repository for our Cocos2d-x based mobile game.
'So Bee It' is an economy simulation game, playable only in German, about keeping your own bees and tending to their needs.
The goal is to earn as much money as possible, as well as to keep growing and expanding your hive population.
All interactions with the game are by single-touch, the game should be simple enough to be enjoyed by all age groups and includes small context-sensitive informational pop-ups.
There is a folder called 'deploy', that includes an unsigned .apk for use with android devices. Functionality has been tested for Android Version 6.0 up to 9.0 devices, but it should be compatible with devices running 3.0 or higher that have at least HD resolution.
- Install the Cocos2d-x framework, we will assume you followed the official tutorial on GitHub.
- Download NDK, SDK, JRE seperately or simply use Android Studio (all our devs used this) to handle and track dependencies and ease the troubleshooting process. Everything can be gotten from Google Developers
- Any IDE can be used, we recommend CLion for Unix systems, Android Studio for Windows and Mac.
- For editing the TileMap as well as creating a new one, we recommend Tiled
You should now be able to use Cocos2d-x specific functions, make changes to our code as well as compile and run it on Android. In case of issues or questions, head on over to their GitBook documentation For specific coding questions, either the api-ref is useful, or alternatively you can search the forums
- Classes Folder: includes all base classes and their corresponding header files, organized thematically. Notable are the AppDelegate files for general Cocos2d-x configurations as well as the Observer and Observable that are implemented by classes that use the corresponding functionality.
- Ressources Folder: image or sprite sources, usually in .png format, required for our project. 'TileMap' includes the HD and SD tileMap created and edited with Tiled
- proj.android / proj.ios_mac / proj.linux / projwin32: used for the corresponding operating system when compiling and running the project on that system. Do note that only proj.android is actively maintained and focused on
- deploy: includes the signed apk for installation
- cocos2d: any and all resources used by cocos2d-x, includes documentation, tests and template classes
The Master branch is now completely up-to-date, the dev branch was used while developing, especially towards the end of the project. There were user specific branches, most of which got merged into dev and then deleted, but there is a 200IQ branch for messing around with anything, when switching between computers, to ensure that the dev and master branches always contain working builds for android.
Your IDE of choice should return mistakes in your code, but at times it may refer to Cocos2d-x base classes instead of your source / header files. This means that you either made a mistake in your logic or tried to do something that Cocos2d-x can't handle. In 99% of cases it's the first case, meaning you should go back and have a look at your code and the Cocos documentation ;)
Any questions regarding the usage of any part of this project or its assets should be directed to the IT Consulting Company Abilium GmbH, as this was done by students at the university of Berne in the lecture Praktikum Software Engineering for them.