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)

1. Follow the OpenMU Quick Start guide to run the server.

2. Start the WebSocket ↔ TCP proxy:

   bun run proxy

3. 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