Show HN: The full source code and assets for my custom game engine and game

128 pointsmknsri2y ago35 comments

I always enjoy reading posts about indie game development and looking at the source code of games other people have built. So for any game I release I naturally I want to do the same.

https://github.com/Mknsri/HockeySlam

Hockey Slam is a hockey shootout game on Android which I built almost from scratch. Some of the engine features include 3D graphics with PBR materials, a rudimentary physics system, replays, a multithreaded job system and a hot-reload DLL platform for developing on Windows.

I detailed the creation of the game in it's own post, but now that time has passed I am releasing the source code and assets under the MIT license. You can still find the making of here: https://hockeyslam.com/makingof

I'm happy to answer any questions you might have.

35 comments

funcantor2y ago

You should probably give credit to Casey / Handmade Hero with regards to your windows platform code. Well its kinda scattered around, so probably just credit in general.

mknsriOP2y ago

True, Casey/HH was a huge inspiration and the project started from following the first few days of Handmade Hero. I should mention it.

Solvency2y ago

So... not from scratch?

becquerel2y ago

Here 'from scratch' probably means 'from fundamentals', e.g. without a prefab game engine, as opposed to 'taking no inspiration or lessons from anyone else or using any library code written by other people'.

Though that would be one hell of a project.

1 more reply

AustinDev2y ago

I work in tools for game devs and it's great to see more open-source work like this it's very hard to find good modern open-source game examples.

mknsriOP2y ago

Thanks, it's not the cleanest code and for example my immediate mode GUI is nowhere near IMGUI but theres still plenty to look at.

bootloop2y ago

Any idea what you would have to do to get it running on iOS?

