Purpose of this project is to lay the foundation for future iterations and gamedev projects. It uses header libraries. I expect to progress my gamedev skillset, both design and technology, with this as a base.

From a features standpoint this repo is considered done, future changes include refactors, renaming, and other minor development. For example, I expect to use this repo as a starting point for my own version of Breakout, implementing and designing effects that use a Particle Renderer or add an interesting mechanic that transforms gameplay.

This repo is effectively a set of changes beyond the learnopengl tutorial in C and OpenGL 3.3 (learn OpenGL):

• Rewrite in Odin
• Replace GLFW and use sokol + Zylinski's hot reload and sokol template
• Use miniaudio, stb/image, stb/truetype
• Batch text draw calls
• Resizable window, maintains aspect ratio
• Clarify vertex attributes

below from hot reload + sokol template repo

Hot reload gameplay code when making games using Odin + Sokol. Also comes with web build support (no hot reload on web, it's just for web release builds).

Supported platforms: Windows, Linux and Mac. It's possible to do the web build from all of them.

Demo and technical overview video: https://www.youtube.com/watch?v=0wNjfgZlDyw

• Odin compiler (must be in PATH)
• Python 3 (for the build script)
• Emscripten (optional, for web build support)

Run build.py -update-sokol. It will download the Sokol bindings and try to build the Sokol C libraries. It also downloads the Sokol Shader compiler.

The above may fail if no C compiler is available. For example, on Windows you may need to use the x64 Native Tools Command Prompt for VS20XX. You can re-run the compilation using build.py -compile-sokol. This will avoid re-downloading Sokol, which -update-sokol does.

If you want web build support, then you either need emcc in your path or you can point to the emscripten installation directory by adding -emsdk-path path/to/emscripten. You'll have to run -compile-sokol with these things present for it to compile the web (WASM) Sokol libraries.

1. Make sure you've done the setup
2. Run build.py -hot-reload -run
3. A game with just a spinning cube should start
4. Leave the game running, change a some line in source/game.odin. For example, you can modify the line g.rx += 60 * dt to use the value 500 instead of 60.
5. Re-run build.py -hot-reload -run. The game DLL will re-compile and get reloaded. The cube will spin faster.

1. Done automatically, otherwise force by running build.py -check-miniaudio

1. Make sure you've done the setup. Pay attention to the stuff about emcc and -emsdk-path.
2. Run build.py -web. You may also need to add -emsdk-path path/to/emscripten.
3. Web build is in build/web

Check the web developer tools console for any additional errors. Chrome tends to have better error messages than Firefox.

build.py -release makes a native release build of your game (no hot reloading).

Add -debug when running build.py to create debuggable binaries.

build.py -update-sokol downloads the lastest Odin Sokol bindings and latest Sokol shader compiler.

build.py -compile-sokol recompiles the sokol C and WASM libraries.

• Make sure you're using a terminal that has access to a C compiler.
• Re-run build.py -compile-sokol. If you want web (WASM) support, then make sure to have emcc in the PATH or use -emsdk-path path/to/emscripten to point out your emscripten installation.

• Add -gl when running build.py to force OpenGL
• Remove the set -e lines from source/sokol/build_clibs_macos.sh and source/sokol/build_clibs_macos_dylib.sh and re-run build.py -compile-sokol. This will make those scripts not crash when it fails to compile some metal-related Sokol libraries.

You probably have a global variable that allocates dynamic memory. Move that allocation into the game_init proc. This could also happen if initialize dynamic arrays or maps in the global file scope, like so:

arr := [dynamic]int { 2, 3, 4 }

In that case you can declare it and do the initialization in the init proc instead:

arr: [dynamic]int

main :: proc() {
  arr = { 2, 3, 4 }

  // bla bla
}

This happens because the context hasn't been initialized with the correct allocator yet.

Try modifying the build.py script and add these flags where it runs emcc:

-sALLOW_MEMORY_GROWTH=1 -sINITIAL_HEAP=16777216 -sSTACK_SIZE=65536

The numbers above are the default values, try bigger ones and see if it helps.

You might be missing the assets folder. It must have at least a single file inside it. You can also remove --preload assets from the build.py script.