The plans for the Game Engine

My plans for the game engine have evolved. At first, I decided to develop a game engine with the sole purpose to learn Game Engine Development.

Once the engine became stable, I started pondering whether to release the engine as an open-source project. I read a lot of books on open-source management, and I finally made a decision.

I have decided to release the engine not as a commercial tool, nor as an open-source project, but as an educational tool for you to use and learn.

However, I will not only release the game engine but also provide you with the educational resources to help you become a game developer. That is, I plan to release game development courses and hands-on projects, which I hope will be helpful to you.

We plan to release the Untold Engine and the first game development course by July 2018. The first course will introduce you to essential concepts in game development.

Throughout the year, I plan to develop two more game development courses and keep improving the engine.

Why am I releasing the engine as an educational tool?

The Untold Engine is ideal for novice developers. It is easy to use. It has a small API to remember. There is no graphical user interface to learn, and you can start rendering game characters with few lines of code. In essence, it helps you focus on learning game development concepts without the complexity found in other engines.

I want to provide you with a complete learning ecosystem; game engine, courses, game assets, all in one place.

Many game tutorials are not written with "novice developers" in mind. Some tutorials don't take the time to clarify the reasoning behind every code implementation. They don't explain the WHY behind every HOW.

I want to give novice developers a different experience. I want to provide them with everything they need in one single place. I want to create game courses, especially for them. I want to provide them with an easy-to-use game engine and give them access to game assets.

If you feel this ecosystem will benefit you, sign up below to get notified once the game engine and the game development courses are released.

The Game Engine's name

For a couple of years, I've kept the name of the engine a secret. However, I think is time for you to know its name. The name of the 3D game engine I've been developing is Untold Engine.

I came up with this name after watching the preview of a movie. I don't recall the film, but I do remember it starting by saying "The Untold Story...." At that instant, I knew that I should name my game engine Untold Engine.

 The Untold Engine Logo

The Untold Engine Logo

New team member

As you can imagine, starting this new project is not going to be easy. And I'm going to need all the help possible. I will need help with accounting, finance, marketing and day to day operations.

My brother, Erick, will be joining the Untold Engine team. And will be in charge of the accounting, finance and day to day operations.

In contrast, I will be in charge of creating educational content, providing technical support and improving the Untold Engine.

Don't miss out

Visit the Untold Engine website to get notified once the Untold Engine and the game development courses are released.

Thanks for reading.

Progress Update: Game Engine Beta v0.0.10

Back in Sept 2017, I decided to port the engine from using OpenGL to Metal (Apple's Graphics Library). In all seriousness, it took me several months to finally make a decision. Part of it is that I still felt like I knew little about Game Engine Development and I didn't want to expand the scope of my project.

I was aware that Metal allows you to code once and run the same code on different devices, such as iOS, Macs, and Apple TV. But I was still on the fence. However, when I saw several games using Metal+AR (Augmented Reality) features, I was convinced that I had to port the engine to Metal.

Well, today I want to share with you the tenth beta-version of the engine, but running on a Mac:


One of the things I've always dreamed about was to be able to play a game on my Mac, with the engine I developed with a controller. I know, it may sound weird, but I've wanted to do so for a while.

The video shown below does not have the best lighting, but it shows me moving the character around using the Steelseries Nimbus controller, which I also added support in the engine:


Here is a picture of the controller if you are interested in knowing which one I used:


So what's the deal with AR support? That is on my To-Do list, but I will not address it anytime soon. There are other issues I want to fix and implement. One of them is the camera.

Well, thanks for reading.

What tools do I need to develop a game engine?

In a previous post, I gave you a comprehensive list of books required to develop a game engine. I figure that you may also be interested in the tools I use to build a game engine. So I wrote this post to share with you the tools I use.


From the start, I decided to develop a game engine compatible with Apple devices. Thus, the IDE (Integrated Development Environment) I use is Xcode.

Screen Shot 2018-02-04 at 10.34.49 AM.png

I love Xcode. I've never had any complaints about it. I've heard several people who hate this tool, but I can't relate.

Git (Terminal and GUI)

A project as complex as a game engine requires a Version Control system. My tool of choice is Git. It is simple to use, yet powerful.

I'm embarrassed to share this story, but it is true. When I started development of the game engine, back in 2013, I used Dropbox as my Version Control System. Yep, you read that right. Moreover, when I started using Git, I made the mistake of committing all changes directly into the Master branch. I never made use of Git's branching feature.

But that is the past. I learned from my mistakes. I evolved as a developer :).