Did you release it? If so, how is it doing compared to your expectations? (I looked for it on the Play store but couldn't find it)

mknsriOP2y ago

You would have to write the platform code for iOS similarly to how the Android and Windows is written. The initial idea was to release it on iOS as well but at the end I didn't want to invest in buying a Mac, the license and the time to port it.

Edit: As for the release, I think it barely broke a couple of hundred downloads. I didn't do any real marketing and had no real goal of really getting the game out there as it was a learning experience for me first and foremost.

ribs2y ago

Maybe compile it for Webassembly?

ne0flex2y ago

More of a general nooby question: what would be a good way to read through code like this? Where to start? How to understand what's going on and when? etc.

mknsriOP2y ago

It depends a little bit on how comfortable you are with the platform and the technologies used in the codebase. Generally speaking you would look for the entrypoint into the application.

For Hockey Slam you can look for the entrypoint in Windows:

https://github.com/Mknsri/HockeySlam/blob/main/windows/win_m...

or Android:

https://github.com/Mknsri/HockeySlam/blob/main/android/app/s...

Then start tracing through, looking at any function calls that look like they contain anything interesting. Additionally in this project you can jump straight to the entrypoints of the game code:

https://github.com/Mknsri/HockeySlam/blob/main/game/game_mai...

Or the rendering code:

https://github.com/Mknsri/HockeySlam/blob/main/ogl/ogl_main....

Another way would be to look at the files and see if anything catches your interest, for example if you want to learn about the UI system, you could look at how a button is defined:

https://github.com/Mknsri/HockeySlam/blob/main/game/imui_sys...

Fabien Sanglard has great articles on studying classic video game engines, and could be used as a guide on how to approach codebases: https://fabiensanglard.net/quake2/index.php

ne0flex2y ago

Thank you very much! I appreciate you taking the time to provide these resources.

axus2y ago

Congrats on finishing the game, it's an accomplishment

mknsriOP2y ago

Thanks! Finishing such a large project feels great and you learn a lot when you have to implement so much you take for granted when using things other people have built

dcuthbertson2y ago

Yes, congratulations on finishing the game! Also, thank you very much for sharing the story of making it. I'm more inspired than ever to keep dev logs for the little side projects I work on. It's important to keep track of progress, reflect on where you were early on, and see how far you've come.

1 more reply

fwsgonzo2y ago

I'm also making a game from scratch and reinventing wheels. What is the processing that you are doing for GLES? I see the GLSL_PREPROCESS in the GLSL.

mknsriOP2y ago

I wanted to include common code for all shaders in a simple way, but I was too lazy write a proper parser. So instead I used the C++ preprocessor and macros to include things from common shader code and combine them in the build step.

corysama2y ago

FYI: https://docs.gl/es2/glShaderSource takes an array of strings and just internally appends them together. So, rather than trying to #include common code for all my shaders, I just pass a common_code_string and a shader_specific_code_string every time.

1 more reply

dumdumchan2y ago

Why did it get deleted from Play Store?

mknsriOP2y ago

The HTTPS certificate expired on my privacy policy page and Google delists the app when that happens. After you renew they require that you resubmit the app and I didn't bother since there were barely any downloads then.

gregjw2y ago

Tedious

idrios2y ago

You wrote an Android app in C++.

...how!? How did you even learn how to do this? I've never seen a github repo or documentation or tutorials that even mentions doing this. Nothing on the developer.android website, nothing in any YouTube tutorials. I'm blown away.

skocznymroczny2y ago

https://developer.android.com/ndk/guides

you can use NDK to create an app with c++

nyarlathotep_2y ago

Really cool that this is written entirely in CPP.

All the NDK demos/examples I've seen are usually using JNI in some fashion.

1 more reply

penjelly2y ago

if youre wondering why its not on the play store

> The game has been since delisted on the Play Store, however you can download the APK here.

mknsriOP2y ago

Yeah the privacy policy page had an expired certificate and Google delists the app automatically when that happens.

ezekg2y ago

Very cool. Can you point me to the main game loop? I usually start from there when reading source code for games, but I'm having trouble finding yours. Probably just my inexperience, but any links would be great.

frfl2y ago

The entry point into the game logic appears to be here in the Android side of things https://github.com/Mknsri/HockeySlam/blob/main/android/app/s...

rudedogg2y ago

Congratulations on releasing your game! Doing this all yourself is a major achievement.

Also, the graphics look great.

mknsriOP2y ago

Thanks! I got help for the 3D models and they turned out great.

j / k navigate · click thread line to collapse

35 comments

funcantor2y ago

You should probably give credit to Casey / Handmade Hero with regards to your windows platform code. Well its kinda scattered around, so probably just credit in general.

mknsriOP2y ago

True, Casey/HH was a huge inspiration and the project started from following the first few days of Handmade Hero. I should mention it.

Solvency2y ago

So... not from scratch?

becquerel2y ago

Though that would be one hell of a project.

1 more reply

AustinDev2y ago

I work in tools for game devs and it's great to see more open-source work like this it's very hard to find good modern open-source game examples.

mknsriOP2y ago

Thanks, it's not the cleanest code and for example my immediate mode GUI is nowhere near IMGUI but theres still plenty to look at.

bootloop2y ago

Any idea what you would have to do to get it running on iOS?

Did you release it? If so, how is it doing compared to your expectations? (I looked for it on the Play store but couldn't find it)

mknsriOP2y ago

ribs2y ago

Maybe compile it for Webassembly?

ne0flex2y ago

More of a general nooby question: what would be a good way to read through code like this? Where to start? How to understand what's going on and when? etc.

mknsriOP2y ago

It depends a little bit on how comfortable you are with the platform and the technologies used in the codebase. Generally speaking you would look for the entrypoint into the application.

For Hockey Slam you can look for the entrypoint in Windows:

https://github.com/Mknsri/HockeySlam/blob/main/windows/win_m...

or Android:

https://github.com/Mknsri/HockeySlam/blob/main/android/app/s...

Then start tracing through, looking at any function calls that look like they contain anything interesting. Additionally in this project you can jump straight to the entrypoints of the game code:

https://github.com/Mknsri/HockeySlam/blob/main/game/game_mai...

Or the rendering code:

https://github.com/Mknsri/HockeySlam/blob/main/ogl/ogl_main....

Another way would be to look at the files and see if anything catches your interest, for example if you want to learn about the UI system, you could look at how a button is defined:

https://github.com/Mknsri/HockeySlam/blob/main/game/imui_sys...

Fabien Sanglard has great articles on studying classic video game engines, and could be used as a guide on how to approach codebases: https://fabiensanglard.net/quake2/index.php

ne0flex2y ago

Thank you very much! I appreciate you taking the time to provide these resources.

axus2y ago

Congrats on finishing the game, it's an accomplishment

mknsriOP2y ago

Thanks! Finishing such a large project feels great and you learn a lot when you have to implement so much you take for granted when using things other people have built

dcuthbertson2y ago

1 more reply

fwsgonzo2y ago

I'm also making a game from scratch and reinventing wheels. What is the processing that you are doing for GLES? I see the GLSL_PREPROCESS in the GLSL.

mknsriOP2y ago

corysama2y ago

1 more reply

dumdumchan2y ago

Why did it get deleted from Play Store?

mknsriOP2y ago

gregjw2y ago

Tedious

idrios2y ago

You wrote an Android app in C++.

skocznymroczny2y ago

https://developer.android.com/ndk/guides