whatisgithub

What is subspacehunter-sao?

whx-prog/subspacehunter-sao — explained in plain English

Analysis updated 2026-05-18

25C#Audience · developerComplexity · 4/5Setup · hard

In one sentence

A Unity-based VR action game framework and asset pack, inspired by Sword Art Online, for building sword, magic, and gun combat games on standalone headsets.

Mindmap

mindmap
  root((repo))
    What it does
      VR action game framework
      Sword magic gun combat
      Enemy AI system
    Tech stack
      Unity
      C sharp
      Quest VR
    Use cases
      Build VR combat game
      Study VR AI patterns
      Learn mixed reality UI
    Audience
      Game developers
    Caveats
      Some SAO assets learning only
      Verify third party licenses

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build a VR sword, magic, or gun combat action game for Meta Quest or PC VR.

USE CASE 2

Study physics-based melee combat and enemy AI behavior patterns in a VR context.

USE CASE 3

Learn VR-specific techniques like gesture UI, mixed-reality shadows, and performance optimization.

USE CASE 4

Start a commercial VR game project using the original art and code assets.

What is it built with?

UnityC#Quest VR

How does it compare?

whx-prog/subspacehunter-saoalekk89/llama-cpp-windows-managerqooode/nzbdavex
Stars252525
LanguageC#C#C#
Setup difficultyhardeasymoderate
Complexity4/52/53/5
Audiencedevelopervibe coderops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Unity 2021.3.45f1 and a VR headset (Quest or PC VR) to run and test.

So what is it?

SubspaceHunter-SAO is an open-source game framework and collection of art assets for building VR and mixed-reality action games using Unity. It was originally created in 2022 by Hexin Wang, then aged 22, as a personal project inspired by Sword Art Online, a Japanese animated series set inside a virtual reality massively multiplayer game. The project was released freely and the VR combat videos that circulated on social media in 2022 and 2023 came from this codebase. The framework is designed to run on standalone VR headsets such as Meta Quest. It includes a physics-based melee combat system for swords, a magic combat system, and a gun combat system. It also provides an enemy AI system with nine different behavior patterns that handle things like skill selection, range management, and animation. The project ships with nine level scenes, multiple weapons, and dozens of character and enemy models at different difficulty tiers. The README is written primarily in Chinese and describes the project as both a learning resource and a commercially usable starting point for developers who want to build their own VR action games. It lists what you can learn from studying the project, including how to set up a VR development environment, how to optimize performance and rendering in VR, how to build gesture-based UI systems, and how to handle shadows in mixed-reality scenes where virtual objects share space with the real world. The original art assets and code created by the author are available for commercial use. Some assets based on the Sword Art Online intellectual property are included for learning purposes only and cannot be used commercially. Third-party packages bundled in the project require the user to verify their own licensing terms before commercial use. The project requires Unity version 2021.3.45f1 and targets Android, Quest, and PC VR platforms.

Copy-paste prompts

Prompt 1
Walk me through setting up Unity 2021.3.45f1 for VR development with this project.
Prompt 2
Explain how the nine-pattern enemy AI system handles skill selection and range management.
Prompt 3
How does this project implement physics-based sword combat in VR?
Prompt 4
Which assets in this repo are safe to use commercially versus learning-only?
Prompt 5
Help me adapt one of the nine level scenes into my own VR game project.

Frequently asked questions

What is subspacehunter-sao?

A Unity-based VR action game framework and asset pack, inspired by Sword Art Online, for building sword, magic, and gun combat games on standalone headsets.

What language is subspacehunter-sao written in?

Mainly C#. The stack also includes Unity, C#, Quest VR.

How hard is subspacehunter-sao to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is subspacehunter-sao for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.