mujoco_wasm_contrib

This is a fork of zalo's mujoco_wasm repo, with attempts to modernize Emscripten tooling for better compatibility with SSR frameworks.

---

The Power of MuJoCo in your Browser.

Load and Run MuJoCo 2.3.1 Models using JavaScript and WebAssembly.

This repo is a fork of @stillonearth 's starter repository, adding tons of functionality and a comprehensive example scene.

$3

$3

Building

1. Install emscripten

2. Autogenerate the bindings by running src/parse_mjxmacro.py

3. Build the mujoco_wasm Binary

On Linux, use:
``bash
mkdir build
cd build
emcmake cmake ..
make
`

On Windows, run build_windows.bat.

An older version of Emscripten (<3.1.56) may be necessary.

4. (Optional) Update MuJoCo libs

Build MuJoCo libs with wasm target and place to lib. Currently v2.3.1 included.

JavaScript API

`javascript
import load_mujoco from "./mujoco_wasm.js";

// Load the MuJoCo Module
const mujoco = await load_mujoco();

// Set up Emscripten's Virtual File System
mujoco.FS.mkdir('/working');
mujoco.FS.mount(mujoco.MEMFS, { root: '.' }, '/working');
mujoco.FS.writeFile("/working/humanoid.xml", await (await fetch("./examples/scenes/humanoid.xml")).text());

// Load in the state from XML
let model = new mujoco.Model("/working/humanoid.xml");
let state = new mujoco.State(model);
let simulation = new mujoco.Simulation(model, state);
``

Typescript definitions are available.

Work In Progress Disclaimer

So far, most mjModel and mjData state variables and functions (that do not require custom structs) are exposed.

At some point, I'd like to de-opinionate the binding and make it match the original MuJoCo API better.