https://github.com/souleeater99/cub3d

cub3D 🎮🌌 – A 42 School project recreating core mechanics of the first FPS game using ray-casting. **Core Features:** - Ray-casting engine for 3D perspective - Dynamic maze navigation with WASD controls - Texture mapping for walls/sprites - Map parsing from .cub configuration files **Technical Highlights:** ⚡ Optimized rendering pipeline | 🖼️ M
https://github.com/souleeater99/cub3d

3d-game 3d-graphics 3d-rendering 42school c game-development graphics maze-game minilibix raycasting

Last synced: about 1 year ago
JSON representation

cub3D 🎮🌌 – A 42 School project recreating core mechanics of the first FPS game using ray-casting. **Core Features:** - Ray-casting engine for 3D perspective - Dynamic maze navigation with WASD controls - Texture mapping for walls/sprites - Map parsing from .cub configuration files **Technical Highlights:** ⚡ Optimized rendering pipeline | 🖼️ M

• Host: GitHub
• URL: https://github.com/souleeater99/cub3d
• Owner: SouleEater99
• Created: 2024-10-08T10:49:20.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-25T18:06:11.000Z (about 1 year ago)
• Last Synced: 2025-03-25T18:35:18.590Z (about 1 year ago)
• Topics: 3d-game, 3d-graphics, 3d-rendering, 42school, c, game-development, graphics, maze-game, minilibix, raycasting
• Language: C
• Homepage: https://github.com/SouleEater99/cub3d
• Size: 118 MB
• Stars: 3
• Watchers: 1
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 🕹️ cub3D - Raycast Maze Adventure  

*A 42 School project recreating Wolfenstein 3D-style graphics using ray-casting techniques*  

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)  

[![42 Norm](https://img.shields.io/badge/Codestyle-42_Norm-green.svg)](https://github.com/42School/norminette)  

![Success Rate](https://img.shields.io/badge/Success_Rate-66%25-brightgreen)  

## 🚀 Features  

- **Ray-casting Engine**:  

  - 3D projection from 2D maps  

  - Wall collision detection  

  - Floor/ceiling rendering  

- **Game Controls**:  

  - WASD movement  

  - Mouse/camera rotation  

  - Minimap toggle  

- **Map System**:  

  - `.cub` file parsing  

  - Custom texture support  

  - Color configuration  

## 📊 Project Stats  

- **Team Size**: 2 developers  

- **Development Time**: ~280 hours  

- **Success Rate**: 66.7% (832 completions)  

- **Key Challenges**:  

  - 3D math implementation  

  - Texture mapping optimization  

  - Edge case handling (1.4% leak rate)  

## 🛠️ Installation  

```bash  

git clone https://github.com//cub3D.git  

cd cub3D  

make  

```

Requires MiniLibX (included)

## 🎮 Usage

```bash

./cub3D maps/example.cub  

```

Gameplay Demo ← Add gameplay screenshot/GIF

## 🎮 Gameplay  

### Screenshot  

![Maze View](./gallery/img_1c.png)  

![Maze View](./gallery/img_2.png)  

![Maze View](./gallery/img_3.png/)  

### Demo (GIF)  

![Gameplay Demo](./gallery/video.gif)  

## 📚 Technical Deep Dive

- **Ray-casting Math:**

```c

void cast_rays(t_game *game) {  

  // Ray direction calculation  

  // Wall distance projection  

  // Texture coordinate mapping  

}

```

**Performance:** 60 FPS target

**Memory:** Zero leaks enforced

## 🌟 Learning Outcomes

- **Graphics Programming:** Learned low-level rendering techniques

- **Team Collaboration:** Git workflow and task division

- **Optimization:** Balanced accuracy vs performance