Breakout runs in this repository. The other projects are separate repositories or npm packages; use the working directory shown for each one. All require a graphical session and the native build requirements. Their dependency versions are independent of the sfml.js release.
Overview · Feature examples · Official examples
View full-size screenshotA native kart racer in TypeScript and sfml.js, with Mode 7 rendering, drifting, jumps, coins and items.
Node.js 20.5+ · Graphical desktop with audio · Native build prerequisites
Clone into your projects directory, then run from the game repository:
git clone https://github.com/XadillaX/super-mario-kart-sfml.js.git
cd super-mario-kart-sfml.js
npm install
npm startnpm start compiles to dist/ and launches the game. Python circuit-authoring tools are optional.
To resume, select No in the pause menu and press Enter; Yes gives up the race.
The Controls and Settings menus configure bindings, volume and resolution.
super-mario-kart-sfml.js is a TypeScript + sfml.js port of vmbatlle/super-mario-kart, originally written in C++ with SFML 2.5.1. Its 54 TypeScript modules follow the upstream source layout, retaining Mode 7 rendering, gameplay, AI and assets.
Pinned dependencies: sfml.js@1.0.0-rc.2 and typescript@7.0.2.
The circuits are Donut Plains 1, Mario Circuit 2, Ghost Valley 1, Bowser Castle 1 and Rainbow Road. Code is licensed under GPL v3; the characters, graphics and music belong to Nintendo. This is an unofficial educational fan project.
View full-size screenshotA TypeScript desktop NES emulator. JSNES emulates the console; sfml.js provides native graphics and audio.
Node.js 22 recommended · Python and a C++20 compiler · Graphical desktop with audio
Install the published player and launch the bundled game:
npm install -g play-nes
nes croomTo open a local ROM you have permission to use:
nes "/path/to/your game.nes"Esc or window close exits. Held buttons are released on focus loss.
--scale 3 changes window scale; --frameRate 60 selects normal speed. Frame rate changes emulation speed, not only display speed. Use nes --help for all options.
From the sfml.js repository root, run npm ci once, then node examples/breakout.cjs. Run npm run build after source changes.
breakout.cjs is a complete game with brick collisions, three lives, scoring and win/loss states. Move with Left/Right or A/D; Space launches or restarts, P pauses, and Esc exits. Losing focus pauses interactive play.
Use npm run demo:breakout to build and launch. For a reproducible gameplay capture on macOS/Linux:
SFML_DEMO_SNAPSHOT=/tmp/sfml-breakout.png \
node examples/breakout.cjs --autoplay --frames=1500The screenshot saves the actual native framebuffer at the final frame. --autoplay controls the paddle; --frames bounds the run. node examples/breakout.cjs --self-test checks the game logic without opening a window.
node-sfml-demos contains Bomberman, Breakout, Tetris, Doodle Jump and Arkanoid implementations using sfml.js.
Clone this separate repository into your projects directory, then install dependencies and launch from the game's own directory. For Bomberman:
git clone https://github.com/XadillaX/node-sfml-demos.git
cd node-sfml-demos/bomberman
npm install
node index.jsSee the repository README for game directories, controls and upstream C++ sources. The native build requirements also apply.
Use Node.js 22, Python 3 and a C++20 toolchain. Install inside each game folder with npm install, then run node index.js there. Keep the full repository because some games share fonts and textures. Each game pins sfml.js@1.0.0-rc.2; this page does not upgrade it. All support the close button; Bomberman also uses audio. Tetris, Doodle Jump and Arkanoid retain the prototypes' incomplete gameplay.
Two-player Bomberman in a tiled arena.
Controls · Player 1: WASD and Left Ctrl for bombs. Player 2: arrows and Space for bombs. Mouse operates the menu; Esc pauses/resumes.
Run inside: node-sfml-demos/bomberman/
npm installnode index.js
A brick breaker against a starry backdrop.
Controls · A/D or Left/Right moves and launches; Space also launches. Release Space after losing to reset. Esc exits.
Run inside: node-sfml-demos/breakout/
npm installnode index.js
Falling blocks inside a gold frame.
Controls · Left/Right moves, Up rotates, Down drops faster.
Run inside: node-sfml-demos/tetris/
npm installnode index.js
Jump between green platforms.
Controls · Left/Right moves; jumping is automatic.
Run inside: node-sfml-demos/doodle_jump/
npm installnode index.js
A compact brick breaker with green bricks.
Controls · Left/Right moves the paddle; the ball starts automatically.
Run inside: node-sfml-demos/arkanoid/
npm installnode index.js
16-sfml.js-games-ported is a fork of jsyqrt/games. The original 16 games were written in C++ with SFML; this fork ports all of them to ClojureScript with sfml.js, preserving the original directory layout, assets, game logic and controls.
The games run on Node.js through nbb, with no JVM or separate compilation step. Clone the game repository into your projects directory, then run from its root:
git clone https://github.com/XadillaX/16-sfml.js-games-ported.git
cd 16-sfml.js-games-ported
npm ci
npx nbb "01 Tetris/main.cljs"Requires Node.js 20.5+ and the native build requirements, plus a graphical session with OpenGL window support. Dependencies are pinned to sfml.js@1.0.0-rc.2 and nbb@1.6.214. Each script resolves its assets relative to its own directory.
Falling blocks and line clearing
Controls · Left/Right moves, Up rotates, Down drops faster
npx nbb "01 Tetris/main.cljs"
Jump between platforms as the screen scrolls
Controls · Left/Right moves; jumping is automatic
npx nbb "02 Doodle Jump/main.cljs"
Break bricks with a bouncing ball
Controls · Left/Right moves the paddle
npx nbb "03 Arkanoid/main.cljs"
Reveal cells and mark hidden mines
Controls · left-click reveals, right-click flags
npx nbb "05 Minesweeper/main.cljs"
A 4 × 4 sliding-tile puzzle
Controls · click a tile next to the empty square to slide it
npx nbb "06 Fifteen-Puzzle/main.cljs"
Race alongside computer-controlled cars
Controls · Up accelerates, Down brakes/reverses, Left/Right steers
npx nbb "07 Racing (Top Down)/main.cljs"
Perspective road, curves and roadside scenery
Controls · Left/Right steers, Up/Down moves forward/backward, Tab boosts speed, W/S changes camera height
npx nbb "08 Outrun/main.cljs"
Capture territory while avoiding enemies
Controls · arrow keys move, Esc resets the board
npx nbb "09 Xonix/main.cljs"
Swap neighboring gems to form matching lines
Controls · click two adjacent gems to swap
npx nbb "10 Bejeweled/main.cljs"
Connect the computers to the server
Controls · click a pipe to rotate it
npx nbb "11 NetWalk (Pipe Puzzle)/main.cljs"
Remove matching pairs of available tiles
Controls · left-click selects pairs, right-click undoes
npx nbb "12 Mahjong Solitaire/main.cljs"
Two-player light-cycle trails
Controls · arrow keys for red, W/A/S/D for green
npx nbb "13 Tron/main.cljs"
Draggable board with an external Stockfish engine
Controls · drag pieces, Space requests an engine move, Backspace undoes
npx nbb "14 Chess/main.cljs" /path/to/stockfish
Install an external Stockfish executable for your OS and pass its extracted executable path. The engine is not bundled. On Windows, placing stockfish.exe beside main.cljs also works without an argument.
Two-player volleyball with Box2D physics
Controls · Left/Right and Up for red; A/D and W for green; Up/W jumps
npx nbb "15 Volleyball/main.cljs"
box2dweb@2.1.0-b is installed by the game repository's root npm ci.
Pilot a spaceship and break apart asteroids
Controls · Left/Right rotates, Up thrusts, Space fires
npx nbb "16 Asteroids/main.cljs"
Chess requires an external Stockfish executable for your operating system; pass its path as shown above. Volleyball uses box2dweb, installed by npm ci. Close the game window to exit. See the game gallery for screenshots, source files and controls.
Game assets come from the credited upstream projects. provenance.json records screenshot sources and processing. A screenshot is not a compatibility or gameplay test report. Original game assets retain their authors' rights; these previews do not relicense them.
The C++ originals and tutorials are credited by jsyqrt/games; the reference migration is XadillaX/16-sfml.js-games-ported. node-sfml-demos and play-nes document their own licenses and credits.