kibotrel / 42-doom

In continuity of 42-Wolf3D, advanced 2.5D graphics and 3D physics engine.

42-Doom

This project was made to learn about graphics and physics engine techniques along with audio play-back and mixing using SDL2, libsndfile and libao.

Install

Works on macOS Mojave 10.14.6 and Ubuntu Bionic Beaver 18.04.4, not sure about portability on other operating systems. This project contains several submodules that you must initialize beforehand :

$> git clone --recurse-submodules https://github.com/kibotrel/42-Doom.git
$> cd 42-Doom && make

If you are running under macOS, you'll need brew installed to compile the project since some dependencies are installed via this package manager.

Usage

Run the program

Once the program is compiled, run it with the following command line :

$> ./doom-nukem

If you don't pass any argument to the program, it will allow you to play in an hard-coded map used as a tutorial that explains some of the mechanics implemented in the engine. You can play any well formatted map by passing it as argument like :

$> ./doom-nukem map.data

Features

This program contains a three different sub-menus accessible through the main one :

• Game Test-play either the tutorial or any map.
• Editor Build levels and tweak parameters in real-time.
• Settings Update game-rules and modify engine's behaviors.

For more information, click on each sub-menu to be redirected on its wiki or here for the main wiki page.

Error management

Whenever one error occurs during the process, it leads to a complete memory free before exit() with an error code and the correct error message displayed on the standard output. You can retrieve the code by running :

$> echo $?

More information available in the Error management wiki page of this project.

Screenshots

Credits

Ressources

• Audio
  • Mick Gordon - The Only Thing They Fear is You (DOOM Eternal).
  • Shotgun (DOOM Original).
• Fonts
  • Menu (Pricedown).
  • Game / Settings (Keep Calm).
  • Editor (Open Sans).
• Animations
  • Shotgun (Duke Nukem 3D).
  • Coin spin.
• Images
  • Menu Background (Doom 2016).
  • Skybox.
  • Ammunation box / shells (Doom 64).
  • Textures (Minecraft Ressources-Pack).

Helpful links

• 2D Raycasting - Texture mapping.
• Build Engine (Duke-Nukem 3D) review.
• Partial Duke-like engine demonstration.
• Frame by frame animation.
• Sound mixing with clipped frequencies.
• Point in Polygon algorithm.
• Multithread implementation.
• Pulse Code Modulation format (.PCM).
• SDL2, SDL2_ttf, libsndfile and libao APIs.

Colaborators

• @nde-jesu - Editor menu and map generation.
• @reda-con - Map parsing and user interactions.
• @lojesu - Texture mapping and settings menu.

42-doom's Issues

Incorrect Fall damage

When the player is below altitude 0, jumps at normal height, velocity and gravity will end up causing fall damage anyway.

To-do:

• Investigate on this behaviour and modify the fall damage algorithm

Document the project

Add details to the Readme and a wiki to explain how to interact with the program.

To-do:

• Finish README.md with Install process, usage, features, credits and screenshots
• Build a wiki page for each sub-menu in the program and for error management

Floating point exception in fall-damage calculation

When sector gravity is less than 0.1, a division by 0 occurs due to the fact we multiply this value by 10 and cast it for further calculations.

To-do :

• Replace gravity variable type by double (previously int)

Remove useless Error-codes

Editor error codes are only replacing the E_MALLOC one so since the triggering behaviour is the same.

TO-DO :

• Replace E_EDIT_ENTITY, E_EDIT_PORTAL, E_EDIT_SECTOR, E_EDIT_SECT_PORTAL, E_EDIT_TEXT and E_EDIT_VERTEX by E_MALLOC in clean() calls.
• Put each related message macro to "DEPRECATED".