explaingit

benny04131985-lab/project-citadel-3ds

Analysis updated 2026-07-26

3CAudience · generalComplexity · 4/5LicenseSetup · hard

TLDR

A fan-made port of the classic 1994 game System Shock that runs natively on the New Nintendo 3DS, featuring stereoscopic 3D and touchscreen controls. You must provide your own copy of the original game files to play.

Mindmap

mindmap
  root((repo))
    What it does
      Native 3DS port
      Stereoscopic 3D
      Touchscreen controls
    Tech stack
      C language
      3DS homebrew toolchain
      Shockolate base
    Use cases
      Play on 3DS
      Retro game preservation
      Cyberspace gameplay
    Audience
      Retro game fans
      Homebrew enthusiasts
    License
      GPL-3.0
      Bring your own files

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

Play System Shock natively on your New Nintendo 3DS handheld console.

USE CASE 2

Experience the game with stereoscopic 3D and touchscreen controls.

USE CASE 3

Preserve and enjoy classic 1994 gameplay on modern portable hardware.

What is it built with?

CNintendo 3DSShockolate

How does it compare?

benny04131985-lab/project-citadel-3dsamichail-1/orbination-whisper-aiandrewrk/libogg
Stars333
LanguageCCC
Last pushed2026-03-31
MaintenanceMaintained
Setup difficultyhardeasyeasy
Complexity4/54/52/5
Audiencegeneraldeveloperdeveloper

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires a homebrew-capable New Nintendo 3DS and a legally obtained copy of System Shock game files placed in a specific SD card folder.

Free to use and modify under the GPL-3.0 license, but you must share any modifications under the same license and provide your own legally obtained copy of System Shock game files.

In plain English

Project Citadel 3D is a fan-made port of System Shock, the classic 1994 first-person game, built to run natively on the New Nintendo 3DS handheld console. It is based on Shockolate, an existing open-source version of the original game. The project brings the full game to the 3DS hardware rather than relying on emulation. The port takes advantage of the 3DS hardware in several ways. It renders the game world in stereoscopic 3D using the console's two screens and upper camera. The heads-up display and menus stay flat with zero parallax to remain easy to read. The touchscreen supports interaction, the C-stick allows free looking around, and certain game modes like cyberspace or security camera views switch to a flat presentation automatically. The developer recommends setting the physical 3D depth slider to its middle position for comfortable play. The repository does not include the original game files due to copyright restrictions. Anyone who wants to play must supply their own legally obtained copy of System Shock. The game data needs to be placed in a specific folder on the 3DS SD card, and a separate installation guide explains the required layout. Building the project from source is also covered in its own dedicated document. The current version is labeled v1.0.0, referred to as the S3 Ship release. Most core functions work, including saving, loading, quitting from within the game, and moving between regular gameplay and cyberspace sections. One known issue remains: suspending the game with the HOME button does not always behave consistently, and the developer plans to address this in a future update. The code is distributed under the GPL-3.0 license inherited from the Shockolate project. System Shock and its associated names and assets remain the property of their original owners. Project Citadel 3D is an independent preservation effort with no official affiliation or endorsement from the rights holders.

Copy-paste prompts

Prompt 1
How do I install and set up Project Citadel 3D on my New Nintendo 3DS, including where to place the System Shock game files on the SD card?
Prompt 2
Write a beginner-friendly guide explaining the 3DS controls for Project Citadel 3D, including the C-stick for looking around and how cyberspace mode works.
Prompt 3
Help me build Project Citadel 3D from source by explaining the build process step by step for someone new to 3DS homebrew development.

Frequently asked questions

What is project-citadel-3ds?

A fan-made port of the classic 1994 game System Shock that runs natively on the New Nintendo 3DS, featuring stereoscopic 3D and touchscreen controls. You must provide your own copy of the original game files to play.

What language is project-citadel-3ds written in?

Mainly C. The stack also includes C, Nintendo 3DS, Shockolate.

What license does project-citadel-3ds use?

Free to use and modify under the GPL-3.0 license, but you must share any modifications under the same license and provide your own legally obtained copy of System Shock game files.

How hard is project-citadel-3ds to set up?

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

Who is project-citadel-3ds for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.