https://github.com/deruina/cub3d-advanced-raycasting

cub3D is a 3D game engine inspired by the classic game Wolfenstein 3D. It is designed to render a maze-like environment and simulate a first-person perspective, providing an immersive gaming experience. The project is written in C and utilizes the MLX42 library.
https://github.com/deruina/cub3d-advanced-raycasting

3d-graphics cub3d raycasting wolfestein

Last synced: 2 months ago
JSON representation

cub3D is a 3D game engine inspired by the classic game Wolfenstein 3D. It is designed to render a maze-like environment and simulate a first-person perspective, providing an immersive gaming experience. The project is written in C and utilizes the MLX42 library.

• Host: GitHub
• URL: https://github.com/deruina/cub3d-advanced-raycasting
• Owner: DeRuina
• Created: 2023-08-31T06:54:43.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2023-12-21T06:30:06.000Z (over 1 year ago)
• Last Synced: 2025-01-18T07:47:14.342Z (4 months ago)
• Topics: 3d-graphics, cub3d, raycasting, wolfestein
• Language: C
• Homepage:
• Size: 1.38 MB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
![](textures/README_IMG/banner.png)

# cub3D - Advanced Raycasting

cub3D is a 3D game engine inspired by the classic game Wolfenstein 3D. It is designed to render a maze-like environment and simulate a first-person perspective, providing an immersive gaming experience.

## Features

- Real-time 3D rendering of a maze environment.

- First-person perspective movement and controls.

- Collision detection to prevent walking through walls.

- Customizable map system for creating unique mazes.

- Support for texture mapping to enhance visual appeal.

## Getting Started

### Prerequisites

- A C compiler (e.g., GCC or Clang)

- Make build automation tool

- MLX42 library for graphics and window management

- GLAD library for OpenGL loading

- lodepng library for loading PNG images

### Installation

1. Clone the repository with submodules:

`git clone --recurse-submodules https://github.com/DeRuina/cub3D.git`

2. Navigate to the project directory:

 `cd cub3D`

3. Build the project using Make:

 `make`

### Running the Game

After building the project, you can run the game engine with the following command:

`./cub3D [map name]`

## Controls

- `W` - Move forward

- `S` - Move backward

- `A` - Strafe left

- `D` - Strafe right

- `Arrow keys` - Look around

- `ESC` - Exit the game

## Custom Maps

You can create your own maps by editing the map files in the `maps` directory. Refer to the map documentation for the format and guidelines.

![game_image](textures/README_IMG/1.png)

![game_image](textures/README_IMG/2.png)

![game_image](textures/README_IMG/3.png)

## Acknowledgments

- Thanks to the creators of the MLX42 library for providing the graphics backend.

- Shoutout to the Wolfenstein 3D team for the inspiration.

## Authors

- [@DeRuina](https://github.com/DeRuina)

- [@Stte](https://github.com/Stte)