Repository files navigation

This project is a clean-room web port of the 3D platformer games Marble Blast Gold and Marble Blast Platinum (including Marble Blast Ultra), implemented in TypeScript.

Play it here:https://marbleblast.vani.ga/
TAS Rewind version here:https://github.com/RandomityGuy/MBG-Web-Rewind

In this game, the objective is to roll your marble to the finish pad in the fastest time possible, while avoiding hazards and collecting gems and power-ups. It includes almost 4000 levels, including 220 original MBG/MBP/MBU levels (69 beginner, 79 intermediate, 108 advanced, 25 expert) and more than 3900 community custom levels. It implements all gameplay elements, sounds, music and UI/menu components from both Marble Blast Gold, Platinum and Ultra - additional features include a replay system and online leaderboards. The two games (Gold/Platinum) can be switched between seamlessly and without reloading in the main menu. The game can be played using a keyboard, mouse or gamepad.

View version history

The game is implemented in TypeScript and utilizes a modified version ofthree.js for rendering andOimoPhysics as its physics engine. Its levels and assets weren't rebuilt from scratch; instead, they are read and imported from .dif, .dts and .mis files used internally by the Torque 3D Engine, on which the original game runs. All the game's internal logic was implemented from scratch, however. The physics simulation runs at a fixed rate of 120 Hz and utilizes continuous collision detection - it was tuned to feel like a Marble Blast game, but there are still differences in the physics, because of which times in this game shouldn't be compared to those in the original. Resources are lazily loaded over the network when required for levels, making the initial load time of the website relatively short (about 4 MB). The UIs are all implemented in plain HTML and CSS, and local persistence for settings, scores and replays is provided by IndexedDB. The game features a state-based replay system which guarantees deterministic playback - replays are compressed usingpako and stored locally. Custom levels are supplied byMarbleland and are cached on the server. The backend itself is implemented using Node.js and mostly handles resource loading and leaderboard updates. An SQLite database is used to store online scores.

If you wish to build the game yourself, simply clone the repository, then runnpm install andnpm run compile, which will compile the TypeScript code usingrollup. Then runnpm start to start up the server (runs on :8080 by default). If you want to configure the port and other server options, modifyserver/data/config.json. For fast development runnpm run watch-fast (ornpm run watch for a slower, but typechecked version). If you wish to bundle the project, runnpm run bundle, which usesSarcina and writes todist/.

Note: This project has a dependency that requiresnode-gyp. Installnode-gypbefore runningnpm install on this project withnpm install -g node-gyp, and if you're on Windows, make sure to runnpm install --global --production windows-build-tools right afterwards in anelevated command prompt (one with admin rights) to handle the annoying installation stuff.

The current version only runs on the newest versions of Chromium-based browsers, Firefox and Safari. Special thanks to the maintainers ofthree.js,OimoPhysics,pako andjszip for making this project possible, as well as toJeff,RandomityGuy andWhirligig for helping me out with parts of the code, and to the entire Marble Blast community for their feedback and support. The gameplay itself wasn't my idea at all and I highly recommend you check out GarageGames's original version of Marble Blast Gold, as well as the game's community, here:https://marbleblast.com/