D-Daria / cub3D

First RayCaster with miniLibX as Scool21/Ecole42 group project.

Cub3D

mrhyhorn and sshield group 👩🏻‍💻 🧑🏻‍💻 at School21

Content

Summary

Game

How to run

Useful links and sources

📄 Summary

Graphic project with use of miniLibX.

This project is inspired by the world-famous Wolfenstein 3D game. It aims to explore ray-casting. The goal is to make a dynamic view inside a maze, in which the player has to find the way.

🎮 Game

• The left and right arrow keys of the keyboard allow to look left and right in the maze.

• The W, A, S, D keys allow to move the point of view through the maze.

• Pressing ESC and red cross of window close the window and quit the program.

Map

All maps are stored in maps directory

The map itself is composed of 6 characters:

• 0 for an empty space
• 1 for a wall
• N,S,E or W for the player’s start position and spawning orientation

You can create your own map using the combination of characters mentioned above.

Map rules

• Map should be surrounded by wall and must not have empty lines.

To validate the map we used flood-fill algorithm

Minimap

• The minimap is displayed in the top left corner with player moving as you press the keys.

Game preview

🏁 How to run

The project can be compiled on both Mac OS and Linux.

make && ./cub3D maps/choose_your_map

Example

make && ./cub3D maps/irregular.cub

or

./cub3D maps/lab.cub

🔗 Useful links and sources

Raycasting

🌐 Lode's Computer Graphics Tutorial - Raycasting

🌐 Обучение технологии ray-casting, часть 1

🌐 permadi.com - Raycasting tutorial

▶️ Make Your Own Raycaster Part 1

Movements

▶️ Rotation matrice

🌐 Custom frame rate counter

Map validation

🌐 How can I tell if an object in a tile grid is surrounded?

🌐 Flood fill algorithm

🌐 Convert hex string to int

Textures

🌐 OpenGameArt.org

🌐 Free Texture Pack for Realtime 3D

🌐 itchio.io