Open main menu
Last modified on 31 October 2013, at 07:56

JSMESS

Revision as of 07:56, 31 October 2013 by Morn (Talk | contribs)

JSMESS emulating a CPC6128 in Chromium 30 on Linux (with copious debug messages)
JSMESS in Firefox 24 (same rendering resolution but using page zoom to enlarge the CPC screen)

JSMESS ("JavaScript MESS") is a JavaScript translation of MESS that runs in modern web browsers like Chrome and Firefox. Despite being in its beta stage right now, JSMESS is already used by the Internet Archive to make their Historical Software Collection playable in web browsers.

Emulation speed is about 100% in Firefox and a little slower (as evident from the slower CPC startup messages) in Chrome when running the browsers on an entry-level 2012 PC. The chief remaining issues of JSMESS are spotty sound support and some bad keymapping.

History and development roadmap

The JSMESS project was originally proposed in a October 2011 blog post by Jason Scott (of textfiles.com, the Archive Team, and The Internet Archive). The idea was to have a system for preservation of old computers and game consoles that runs directly in the web browser without any plugins.

Initial progress was slow because the Emscripten transcompiler had to be fixed and improved during development. In 2013, JSMESS reached a fairly usable state and was declared to be in public beta.

Ideally JSMESS should later also have snapshot capabilities so if e.g. a certain feature is discussed on a web page, JSMESS can take you directly to that point in the game.

Also, keymapping and a virtual keyboard on the screen are planned for JSMESS, although in principle you should already be able to create keymaps in MESS and use them with JSMESS.

JSMESS development is headed toward its 1.0 release. The list of systems that are supposed to be officially supported by 1.0 also includes the CPC464/664/6128 (although the printer is erroneously listed as the program medium for the CPC).

Building from source

Unlike a normal port (that is translated only once), the JSMESS code is created by Emscripten directly from the MESS code every time you compile JSMESS. In the official version of JSMESS only a small selection of MESS machines can be compiled to JavaScript out of the box. Since compiling MESS in its entirety would create a JavaScript file that is far too big for web browsers to handle, one has to find out which parts of MESS are really needed for a given machine and create Makefiles with that subset. (JSMESS now also includes scripts that automate this task.)

It is recommended to build JSMESS modules on Linux which also makes it easier to install the dependencies for Emscripten. The basis for JSMESS is MESS 0.142 and a custom version of Emscripten.

A JSMESS fork that includes the necessary Makefiles to build the CPC6128 version exists.

Features and status

As of October 2013, sound only works in Firefox and not in Chrome/Chromium. Emulation speed in Firefox is better than in Chrome, presumably because Firefox has better support for Emscripten's asm.js-based JS code. Internet Explorer 10 was supposedly supported very well by earlier versions of JSMESS with up to 100% emulation performance (including working sound) but the current JSMESS exits with an Emscripten error in IE 10.

The joystick is mapped to Alt and the arrow keys by default.

Usage on web pages and CPC6128 demo page

Right now the way to get JSMESS running on a page is to edit the top of messloader.js so that gamename points to a DSK file for drive A.

Also, you need to provide the zipped ROM file. Note that the ROM file cpc6128.zip as on the demo page below also needs to contain the AMSDOS ROM from cpc464.zip because unlike regular MESS, JSMESS only loads a single ROM ZIP file per machine.

This JSMESS CPC demo page (with the Sub Hunter disc in drive A) also has a ZIP file download of the build with the JS, ZIPs, and HTML. Resolution is set to MODE 1 (384x272), but you can either set a higher resolution in messloader.js or use the zoom functionality of the browser to get a larger picture.

Links

General info
Code
Demos