A web-based visual novel engine that runs galgame-style stories in the browser, scripted with WebGAL Script or built with a visual editor.
4K+3 this week367TypeScriptMPL-2.0Updated 21 days ago
HasangerGames/suroi
An open-source 2D battle royale browser game inspired by surviv.io, built with TypeScript, PixiJS and Bun.
Open-source alternative to:surviv.io
- Stars
- 517
- Forks
- 243
- Open issues
- 26
- Last commit
- 6 days ago
What is it?
Suroi is a 2D battle royale game in the style of surviv.io, playable in the browser. The project is still a work in progress, and the author invites players to join its Discord and support development through donations.
The codebase is written in TypeScript. The client renders with PixiJS and is bundled with Vite, while the server runs on Node.js with uWebSockets.js for real-time networking. The project uses Bun as its package manager and task runner, and the client styles are written in SCSS.
To run it locally, install Git and Bun, clone the repository, run bun install, and then start the game with bun dev. Production builds of the client are served through NGINX, and self-hosting instructions are available in the project wiki.
Key features
- 01Browser-based 2D battle royale gameplay inspired by surviv.io
- 02Client built with PixiJS and Vite
- 03Real-time game server built on uWebSockets.js and Node.js
- 04Separate dev commands for running server and client
- 05Production client build and self-hosting support via NGINX
Use cases
- Studying how a real-time multiplayer browser game is structured in TypeScript
- Hosting a private battle royale server for friends
- Experimenting with game mechanics on a PixiJS and uWebSockets codebase
Quick start
- 1
Install Git and Bun
- 2
Clone the repository
git clone https://github.com/HasangerGames/suroi.git - 3
Enter the project directory
cd suroi - 4
Install dependencies
bun install - 5
Start the game locally and open http://127.0.0.1:3000
bun dev
Things to know
- The README says the project is a work in progress.
- Self-hosting production builds requires NGINX and setup described in the wiki.
Topics
FAQ
- What is suroi?
- An open-source 2D battle royale browser game inspired by surviv.io, built with TypeScript, PixiJS and Bun. Suroi is a 2D battle royale game in the style of surviv.io, playable in the browser. The project is still a work in progress, and the author invites players to join its Discord and support development through donations.
- Is suroi free to use? What license does it have?
- suroi is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
- Is suroi still maintained?
- Actively maintained. The last commit to suroi was on Nov 1, 2026.
- What can I use suroi for?
- Studying how a real-time multiplayer browser game is structured in TypeScript Hosting a private battle royale server for friends Experimenting with game mechanics on a PixiJS and uWebSockets codebase
- How do I install suroi?
- Install Git and Bun Clone the repository: git clone https://github.com/HasangerGames/suroi.git Enter the project directory: cd suroi Install dependencies: bun install Start the game locally and open http://127.0.0.1:3000: bun dev
- Where can I get suroi?
- The source code and installation instructions are on GitHub: https://github.com/HasangerGames/suroi
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
An open-source transport simulation game based on Transport Tycoon Deluxe, extended with new features and multiplayer support.
8.5K+31 this week1.3KC++OtherUpdated 14 hours ago
An open-source voxel action-adventure RPG set in a vast fantasy world, written in Rust and inspired by Cube World and Breath of the Wild.
7.7K+16 this week575RustGPL-3.0Well maintainedUpdated 8 days ago
A multiplayer space station game about paranoia and chaos, a C# remake of Space Station 13 built on the Robust Toolbox engine.
3.9K+9 this week5.9KC#MITUpdated 14 hours ago
Open-source turn-based strategy and board game engine in the style of Axis & Allies and Risk, with community-made maps and multiplayer.
1.6K+2 this week498JavaGPL-3.0Well maintainedUpdated yesterday