Cub3D Parser

A Cub3D raycasting project parser and basic renderer built in C using the MiniLibX (mlx) graphics library. This project parses .cub map files, validates map data and textures, and sets up data structures for a raycasting engine, similar to the classic Wolfenstein 3D style.

---

Features

• Parses .cub map files with walls, floors, ceilings, and doors
• Validates map integrity and textures
• Handles player spawn position and movement input
• Supports basic rendering of walls and minimap (raycasting core not included here)
• Uses MiniLibX for window and image handling
• Modularized parsing utilities for better maintainability

---

Example Output

root@e1r10p7 yaajagro/Cub3d_Parser $ ./cub3D_Parser maps/cheese_maze.cub 
[ 0.0s ] [ ⏳ INIT PARSING ]
[ 0.54s ] [ ⏳ CHECKING FILE EXTENTION ]
[ 0.107s ] [ ✅ VALID EXTENTION ]
[ 0.147s ] [ ⏳ OPENING FILE ]
[ 0.188s ] [ ✅ FILE OPENED WITH SUCCESS ]
[ 0.243s ] [ ⏳ READING FILE ]
[ 0.489s ] [ ✅ DONE READING FILE ]
[ 0.540s ] [ ⏳ INIT PARSE LINES ]
[ 0.613s ] [ ✅ DONE PARSE LINES ]
[ 0.659s ] [ ⏳ ADDING MAP LINES ]
[ 0.728s ] [ ✅ DONE ADDING MAP LINES ]  
[ 0.783s ] [ ⏳ CHECKING TEXTURES ]
[ 0.832s ] [ ⏳ CHECKING FILE textures/wall/wall_04.xpm ]
[ 0.948s ] [ ⏳ CHECKING EXTENTION ]
[ 0.1016s ] [ ✅ VALID EXTENTION ]
[ 0.1084s ] [ ✅ FILE EXIST ]
...
[ 0.5028s ] [ ✅ VALID LINE ]
[ 0.5072s ] [ ⏳ CHECKING DEPENDENCIES ]
[ 0.5135s ] [ ✅ CHECKING DEPENDENCIES ]
[ 0.5194s ] [ ✅ VALID MAP ]

---

Repository Structure

├── src/
│   ├── components/           # Parsing logic and map utilities
│   ├── lib/
│   │   ├── mlx/             # MiniLibX library
│   │   ├── libft/           # Libft helper functions
│   │   └── gnl/             # Get Next Line utilities
│   ├── main/                # Main entry point
│   ├── include/             # Header files including cub3d.h
│   └── malloc/              # Custom malloc implementation
├── obj/                     # Object files (build output)
├── Makefile                 # Build instructions
└── README.md                # This file

---

Build Instructions

Ensure you have the required dependencies installed (X11, Xext, libbsd, math library, etc.) and a compatible compiler (cc).

To build the project:

make

This will compile the parser, the MiniLibX library, and the Libft library, and then link everything into the executable:

cub3D_Parser

Cleaning Build Files

make clean       # Removes object files
make fclean      # Removes object files and the executable
make re          # Cleans and rebuilds the project

---

Usage

Run the compiled parser with a .cub map file as an argument:

./cub3D_Parser path/to/map.cub

The parser will:

• Read and validate the map file format and contents
• Extract texture paths and RGB colors for floors and ceilings
• Initialize the player’s starting position and direction
• Prepare the map data for the raycasting renderer (to be implemented or extended)

---

Notes

• This repository focuses on the parsing stage of Cub3D, including map validation and setup.
• The rendering loop, raycasting engine, and input handling are planned or may be implemented separately.
• MiniLibX is included as a submodule/library under src/lib/.mlx.
• Libft and GNL are used as utility libraries.

---

License

This project is released under the MIT License.

---

Acknowledgments

• MiniLibX by 42 school for graphics handling
• Libft for standard utility functions
• Get Next Line (GNL) for line-by-line file reading

---

Feel free to contribute or report issues!