> For the complete documentation index, see [llms.txt](https://docs.concha.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.concha.network/developers/fully-on-chain-games/mud-framework.md).

# MUD framework

MUD is a framework for ambitious onchain applications. It reduces the complexity of building [Ethereum](https://ethereum.org/) apps with a tightly integrated software stack. It's [open source](https://github.com/latticexyz/mud) and [free to use](https://github.com/latticexyz/mud/blob/main/LICENSE).

{% embed url="<https://mud.dev/introduction#why-mud>" %}

## Deploy MUD to Concha Network

{% hint style="warning" %}
Update to the latest foundry version.

```bash
foundryup
```

{% endhint %}

At present, MUD does not fully support zkEVM version. We have modified some packages to be able to deploy MUD contracts to zkEVM. If you are using the MUD framework, please see the instructions below to deploy your game to Concha testnet:

Step 1: Move to `packages/contracts` folder and clean the [`node_modules`](#user-content-fn-1)[^1] folder.

Step 2: Edit the `package.json` file, then replace the dependencies below:

```
"@latticexyz/cli": "npm:@concha-network/cli@2.0.0-next.17-batched",
"@latticexyz/world": "npm:@concha-network/world@2.0.0-next.17",
"@latticexyz/world-modules": "npm:@concha-network/world-modules@2.0.0-next.17"
```

Step 3: Install the dependencies

```bash
pnpm install
```

Step 4: Add Concha network profile. Edit the `foundry.toml` file, then add configurations below:

```
solc = "0.8.24" // upgrade solidity version to 0.8.24

// Add the Concha testnet profile
[profile.concha-testnet]
eth_rpc_url = "https://testnet-rpc.concha.network"
```

Step 4: Deploy to Concha testnet. Faucet native token [here](/users/onboarding/faucet-tbtc.md).

```bash
pnpm run build && mud deploy --profile=concha-testnet
```

Wait for the contracts to be deployed.

[^1]: