<h1>AuGame</h1>
<p><a href="https://aurob.github.io/augame/">DEMO</a></p>
<p><strong>2D game engine</strong> - C++ with WebAssembly, SDL2, OpenGL<br />
<strong>ECS Architecture</strong> - EnTT-based entity component system<br />
<strong>Web-Native</strong> - Runs directly in browsers via WebAssembly</p>
<hr />
<h2>Features</h2>
<ul>
<li>Custom shader pipeline with dynamic loading</li>
<li>Multi-scene management system</li>
<li>Interactive entity system (hover, click, drag)</li>
<li>Text rendering with font support</li>
<li>Physics simulation</li>
<li>Configurable world generation</li>
</ul>
<h2>Architecture</h2>
<ul>
<li><strong>Core</strong>: <code>src/main.cpp</code> - Main game loop</li>
<li><strong>Rendering</strong>: <code>include/GLUtils.hpp</code> - OpenGL pipeline</li>
<li><strong>Systems</strong>: <code>include/Systems/</code> - ECS system implementations  </li>
<li><strong>Physics</strong>: <code>include/lib/physics.hpp</code> - 2D physics engine (based on <a href="https://github.com/SifuF/physics-2d">Physics2D</a>)</li>
<li><strong>Config</strong>: <code>web/econfigs/</code> - Scene definitions</li>
<li><strong>Assets</strong>: <code>resources/</code> - Shaders, textures, fonts</li>
</ul>
<h2>Controls</h2>
<ul>
<li><strong>WASD</strong> - Player movement</li>
<li><strong>Mouse</strong> - Entity interaction (hover, click, drag)</li>
<li><strong>ESC</strong> - Pause/unpause</li>
<li><strong>C</strong> - Toggle camera mode</li>
<li><strong>Shift+&lt;/&gt;</strong> - Scene navigation</li>
</ul>
<h2>Notes</h2>
<p>This project has evolved over the past ~5 years as a casual hobby project. I've done many rewrites using different languages (JS, C, C++) and frameworks (Vanilla HTML/JS Canvas, SFML, Raylib, SDL2), before settling on the current setup.</p>
<p>In the past 1-2 years I've slowly begun integrating coding models and tools into my development process, to great success in my opinion. My favorite of these, that has been genuinely helpful/useful, is <a href="https://claude.com/product/claude-code">Claude Code</a>. I've used it extensively for some of the more complex aspects of this engine.</p>
<p>See <code>CLAUDE.md</code> for detailed development documentation from a number of sessions I've had using it.</p>
<h2>Build</h2>
<h3>Install Emscripten</h3>
<p><code>bash
git clone https://github.com/emscripten-core/emsdk.git
cd emsdk
./emsdk install latest
./emsdk activate latest
source ./emsdk_env.sh</code></p>
<h3>Build &amp; Run</h3>
<p><code>bash
git clone https://github.com/Aurob/augame.git
cd augame
chmod +x compile.sh
./compile.sh</code></p>
<p>This creates <code>web/build/main.js</code> and <code>web/build/main.wasm</code>. The <code>web/index.html</code> file will attempt to load these, but the wasm binary won't load properly without a web server hosting these files.</p>
<p><strong>Quick web server setup:</strong></p>
<p><code>bash
cd augame
python3 -m http.server 8080</code></p>
<ul>
<li>Home page: http://localhost:8080</li>
<li>Engine: http://localhost:8080/web</li>
</ul>
<h2>Self-Contained Executable (Beta)</h2>
<p><a href="https://github.com/Aurob/augame/releases/">View the latest release</a></p>
<p>Single file executable that runs without any setup on Linux, Windows, and MacOS using <a href="https://redbean.dev">Redbean</a> web server (an <a href="https://justine.lol/ape.html">actually portable executable</a>).</p>
<h3>Download</h3>
<p><a href="https://github.com/Aurob/augame/releases/latest/download/augame.com">Download augame.com</a></p>
<blockquote>
<p><strong>Note:</strong> By convention, redbean .ape binaries use the <code>.com</code> extension. This works as both a colloquial similarity to domain .com and as a valid executable extension on Windows (can be double-clicked like any .exe). The file can be also be renamed to <code>.exe</code> and still work.</p>
</blockquote>
<h3>Build It Yourself</h3>
<p>Building this repo's .com file is actually pretty simple. The redbean server is already a fully functionaing .ape executable, it also behaves like a .zip file meaning files and directories can be zipped into it using <code>zip</code>. </p>
<p>So to create augame.com, clone this repo, download the latest redbean.com file, zip the contents into it, and run <code>./augame.com</code></p>
<p>```bash</p>
<h1>Clone this repo</h1>
<p>git clone https://github.com/aurob/augame
cd augame</p>
<h1>Download the latest version of redbean</h1>
<p>wget -O augame.com "http://cdn.dump.garden/redbean-3.0.0.com"</p>
<h1>original source: https://redbean.dev/redbean-3.0.0.com</h1>
<h1>Run the compile script</h1>
<p>chmod +x compile.sh
./compile.sh</p>
<h1>Zip only the necessary files</h1>
<h1>Note: resources don't need to be included since they're compiled with the .wasm binary</h1>
<p>zip -r augame.com \
   .init.lua \
   web/index.html \
   web/econfigs \
   web/tests \
   web/scripts \
   README.md \
   LICENSE</p>
<h1>Zip these with no compression (-0) to avoid issues with fetching from the client</h1>
<p>zip -0 augame.com web/resources web/build/main.wasm web/build/main.js</p>
<h1>Run the augame redbean server</h1>
<p>chmod +x augame.com
./augame.com
```</p>
<h2>License</h2>
<p>ISC License</p>