MU Online JS (TypeScript Client)

Live Demo

A modern TypeScript/Babylon.js client for MU Online that works out-of-the-box with the OpenMU server.

Features

Runs directly in the browser
Offline single-player demo
Multiplayer support via a WebSocket ↔ TCP proxy written in Bun
Packet encryption (SimpleModulus, Xor32, Xor3)
Utility scripts for converting original MU assets to modern formats

Prerequisites

Bun ≥ v1.0

Installation

bun install

Usage

Offline demo

bun run dev

Then open http://localhost:5173/offline in your browser.

Multiplayer demo (requires OpenMU server)

Follow the OpenMU Quick Start guide to run the server.
Start the WebSocket ↔ TCP proxy:
```
bun run proxy
```
Open http://localhost:5173/ in your browser.

You should see log messages from OpenMU in the browser console.

Project layout

/proxy            WebSocket ↔ TCP proxy (Bun)
/tools            Asset-conversion scripts (BMD → GLB, OZJ → JPEG, OZT → TGA, …)
/src              Game logic, packet definitions and encryption utilities

Need help?

If you encounter a bug or have an idea for improvement, please open an issue or submit a pull request.

License

Distributed under the MIT License.

Acknowledgements

OpenMU — the open-source server this client was built for

Muonlinejs

Install / Use

README