Screen Shot 2018-02-04 at 10.32.07 AM.png

You can interact with Git through the terminal or the GUI. I tend to use both methods. Although using the Git GUI is a lot easier, I do recommend to learn to use Git through the terminal; It will force you to understand Git better.

Should you use the Git terminal or GUI?


I enjoy a minimalist lifestyle. And the BeeApp suits me perfectly. BeeApp keeps track of your Git issues. It allows you to add an Issue to Git, change its tags and add comments right from the GUI. The app sorts your Issues and assigns them to a particular list depending on their labels.

Here is a screenshot of my issues sorted in Bee.

Screen Shot 2018-02-04 at 10.42.57 AM.png

I don't have to log into my Github account every time I want to update the progress of an issue or lose track of which item to work on next. I love this app. It combines the beauty of Todoist and Git Issues.

Sublime Text

Oh, Sublime Text, what a beauty you are.

To export 3D models into a game engine requires the development of a Digital Asset Loader (DAL). The DAL's primary duty is to read the attributes of the 3D model (vertices, Normal vectors, UVs, etc.) and export it into a file. The game engine then reads this file and renders the 3D model.

Screen Shot 2018-02-04 at 10.30.00 AM.png

A Blender-Python script is used to read and export the model's attribute. And Sublime Text's beautiful aesthetics makes writing the DAL a pleasure.

Before Sublime Text, I used Eclipse, PyCharm and Blender's script editor, but none compare to Sublime Text.


Believe it or not, game engine development does not mean you spend 100% of your time coding; there is some artwork involved. 75% of my time is spent coding in C++. The other 25% is spent modeling 3D characters and writing Blender-Python scripts in Blender. If you are curious about this fact, read the following article.

The tool I use to model 3D characters is Blender 3D. Blender 3D is a modeling software used by game artists.


There are other modeling 3D tools on the market. However, Blender is free, open-sourced, and there is a massive community around it. Moreover, there are plenty of youtube tutorials; which is very helpful when you are starting out.

Hope this helps

Progress Update: Game Engine Beta v0.0.9

The last update I gave on the game engine was back in Nov 2017. A lot of improvement has occurred since then. I fixed over 15 bugs and enhanced the Collision Detection System and the Digital Asset Loader. Below is a video showing beta-version v0.0.9 of the game engine.


Improving the GJK

I have mentioned before that the collision detection system is the most complicated aspect of a game engine. Interestingly, the algorithm is quite simple. However, the complication arises from the several boundary conditions that you need to account.

The Collision Detection system worked fine between objects of similar size. For disproportionate size objects, i.e., terrain and a cube, the collision algorithm would fail 50% of the time.

There were instances where detection happened way too early or too late. Other cases were even weirder. For example, merely changing the location of the cube would cause the detection to fail. I recall an instance where changing the orientation of the cube would cause a failure.

I recall spending most of my Thanksgiving and Christmas holiday working on the issue stated above. It took me over two months to improve the collision detection between disproportionate objects. It is not perfect, but it works within constraints.

What I learned from these two months working on improving the engine, is that the GJK algorithm has several boundary conditions that your code needs to account. In the previous version of the engine, I was not considering these boundary conditions; thus the reason for the early or late detections.

If you find yourself in this situation, I recommed to take a look at these books:

Improving the Digital Asset Loader

I also improved the Digital Asset Loader (DAL). If you don't know what a DAL is, it is merely a script that loads 3D models into the engine. Previously, the script would output rendering data directly to a terminal. I would copy and paste this data into an engine file.

I improved the script to write directly to the engine file. Not only that, but you can now choose what you want to import. i.e., just 3D models, 3D animations, light, or a combination of 3D models with animations.

