Registry / devops / vite-plugin-mud

vite-plugin-mud

library2.2.23jsnpmunverified

Vite plugin for MUD projects, version 2.2.23 (stable). Part of the Lattice MUD framework for building onchain games and applications on Ethereum. It integrates Vite with MUD's build pipeline, providing hot module replacement, optimized builds, and seamless compilation of MUD config, Solidity contracts, and client-side code. Compared to other bundlers, it offers out-of-the-box support for MUD's table generation and worldgen. Updated regularly with patch releases; peer dependency on Vite ^6.0.7.

devops http-networking

npm install vite-plugin-mud

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-MUD

vite-plugin-mud

devopsjavascriptv2.2.23

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

vitePluginMud

✓ import { vitePluginMud } from 'vite-plugin-mud'

✗ import vitePluginMud from 'vite-plugin-mud'

Named export, not default.

mudConfig

✓ import { mudConfig } from 'vite-plugin-mud'

✗ const { mudConfig } = require('vite-plugin-mud')

ESM only; no CJS require support.

defineConfig

✓ import { defineConfig } from 'vite-plugin-mud'

✗ const defineConfig = require('vite-plugin-mud').defineConfig

Must use ESM import, not require.

Basic setup of vite-plugin-mud in a Vite config file, enabling MUD integration.

// vite.config.ts import { defineConfig } from 'vite'; import { vitePluginMud } from 'vite-plugin-mud'; export default defineConfig({ plugins: [ vitePluginMud({ worldAddress: process.env.WORLD_ADDRESS ?? '0x0000000000000000000000000000000000000000', }), ], });

Debug

Known issues

breakingRemoved default export; only named export provided.

fix

Use named import: import { vitePluginMud } from 'vite-plugin-mud'.

affects: >=2.0.0

breakingDropped CJS support; package is ESM-only.

fix

Use ESM imports (import/export). Ensure your project is configured for ESM.

affects: >=2.0.0

breakingPeer dependency on Vite ^6.0.7; incompatible with older Vite versions.

fix

Upgrade Vite to version 6 or later.

affects: >=2.2.0

deprecatedThe 'mudConfig' export is deprecated; use 'defineConfig' instead.

fix

Replace import { mudConfig } with import { defineConfig } from 'vite-plugin-mud'.

affects: >=2.2.0

Errors

Common errors & fixes

Error: Must use import to load ES Module: /path/to/node_modules/vite-plugin-mud/dist/index.js

CJS require() used instead of ESM import.

fix

Replace require() with import statement. Ensure your tsconfig.json has "module": "ESNext" or similar.

TypeError: vitePluginMud is not a function

Default import instead of named import.

fix

Change to import { vitePluginMud } from 'vite-plugin-mud'.

Error: Cannot find module 'vite-plugin-mud'

Package not installed or wrong path.

fix

Run `npm install vite-plugin-mud` or check the import path.

Error: Plugin 'vite-plugin-mud' requires Vite >=6.0.7

Outdated Vite version.

fix

Update Vite to version 6 or later: `npm install vite@^6.0.7`.

Upgrade

Version history

2.2.23latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

30 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/latticexyz/mud ↗

packagehttps://www.npmjs.com/package/vite-plugin-mud ↗

homepagehttps://mud.dev ↗