https://github.com/dadavidtseng/daemonstein
A DOOM-inspired 3D first-person shooter with sprite-based enemies, split-screen multiplayer, and data-driven design
https://github.com/dadavidtseng/daemonstein
cpp cpp20 data-dr directx11 doom dx11 fmod game game-development split-screen
Last synced: 19 days ago
JSON representation
A DOOM-inspired 3D first-person shooter with sprite-based enemies, split-screen multiplayer, and data-driven design
- Host: GitHub
- URL: https://github.com/dadavidtseng/daemonstein
- Owner: dadavidtseng
- Created: 2025-03-11T05:56:19.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-02-16T03:32:55.000Z (3 months ago)
- Last Synced: 2026-02-16T10:35:33.228Z (3 months ago)
- Topics: cpp, cpp20, data-dr, directx11, doom, dx11, fmod, game, game-development, split-screen
- Language: C++
- Homepage:
- Size: 4.69 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Docs/README.md
Awesome Lists containing this project
README
[![Apache 2.0 License][license-shield]][license-url]
Daemonstein
A DOOM-inspired 3D first-person shooter with sprite-based enemies, split-screen multiplayer, and data-driven design
## Table of Contents
- [Overview](#overview)
- [Features](#features)
- [How to Install](#how-to-install)
- [How to Use](#how-to-use)
- [Project Structure](#project-structure)
- [License](#license)
- [Contact](#contact)
## Overview
Daemonstein is a 3D first-person shooter inspired by classic DOOM. Players control a Marine (100 HP) armed with a Pistol and Plasma Rifle, fighting through tile-based maps populated by Demon enemies (160 HP) that use sight-based AI with a 120° field of view. The game supports local 2-player split-screen via a lobby system, with both keyboard/mouse and Xbox controller input.
Built as a course project at SMU Guildhall, the game runs on a custom [Daemon Engine](https://github.com/dadavidtseng/Engine) providing DirectX 11 rendering with diffuse lighting, FMOD 3D audio, sprite-based 8-directional animations, and a developer console with V8 JavaScript integration.
## Features
- **Sprite-based 8-directional enemies** — Demons rendered as billboarded sprites with walk, attack, hurt, and death animations from 8 viewing angles
- **3 weapon types** — Pistol (hitscan, 10–15 dmg), Plasma Rifle (projectile, rapid-fire), and Demon Melee (180° arc, AI-only)
- **Local 2-player split-screen** — Lobby-based join system with horizontal viewport splitting and independent cameras
- **Sight-based AI** — Enemies detect targets within a 64-unit radius and 120° cone, chase using turn-toward steering, and engage in melee range
- **Data-driven design** — XML files define all actors, weapons, maps, tiles, and spawn configurations
## How to Install
### Prerequisites
- Visual Studio 2022 (or 2019) with C++ desktop development workload
- Windows 10/11 (x64)
- DirectX 11 compatible GPU
- [Daemon Engine](https://github.com/dadavidtseng/Engine) cloned as a sibling directory
### Build
```bash
# Clone both repos side by side
git clone https://github.com/dadavidtseng/Engine.git
git clone https://github.com/dadavidtseng/Daemonstein.git
# Directory layout should be:
# ├── Engine/
# └── Daemonstein/
```
1. Open `Doomenstein.sln` in Visual Studio
2. Set configuration to `Debug | x64`
3. Build the solution (the Engine project is referenced automatically)
4. The executable is deployed to `Run/` via post-build event
## How to Use
### Controls (Keyboard & Mouse)
| Action | Key |
|--------|-----|
| Move | W / A / S / D |
| Look | Mouse |
| Shoot | Left Mouse Button |
| Sprint | Shift |
| Switch to Pistol | 1 |
| Switch to Plasma Rifle | 2 |
| Free camera toggle | F |
| Possess next actor | N |
### Controls (Xbox Controller)
| Action | Button |
|--------|--------|
| Move | Left Stick |
| Look | Right Stick |
| Shoot | Right Trigger |
| Sprint | A |
| Switch weapon | D-Pad Up / Down, X / Y |
### Debug Controls
| Action | Key |
|--------|-----|
| Developer console | ` |
### Game Flow
1. **Attract Mode** — Title screen (press Space or Start to join)
2. **Lobby** — Players join/leave; press Space/Start again to begin or add a second player
3. **In-Game** — FPS combat on tile-based maps (TestMap, MPMap)
### Running
Launch `Run/Doomenstein_Debug_x64.exe` from the `Run/` directory (working directory must be `Run/` for asset loading).
## Project Structure
```
Daemonstein/
├── Code/Game/
│ ├── Definition/ # Data-driven definitions
│ │ ├── ActorDefinition # Actor stats, visuals, sounds, inventory
│ │ ├── MapDefinition # Map image, spawn info, tile sheets
│ │ ├── TileDefinition # Tile type properties
│ │ └── WeaponDefinition # Weapon stats, HUD, projectiles
│ ├── Framework/ # Application framework
│ │ ├── Main_Windows.cpp # WinMain entry point
│ │ ├── App # Application lifecycle
│ │ ├── GameCommon # Global pointers and constants
│ │ ├── Controller # Base controller (viewport, cameras)
│ │ ├── PlayerController # Keyboard/mouse & gamepad input
│ │ ├── AIController # Sight-based enemy AI
│ │ ├── Animation # Sprite animation playback
│ │ └── AnimationGroup # 8-directional animation sets
│ ├── Gameplay/ # Core game logic
│ │ ├── Game # State machine, lobby, split-screen
│ │ ├── Map # Tile world, raycasting, actor management
│ │ ├── Actor # Entity with physics, combat, inventory
│ │ ├── Tile # Individual tile in the grid
│ │ ├── Weapon # Hitscan, projectile, melee systems
│ │ ├── HUD # Weapon sprite, reticle, health display
│ │ └── Sound # FMOD audio wrapper
│ └── Subsystem/ # Engine subsystems
│ ├── Light/ # Diffuse lighting
│ └── Widget/ # UI widget framework
├── Run/ # Runtime directory
│ ├── Data/Audio/ # SFX + music (WAV, MP2, MP3)
│ ├── Data/Definitions/ # XML config (Actors, Weapons, Maps, Tiles)
│ ├── Data/Fonts/ # Bitmap fonts (PNG)
│ ├── Data/Images/ # Sprite sheets and textures
│ ├── Data/Maps/ # Map images (PNG, 32×32 grids)
│ └── Data/Shaders/ # HLSL shaders (Default, Diffuse)
├── Docs/ # Documentation
└── Doomenstein.sln # Visual Studio solution
```
## License
Copyright 2025 Yu-Wei Tseng
Licensed under the [Apache License, Version 2.0](../LICENSE).
## Contact
**Yu-Wei Tseng**
- Portfolio: [dadavidtseng.info](https://dadavidtseng.info)
- GitHub: [@dadavidtseng](https://github.com/dadavidtseng)
- LinkedIn: [dadavidtseng](https://www.linkedin.com/in/dadavidtseng/)
- Email: dadavidtseng@gmail.com
[license-shield]: https://img.shields.io/github/license/dadavidtseng/Daemonstein.svg?style=for-the-badge
[license-url]: https://github.com/dadavidtseng/Daemonstein/blob/main/LICENSE