cub3d - My first RayCaster with miniLibX

Summary

• You have to draw a realistic 3D using RayCaster.
• My cub3D was developed using Metal via mlx, and is only compatible with macOS.
• Subject

Build & Run

• To build and run this, you will need a macOS system. (Apple Silicon or Intel)

1. Clone the repository

git clone https://github.com/T2SU/cub3d_42.git

2. Navigate to the cloned repository directory and build it. This will create the bonus subject output.

make bonus

3. Run the game with the bonus map.

./cub3D ./maps/map_bonus.cub

Controls

Function	Input
Move	W, A, S, D
Aim	Mouse move, Keyboard ←→
Fire	Mouse left click, Left ctrl
Interact	Space
WeaponSwitch	1 ~ 3 (Kick, Pistol, Shotgun)

Cheats

Function	Input
Toggle God mode	F1
Toggle Infinity ammo	F2
Toggle transcendence mode (Enemy doesn't shoot at the player)	F3
Toggle one shot mode	F4

Result

• Final mark: (115/100)
• Complete Bonus List: (15/18)
  • Wall collisions.
  • A skybox.
  • Floor and/or ceiling texture.
  • An HUD.
  • Ability to look up and down.
  • Jump or crouch.
  • A distance related shadow effect.
  • Life bar.
  • More items in the maze.
  • Object collisions.
  • Earning points and/or losing life by picking up objects/traps.
  • Doors which can open and close.
  • Secret doors.
  • Animations of a gun shot or animated sprite.
  • Several levels.
  • Sounds and music.
  • Rotate the point of view with the mouse.
  • Weapons and bad guys to fight!

Screenshot

Playthrough Video

• Youtube

Useful links

• mlx_example by taelee42 (Korean)
• Raycasting tutorial translation by 365kim (Korean)
• Wikipedia Raycasting
• Raycasting Summary (Korean)
• Make Your Own Raycaster
• Wolfenstein's Map Renderer

CREDIT for Library/Utilities/Resources

• All rights belong to proper right holder.

LIBRARY

MiniLibX by Charlie Root

• ver. Apple Metal (minilibx_mms_20200219_beta) by Olivier Crouzet ol@42.fr

MIDImyAPP - play/stop utility

• (http://www.bibiko.de/music/MIDImyAPP/)

SOUND

Music ::

• The Sisters of Mercy - Black Planet ; Instrumental Cover by PythonBlue
• (https://soundcloud.com/pythonblue/sisters-of-mercy-black-planet)
• Jun Ishikawa - Dedede's Royal Payback (Nintendo 3DS; Kirby Triple Deluxe OST)
• (https://www.youtube.com/watch?v=wYmMty5O86k)
• The little dinasour dooly Cinematic Ending song
• (https://www.youtube.com/watch?v=LUOPgy-CFfo)

SFX ::

• Doom - id Software (from doom2.wad)
• Quake II - id Software
• Half-life - Valve Software

SPRITE

Burning Drum, Candles, Hud Images, Ammo, Medikit ::

• Doom - id Software
• Doom HD Textures And Sprites by BohdanZPM
• (https://www.moddb.com/mods/doom-hd-textures-and-sprites-pack/downloads/doom-hd-textures-and-sprites-pack1)

Weapon ::

• Duke Nukem 3D - 3D Realms (Apogee Software)
• Duke Nukem 3D Upscale Pack 1.1b w. Nuclear Winter sprites
• (https://www.moddb.com/games/duke-nukem-3d/addons/duke-nukem-3d-upscale-pack-11-w-nuclear-winter-sprites)

Money ::

• Bundles of Dollars
• (https://www.hiclipart.com/free-transparent-background-png-clipart-iirow)

Crosshair ::

• 64 crosshairs pack by para
• (https://opengameart.org/content/64-crosshairs-pack)

Health Bar ::

• Nxoe Theme Hud March Ui - Hud PNG
• (https://flyclipart.com/nxoe-theme-hud-march-ui-hud-png-873195#)

TEXTURE

Brick (Mandatory Part) ::

• (https://www.pinterest.com/pin/782430135244108623/)

Floor, Wall ::

• Doom - id Software
• Doom HD Textures And Sprites by BohdanZPM
• (https://www.moddb.com/mods/doom-hd-textures-and-sprites-pack/downloads/doom-hd-textures-and-sprites-pack1)

Skybox ::

• Box 'O Skies v3 by Mechadon
• (https://www.doomworld.com/forum/post/1969145)

Door ::

• Wolfenstein 3D - id Software
• Doom II - Wolfenstein Door 02 by Hoover1979
• (https://www.deviantart.com/hoover1979/art/Doom-II-Wolfenstein-Door-02-698895747)

FONT

Modern Society

• (https://themeui.net/modern-society-free-font/)

Nanum Gothic (NHN NAVER Corp.)

• (https://hangeul.naver.com/font)