https://github.com/daneelsan/dodgeballz

A mini game using Zig, WASM and JS
https://github.com/daneelsan/dodgeballz

html5-canvas webassembly zig

Last synced: 3 months ago
JSON representation

A mini game using Zig, WASM and JS

• Host: GitHub
• URL: https://github.com/daneelsan/dodgeballz
• Owner: daneelsan
• Created: 2022-04-19T07:13:46.000Z (almost 3 years ago)
• Default Branch: master
• Last Pushed: 2023-09-04T21:43:47.000Z (over 1 year ago)
• Last Synced: 2024-10-24T16:50:37.775Z (3 months ago)
• Topics: html5-canvas, webassembly, zig
• Language: Zig
• Homepage:
• Size: 1010 KB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# DodgeBallz

Play the game at: https://daneelsan.github.io/Dodgeballz/

[DodgeBalls](https://github.com/daneelsan/DodgeBalls) implemented in zig (compiled to wasm-freestanding).

This mini game shows how Zig, WASM, Javascript and HTML5 canvas can interact.

In particular, there are lots of back and forth between imported and exported wasm functions.

Among those imported functions are functions that draw things on a canvas, e.g. `arc` or `strokeRect`.

![dodgeballz](./dodgeballz.gif)

## Build

Tested in version:

```shell

$ zig version

0.12.0-dev.271+5cc1831ca

```

To build the wasm module, run:

```shell

$ zig build

$ ls zig-out/lib/

DodgeBallz.wasm

```

## Run

Start up the server in this repository's directory:

```shell

python3 -m http.server

```

Go to your favorite browser and type to the URL `localhost:8000`. You should see the checkboard changing colors.

## TODOs

-   Find a better way to debug from the wasm module. I used a lot of `console.log` to debug, but given that we can only pass a limited set of types between JS and WASM (e.g. `i32` or `f32`), this was tedious. Perhaps there is a way to write a zig `Writer` that writes into the console.

-   Of course, there are many improvements to the game. The score could be made to depend on the size of the enemy, the number of enemies could increase depending on the score achieved, etc.

## Resources

-   https://github.com/daneelsan/DodgeBalls

-   https://github.com/daneelsan/minimal-zig-wasm-canvas