Licensed under the MIT license, see LICENSE for more information.
Wowser is a proof-of-concept of getting a triple-A game to run in a webbrowser, attempting to tackle a wide variety of challenges: data retrieval, socket connections, cryptography, 3d graphics, binary data handling, background workers and audio, to name a few.
Wowser is aiming to be both a low-level API as well as a graphical client, interacting with a World of Warcraft server like an official client would.
Note: Only Wrath of the Lich King (3.3.5a) is currently supported. A copy of the official client is required.
Warning: Do not attempt to use this client on official/retail servers as your account may get banned.
At present, Wowser is capable of:
- Authenticating by username / password.
- Listing available realms.
- Connecting to a realm.
- Listing characters available on a realm.
- Joining the game world with a character.
- Logging game world packets, such as when a creature moves in the vicinity.
In addition, there's good progress on getting terrain and models rendered.
Clone the repository:
git clone git://github.com/wowserhq/wowser.git
Download and install Node.js – including
npm– for your platform.
Webpack's development server monitors source files and builds:
npm run web-dev
Wowser will be served on
To deliver game resources to its client, Wowser ships with a pipeline.
Build the pipeline:
npm run gulp
After building, serve the pipeline as follows:
npm run serve
On first run you will be prompted to specify the following:
- Path to client data folder (e.g.
C:/Program Files (x86)/World of Warcraft/Data)
- Server port (default is
- Number of cluster workers (default depends on amount of CPUs)
Clear these settings by running
npm run reset
Disclaimer: Wowser serves up resources to the browser over HTTP. Depending on your network configuration these may be available to others. Respect laws and do not distribute game data you do not own.
Websockify can - among other things - act as a proxy for raw TCP sockets.
For now, you will want to proxy both port 3724 (auth) and 8129 (world). Use a different set of ports if the game server is on the same machine as your client.
npm run proxy 3724 host:3724 npm run proxy 8129 host:8129
When contributing, please:
- Fork the repository
- Open a pull request (preferably on a separate branch)