Cubby is an open source Voxel Engine, and game, that is written in C++ and OpenGL and can be used to create easy and fast voxel based games and applications. The engine is written to be highly functional and very efficient at allowing voxel game creation and provides a simple framework for creating 3D voxel games.
The main code of this repository is based on AlwaysGeeky's Vox.
- 3D voxel engine with cuboid and box-based rendering aesthetic.
- GLSL shader support.
- Support for deferred or forward rendering.
- Fully dynamic and unlimited lighting system using deferred lighting model.
- Advanced graphics shaders included - SSAO, shadow mapping, dynamic lighting, FXAA.
- Full 3D math and geometry library (vector, matrix, quaternion, plane, bezier).
- Extensive camera functionality, either 3rd person or 1st person.
- In-built GUI that can be easily hooked up to gameplay functioanlity (re-skinable).
- Qubicle Binary (.qb) voxel model loading.
- Polygon model loading via ms3d and obj files.
- Keyframe and skeleton animation support.
- Basic 'player' functionality - movement, controls, animation.
- 'Voxel character' encapsulating character behaviours - idle looking, breathing, etc.
- Facial animation support for voxel characters.
- Voxel scenery and world items.
- Block/cube particle effect system.
- Modding and scripting support via LUA.
- Gamepad and controller support.
- Voxel world and terrain generation.
- Procedural content creation.
- Audio and music playback.
Some parts of the Cubby gameplay logic are also incorporated into this source code repo, to better facilitate code sharing and the different sub-systems that make up the game. Some of the gameplay features of Cubby are as follows:
- Player movement and controls.
- Inventory and item management.
- NPC AI and player interations.
- Quets and gameplay objectives.
- Enemies and monsters.
- Combat using melee and ranged weapons, magic and spellcasting.
- Farming and crop management.
- Character creation and player generation.
- World customization and creation elements.
In v1.00, All of the Cubby source code is based on AlwaysGeeky's Vox. To develop MMORPG (called MineScroll), we'll improvement and differentiate Cubby game engine.
- Apply Modern C++ (C++11/14/17) features
- (To-do) Multi play support (Currently, we are developing server-side engine using Go language, called Latibulum).
- (To-do) DirectX 11/12 and Vulkan support.
- (To-do) World map generator support.
- (To-do) Resource simulator support.
- (To-do) Monster controller support.
- and so on...
Setting up and compiling the project is a fairly simple process. Cmake can be used to build the project files for each environment and for different platforms, depending on what target platform you are developing on.
Visual Studio projects are included inside the \Projects sub-folder (Currently, Visual Studio 2015 only).
The Cubby executable (Cubby.exe) needs to be run from the root directory so that it has access from its running directory to the \Resources folder that contains all the game's content files. If you want to run the game's executable from within the Visual Studio projects (for debugging) then you will need to set the working directy in the 'debugging' options to '..\' since the Visual Studio projects files reside various in sub-directories above the root.
TBA
This software is provided under the GNU General Public License, more information can be found in the license file.
Contributions are always welcome, either reporting issues/bugs or forking the repository and then issuing pull requests when you have completed some additional coding that you feel will be beneficial to the main project. If you are interested in contributing in a more dedicated capacity, then please contact me.
You can contact me via Facebook at http://www.facebook.com/utilForever. I am always happy to answer questions or help with any issues you might have, and please be sure to share any additional work or your creations with me, I love seeing what other people are making.
- fmod
- freetype
- glew
- glfw
- glm
- inih
- libnoise
- lua
- selene
- simplex
- tinythread
Ver 0.10 (Done)
- Implement basic functionalities based on Vox engine.
Ver 0.11 (Done)
- Fix a log of bugs.
Ver 0.12 (Doing)
- Fix a log of bugs.
- Refactoring source codes.
- Remove
tinythreadlibrary. - Support x86 / x64 build.
- Support linux build.
- Write engine documentation (Part 1).
- Prepare map generation tool.
Ver 0.13 (To-do)
- Redesign GUI system.
- Static code analysis with CppDepend.
- Write engine documentation (Part 2).