Raycaster

This is NOT a 3D game!

This is the repository where I followed this great blog post by @grantshandy: https://grantshandy.github.io/raycasting/. It shows you how to make a game using the same raycasting technology as the first Wolfenstein game.

It's made with Rust and WASM-4, and (as of writing) weighs only 2038 bytes!

Check it out live here: https://rhian-cs.github.io/rust-tutorial-raycaster/

Controls:

• Arrow Keys move around
• Z and X turn left and right
• By clicking and dragging with your mouse the camera rotates too

Local Development

Dependencies

• Install make
• Install Rust Nightly
  • On the current directory, you can run:
    • rustup override set nightly
• Install binaryen
  • For Ubuntu you can install it with sudo apt install binaryen
• Install wasm4 version 2.3.1
  • With ASDF you can run:

  asdf plugin-add wasm4
  asdf install wasm4 2.3.1

  • You'll probably need to install glibc version 2.31
    • For Ubuntu you can install it with sudo apt install libc6
• Enable the wasm architecture for Rust:
  • rustup target add wasm32-unknown-unknown

Build and Run

Build with:

make

Build and run with:

make run

Build and check the size of the app with:

make size

Build and create a browser executable version of the game:

make bundle

VS Code Tweaks

If you use VS Code and has the CodeLLDB extension installed, you can configure the workspace to run the app by pressing F5.

To do that just create a .vscode/launch.json directory and fill it with the following:

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "lldb",
      "request": "launch",
      "name": "Debug",
      "program": "make",
      "args": ["run"],
      "cwd": "${workspaceFolder}"
    }
  ]
}

If your Rust Analyzer extension is annoying you about the panic handler, add the contents below to your local config/settings.json file (source).

{
  "rust-analyzer.checkOnSave.allTargets": false
}

Deployment

To deploy the file, I'm using the gh-pages utility, which required Node (the npx executable in particular) to be installed.

Run:

make deploy