Skip to content
View sm64js's full-sized avatar
Block or Report

Block or report sm64js

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Please don't include any personal information such as legal names or email addresses. Maximum 100 characters, markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
sm64js/README.md

sm64js

Links

Main Website: sm64js.com

Discord Server

What is this?

This is an ongoing work-in-progress port of the decompilation of original Nintendo game, Super Mario 64, to native Javascript (no emulation or web assembly). The project involved creating a Javascript WebGL port of N64 Fast 3D Renderer, originally implemented with OpenGL in C. This project also includes the development of online mass multiplayer versions of sm64js and other custom multiplayer game modes.

Build instructions - Windows, Mac, or Linux

Prerequisites

  • Node.js

Run these commands

# Clone the source code
git clone https://github.com/sm64js/sm64js.git && cd sm64js
# Install node packages
npm install
# Launch wepback dev server
npm run start

To update your project

# update folder (be inside sm64js)
git pull
# Launch server
npm run start

You should now be able to access the website with the game from a web browser by typing "localhost" into the address bar.

Build instructions With Docker - Windows, Mac, or Linux

First install Docker

Run these commands

# Create and start lightweight docker container with NodeJs
docker run --name mySm64JsServer -dp 80:80 node:13 tail -f /dev/null
# Connect to the docker container's shell
docker exec -it mySm64JsServer /bin/sh

# Install additional prerequisites
apk update && apk add git
# Clone the source code
git clone https://github.com/sm64js/sm64js.git && cd sm64js

# Install node packages, build, and serve
npm run build 
npm run serve

You should now be able to access the website with the game from a web browser by typing "localhost" into the address bar.

Neat gLinker commands you can run in the console

Because of a good portion of the game existing under the gLinker object within the window object, you can manipulate these portions of code to make certain things happen.

Drain the Castle Grounds moat:

const gEnvironmentRegions = gLinker.ObjectListProcessor.gEnvironmentRegions
gEnvironmentRegions[6] = -800
gEnvironmentRegions[12] = -800

Access Mario's state:

gLinker.LevelUpdate.gMarioState.key = value

With this, you can make Mario fly, go fast, and a lot of other things.

Related Projects

Super Mario 64 Decomp

  • Team that decompiled the original Super Mario 64 ROMs into C source code

Super Mario 64 PC Port

  • Team that ported the decompiled project to PC

N64 Fast 3D Renderer

  • OpenGL Implementation of a 3D renderer for the Nintendo 64's graphics (For this project, it was re-implemented in Javascript and WebGL)

Popular repositories

  1. sm64js sm64js Public

    A Super Mario 64 Native Javascript Port

    JavaScript 239 99

  2. sm64js-mmo-server sm64js-mmo-server Public

    The server for sm64js mmo

    Rust 21 9

  3. sm64js-mmo sm64js-mmo Public

    Super Repository for sm64js mmo server and client files

    Dockerfile 1

  4. sm64js-mmo-proto sm64js-mmo-proto Public

    sm64js-mmo-proto

    JavaScript