World of Warcraft in the browser using JavaScript and WebGL.
Licensed under the MIT license, see LICENSE for more information.
- Lightweight in-browser client without reliance on external plugins.
- Currently targeting Wrath of the Lich King.
- A low-level interface for developing bots/tools and debugging servers.
Wowser is both a client as well as a low-level API, allowing one to interact with a World of Warcraft server, behaving exactly as an official client would.
The project is very much a work in progress, but is already capable of successfully authenticating, logging into a realm and listing chat messages.
Wowser is written in CoffeeScript and developed with Gulp.
Getting this toolchain up and running, is easy and straight-forward:
-
Get the code:
git clone git://github.com/timkurvers/wowser.git
-
Download and install NodeJS (includes NPM) for your platform.
-
Install dependencies:
npm install
-
Run
gulpwhich will automatically build the project when source files change. -
To utilize raw TCP connections a WebSocket proxy is required for JavaScript clients.
-
Install WebSockify as follows:
sudo pip install websockify
-
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). If your server is on the same machine as your client, use a different set of ports.
websockify 3724 host:3724 websockify 8129 host:8129
-
Use
npm run serveto serve Wowser onlocalhost:3000.
When contributing, please:
- Fork the repository
- Open a pull request (preferably on a separate branch)
- Do not include any distribution files (such as wowser.js or wowser.min.js)
Wowser is presumed to be working on any browser supporting JavaScript's typed arrays and at the very least a binary version of the WebSocket protocol.