We'd love your support in improving MUD! This monorepo includes all of MUD's source code, and pull requests are always welcome. To discuss new features or changes join our Discord (opens in a new tab).

Local development setup

The following steps are only necessary if you want to contribute to MUD. To use MUD in your project, set up a new project with the MUD cli.

  1. Ensure you have these applications installed:

    SoftwareTested with version
    curl (opens in a new tab)7.74.0
    node (opens in a new tab)18.17.0
    pnpm (opens in a new tab)8.6.11
    go (at least version 1.20) (opens in a new tab)1.20.7
    make (opens in a new tab)4.3
    protoc (opens in a new tab)3.15.8
  2. Download the source code for MUD.

    git clone
    cd mud
  3. Install and build packages.

    pnpm install
    pnpm build

Pull requests

MUD follows the conventional commit specification (opens in a new tab) for commit messages and PR titles. Please keep the scope of your PR small (rather open multiple small PRs than one huge PR) and follow the conventional commit spec (opens in a new tab).