Wukong Survivors

English | 中文

🎮 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

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

# 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

npm run build

Run with Preview

npm run preview

Testing

# 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 - HTML5 game framework
Frontend Framework: React - UI components
Build Tool: Vite - Fast development and builds
State Management: Zustand - Lightweight state management
Language: TypeScript - Type-safe development
i18n: react-i18next - Internationalization
Testing: Vitest - Unit testing

🙏 Acknowledgments

Inspired by Black Myth: Wukong, Vampire Survivors

nusr/wukong-survivors