+0
Daily
990
stars
427
forks
31
watchers
4,272
prs
4,618
issues
177
releases
README
Netrunner in the browser
Hosted at http://www.jinteki.net. Example of gameplay.
!screenshot
Card implementation status
Card rules implementation status
Development
Quickstart
(There's a docker section down there!)
Install Leiningen,
NodeJS and
MongoDB.
This project runs on Java 21. If you're on OSX or Linux, we recommend using
jenv to manage your java environment.
You can check your setup by running:
$ lein version
Leiningen 2.11.2 on Java 21.0.7 OpenJDK 64-Bit Server VM
Your exact version numbers may vary, but we require Java 21+.
Populate the database and create indexes using:
$ lein fetch [--no-card-images]
1648 cards imported
$ lein create-indexes
Indexes successfully created.
You can optionally pass --no-card-images if you don't want to download images from
NetrunnerDB, as this takes a while. See lein fetch help
for further options.
To install frontend dependencies, run:
$ npm ci
added 124 packages, and audited 125 packages in 2s
To compile CSS:
$ npm run css:build
compiled resources/public/css/netrunner.css
Optionally you can say npm run watch:css to watch for changes and automatically
recompile.
Compile ClojureScript frontend:
$ npm run cljs:build
[:app] Compiling ...
[:app] Build completed. (238 files, 0 compiled, 0 warnings, 22.18s)
Finally, launch the webserver and the Clojure REPL:
$ lein repl
dev.user=
and open http://localhost:1042/.
Using Docker
You'll need to install Docker and Docker-Compose. After that, just run bin/up in the project directory (or do the GUI-equivalent of this). If this fails because it "couldn't fetch dependencies", try again, it was just a networking error.
It can take a while. You'll see lots of messages, so just wait until you see something like netrunner-server-1 | nREPL server started on port 44867. After that, you can visit http://localhost:1042/ and the server should be running.
While coding clojure it's important to have a REPL connection going. The server's REPL is configured to always run on port 44867, so you can connect using $ bin/repl (or the program of your preference, like your code editor).
Now, let's populate the database and create indexes with bin/database-seed. This will download card images, which can be slow. When its done the server will be restarted. If you ever need to drop the database, run bin/database-drop. This will keep the card images you downloaded previously, but you'll need to do bin/up and bin/database-seed again.
You can access the servers' bash and lein commands individually using bin/bash and bin/lein.
When you change backend code you'll need to eval it so it's loaded, or alternatively call bin/reset to reload the code and system.
Tests
To do testing, you run them inside the container with bin/test and bin/test-focus.
To run all tests:
$ bin/test
3602 tests, 118797 assertions, 0 failures.
To run a single test file:
$ bin/test-focus game.cards.agendas-test
2Top issues
#6497Engine shortcomings11 comments · 2022-07-30#5528Is there a way we can provider I18N support?10 comments · 2021-02-01#8662Cyber Bureau: Keeping the Peace image should be rotated sideways7 comments · 2026-03-30#8366[EDITME] Please give a short description of your bug here6 comments · 2025-09-18#8818Show if once-per-turn abilities have fired5 comments · 2026-07-31#7878Audrey V2 - Strength boosting abilities persist across turns and before encounters5 comments · 2024-11-18#7518Implement a Web Push Notifications for when someone joins your room.5 comments · 2024-07-09#4050Request: move or resize UI components5 comments · 2019-02-26
Latest release
v171 v171 2026-09-04What's Changed fix: read insts as cljc.java-time.instant by @filipesilva in https://github.com/mtgred/netrunner/pull/8850 use web.game/update-and-send-diffs! for all test actions by @NoahTheDuke in https://github.com/mtgred/netrunner/pull/8852 fix: default sound to 50% by @filipesilva in https://github.com/mtgred/netrunner/pull/8851 clean up merge-costs, some other small wins by @NoahTheDuke in https://github.com/mtgred/netrunner/pull/8855 Clean up logging by @NoahTheDuke in https://github.com/mtgred/netrunner/pull/8844 Full Changelog: https://github.com/mtgred/netrunner/compare/v