Books I had to read to develop a game engine

If you have decided to develop your game engine, you may be wondering where to start, what books to start reading, etc. If you are in this situation, I recommend getting a copy of the following books found here. Out of all the books I've read, they are the best of the best, so I strongly recommend them.

Now, if you want a comprehensive list, the list below should help you.

Books to develop the Math Engine

  1. Mathematics for 3D Game Programming and Computer Graphics
  2. Quaternions and Rotation Sequences: A Primer with Applications to Orbits, Aerospace and Virtual Reality
  3. Quaternions for Computer Graphics
  4. 3D Math Primer For Graphics and Game Development
  5. Practical Linear Algebra: A Geometry Toolbox
  6. Visualizing Quaternions
  7. Curves and Surfaces for Computer Graphics
  8. Essential Mathematics for Games and Interactive Applications: A Programmer's Guide

Books to develop the Rendering Engine

  1. OpenGL 4.0 Shading Language Cookbook
  2. OpenGL Insights
  3. Real-Time Rendering, Third Edition
  4. OpenGL Shading Language
  5. Foundations of 3D Computer Graphics
  6. Texturing and Modeling, Second Edition: A Procedural Approach
  7. OpenGL Superbible: Comprehensive Tutorial and Reference
  8. Graphics Shaders: Theory and Practice, Second Edition
  9. Graphics Programming Methods
  10. Real-Time Shadows

Books to develop the Physics Engine

  1. Physics for Game Developers: Science, math, and code for realistic effects
  2. Numerical Methods for Scientists and Engineers
  3. A Student's Guide to Vectors and Tensors
  4. Real-Time Collision Detection
  5. Game Physics Engine Development: How to Build a Robust Commercial-Grade Physics Engine for your Game
  6. Computational Geometry: Algorithms and Applications
  7. Game Physics Pearls
  8. Geometry for Computer Graphics: Formulae, Examples and Proofs
  9. Geometric Tools for Computer Graphics
  10. Computational Geometry in C
  11. Collision Detection in Interactive 3D Environments
  12. Game Physics

Learning 3D Modeling tools (Blender)

If you are wondering why you need to learn Blender, read the following article.

  1. Blender Master Class: A Hands-On Guide to Modeling, Sculpting, Materials, and Rendering
  2. Blender Foundations: The Essential Guide to Learning Blender 2.6
  3. Learning Blender: A Hands-On Guide to Creating 3D Animated Characters
  4. Python 3 Object Oriented Programming- Blender provides an API which allows you to extract 3D modeling information. To use the API, you need to know a bit of Python.
  5. Digital Modeling

Game Engine Architecture

  1. Head First Object-Oriented Analysis and Design
  2. Game Programming Gems
  3. Best of Game Programming Gems
  4. 3D Game Engine Architecture
  5. 3D Game Engine Design: A Practical Approach
  6. C++ Common Knowledge: Essential Intermediate Programming
  7. C++ Pointers and Dynamic Memory Management
  8. Effective C++: 55 Specific Ways to Improve Your Programs and Designs
  9. C++ Templates: The Complete Guide
  10. Design Patterns: Elements of Reusable Object-Oriented Software
  11. The C++ Standard Library: A Tutorial and Reference
  12. Thinking in C++, Vol. 1: Introduction to Standard C++, 2nd Edition
  13. Thinking in C++, Volume 2: Practical Programming
  14. Game Programming Algorithms and Techniques
  15. API Design for C++
  16. Game Programming Patterns

Books to get started

You don't have to buy all these books at once. If you are starting out, then get the following books:

3D Math

  1. 3D Math Primer For Graphics and Game Development

Rendering Engine

  1. OpenGL Superbible: Comprehensive Tutorial and Reference
  2. Graphics Shaders: Theory and Practice, Second Edition

Physics Engine

  1. Physics for Game Developers: Science, math, and code for realistic effects
  2. Game Physics Engine Development: How to Build a Robust Commercial-Grade Physics Engine for your Game
  3. Real-Time Collision Detection

Those books should get you started.

Hope it helps.