mirror of
https://github.com/schibo/1964js.git
synced 2025-04-02 10:52:54 -04:00
65 lines
2.6 KiB
Markdown
65 lines
2.6 KiB
Markdown
[](https://www.youtube.com/watch?v=bbPi9pfN5dE "1964js Playing Super Mario 64")
|
|
|
|
|
|
# 1964js
|
|
This is the first Nintendo 64 emulator for JavaScript. Visit the [blog](http://1964js.com/blog/index.html "1964js blog") on [1964js.com](http://1964js.com "1964js website") to see videos and to download the original Windows version of 1964.
|
|
|
|
# Building the source
|
|
|
|
To build 1964js, run ./compile.sh from the root folder on Linux.
|
|
|
|
Required to build:
|
|
|
|
* Slim
|
|
* Sass
|
|
* CoffeeScript 2.2.4
|
|
|
|
## To setup your Linux environment:
|
|
```
|
|
sudo apt-get install ruby
|
|
sudo gem install slim
|
|
sudo gem install sass
|
|
sudo gem install coffeelint
|
|
sudo apt-get install nodejs
|
|
sudo apt-get install nodejs-legacy
|
|
sudo apt-get install npm
|
|
sudo npm install -g coffeescript
|
|
sudo npm install -g coffeelint
|
|
Run compile.sh
|
|
```
|
|
|
|
## To setup your Windows environment (TODO):
|
|
```
|
|
Install MinGW/MSYS/Cygwin
|
|
Install Ruby
|
|
Install Slim
|
|
Install Sass
|
|
Install CoffeeLint
|
|
Install CoffeeScript
|
|
Install NodeJS
|
|
Install NPM
|
|
Install Java (Security is an issue on Windows, be cautious [12-30-2015])
|
|
Run compile.sh in MinGW/MSYS/Cygwin
|
|
```
|
|
|
|
The script is known to work on Mac OS X 10.13.4 and Ubuntu 14.04.3 LTS/15.10 64-bit. It should work on any platforms that have a Bash shell.
|
|
|
|
# About the emulator
|
|
|
|
1964js is (kind of) a port of our Nintendo 64 emulator for Windows called 1964. 1964 was written in C and C++ for Windows. You can still grab that [here](http://1964emu.emulation64.com "Emulation64 1964 page"). [Source on GitHub](https://github.com/schibo/1964 "1964 on GitHub")
|
|
|
|
This project is still in the early stages. The initial goal of this project was to see how well Google Chrome's V8 JavaScript compiler performs.
|
|
|
|
Instead of building a traditional dynamic recompiler (Just-In-Time/JIT compiler) as we did for 1964 on Windows, which translated MIPS instructions directly to x86 instructions, 1964js dynamically writes JavaScript to the web page by reversing MIPS code to JavaScript. This JavaScript represents blocks of ROM code. Then, if using Chrome for instance, Google's V8 compiler compiles the JavaScript to native code for us automatically.
|
|
|
|
For updates, please check [1964js.com](http://1964js.com "1964js website")!
|
|
|
|
# Compatibility
|
|
|
|
Many demos, homebrew, test ROMs, and similar ROMs work in 1964js in Chrome.
|
|
|
|
Super Mario 64 is the only known commercial game to run. Hit enter after the title screen.
|
|
|
|
Be sure to check out [n64js](http://hulkholden.github.com/n64js "N64js") as well.
|
|
|
|
Greets to StrmnNrmn, author of n64js and Daedalus. Coincidentally, we started JavaScript N64 emulators around the same time!
|