https://github.com/nusr/wukong-survivors
Wukong Survivors / 悟空幸存者
https://github.com/nusr/wukong-survivors
phaser3 reactjs survivors
Last synced: 5 months ago
JSON representation
Wukong Survivors / 悟空幸存者
- Host: GitHub
- URL: https://github.com/nusr/wukong-survivors
- Owner: nusr
- License: mit
- Created: 2025-11-11T09:45:01.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-01-16T08:35:42.000Z (5 months ago)
- Last Synced: 2026-01-16T18:30:10.777Z (5 months ago)
- Topics: phaser3, reactjs, survivors
- Language: TypeScript
- Homepage: https://nusr.github.io/wukong-survivors
- Size: 20.6 MB
- Stars: 12
- Watchers: 0
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Wukong Survivors
[](https://opensource.org/licenses/MIT)
[](https://github.com/nusr/survivor-game/actions/workflows/deploy.yml)
English | [中文](./README_ZH.md)
## 🎮 Project Overview
Wukong Survivors is a roguelike survivor game inspired by _Black Myth: Wukong_ and _Vampire Survivors_, built with Phaser.js, React, and Vite. Embark on an epic journey through legendary chapters from the Journey to the West, unlock powerful characters, and survive against endless waves of enemies.
The game supports PC, mobile, and tablet devices.
[Onlnie Demo](https://nusr.github.io/wukong-survivors/)
Mobile users can scan the QR Code below to play instantly.
### ✨ Key Features
- 🐵 **24 Playable Characters** - Unlock iconic characters from Journey to the West, including the Destined One, Black Bear Guai, Bull King, Erlang Shen, and more
- 🗺️ **6 Unique Chapters** - Explore diverse maps from Black Wind Mountain to Mount Sumeru
- ⚔️ **15 Legendary Weapons** - Collect and upgrade powerful weapons like the Golden Staff, Fire-Tipped Spear, and Plantain Fan
- 🎯 **Roguelike Progression** - Each run offers different upgrades and elixirs to create unique builds
- 💪 **Permanent Upgrades** - Spend gold to permanently enhance attack, health, armor, luck, and speed
- 🌍 **Multi-language Support** - Available in 10 languages: English, 中文, 日本語, 한국어, Français, Deutsch, Español, Português, Русский, 繁體中文
- 🤖 **Auto-Play Mode** - Automatically control your character to attack enemies and collect items
- 🔓 **One-Click Unlock** - Instantly unlock all chapters with a single click
- 🔊 **Volume Control** - Adjust the game's music volume to your preference
- ⏱️ **Chapter Time Setting** - Customize the duration of each chapter level
## 🚀 Installation Instructions
### Prerequisites
- Node.js (version 20 or higher)
- npm
### Installation Steps
```bash
# Clone the repository
git clone https://github.com/nusr/survivor-game.git
cd survivor-game
# Install dependencies
npm i -g yarn
yarn
# Start development server
npm start
```
The game will open at `http://localhost:3000`
### Build for Production
```bash
npm run build
```
### Run with Preview
```bash
npm run preview
```
### Testing
```bash
# Run all tests
npm test
# Run tests in watch mode
npm run test:watch
# Run tests with UI
npm run test:ui
# Run tests with coverage report
npm run test:coverage
# Run end-to-end tests
npm run test:e2e
```
## 🏗️ Tech Stack
- **Game Engine**: [Phaser.js](https://phaser.io/) - HTML5 game framework
- **Frontend Framework**: [React](https://react.dev/) - UI components
- **Build Tool**: [Vite](https://vitejs.dev/) - Fast development and builds
- **State Management**: [Zustand](https://github.com/pmndrs/zustand) - Lightweight state management
- **Language**: TypeScript - Type-safe development
- **i18n**: [react-i18next](https://react.i18next.com/) - Internationalization
- **Testing**: [Vitest](https://vitest.dev/) - Unit testing
## 🙏 Acknowledgments
- Inspired by _Black Myth: Wukong_, _Vampire Survivors_