https://github.com/roymasad/3draycaster

Python retro basic 3d Wolfenstein textured walls raycaster game engine using DDA to optimize/reduce ray casting steps.
https://github.com/roymasad/3draycaster

3d doom engine game game-engine gamedev pygame python retro retrogaming wolfenstein-3d

Last synced: 2 months ago
JSON representation

Python retro basic 3d Wolfenstein textured walls raycaster game engine using DDA to optimize/reduce ray casting steps.

• Host: GitHub
• URL: https://github.com/roymasad/3draycaster
• Owner: roymasad
• License: mit
• Created: 2024-04-20T12:18:50.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-04-23T15:18:01.000Z (about 1 year ago)
• Last Synced: 2024-04-23T16:38:17.192Z (about 1 year ago)
• Topics: 3d, doom, engine, game, game-engine, gamedev, pygame, python, retro, retrogaming, wolfenstein-3d
• Language: Python
• Homepage:
• Size: 6.95 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

        
License: MIT

Code: Roy Massaad

# Python 3D DDA Raycaster 

Python retro basic 3d Wolfenstein textured walls raycaster using DDA to optimize/reduce ray casting steps.

![](doc/screenshot0.png)

![](doc/screenshot1.png)

![](doc/screenshot2.png)

# Requirements

* Python 3.11

* Pygame-ce (actually faster than pygame, still lacking tho in fps in blitting)

* CPU faster than an intel 286 and more than 528k of conventional memory sadly ;(

# Install

python -m venv env

-Windows

env\Scripts\activate

-MacOs

source env/bin/activate

pip install -r requirements.txt

# Update requirements before push

pip freeze > requirements.txt

# Features

* Map/Top 2d view for debbuging and 3d view

* Map wall grids editor in top view (left click to add a block, right click to remove)

* Different log debugging levels

* Textured and Untextured walls

* Press and hold Shift to Run

* Different types of walls

* Wall collision

* Sliding off walls support

* Depth gradient for textured and untextured walls

* Toggle Horizontal/Vertical/Auto DDA scans for debugging/learning 

* Pause/Unpause

* FPS/Raycast Steps UI counters

* Different Inline map levels

* Adjustable Field of View

* Mouse movement

* Skybox

* Weapons HUD, animation

* Audio fx and background music

* Basic animated sprites with state machine and wall occlusion

* Using custom sprite/state system (draw, update, init, animation list..)

# TODO

* Switch from pygame to pyglet for faster/hardware sprite blitting

* GUI with Score board

* Textured Floor

* Some floors with 'reflections'

* Different ceiling/walls heights? (i know it was a BSP feature but maybe can be done in raycasting..)

* Pickup Sprites (health, ammo, score)

* Weapons attack logic

* Better enemy Sprites, animation, state Machine, navigation with different sprite angles

* Add pickups/Enemy spawns to level editor

* Save/Load levels to/from external files

* Network deathmatch using Firebase realtime DB

# Asset Credits

Skybox from mekworks 

https://mekworx.the-powerhouse.net/meks-box-o-skies/

Wall textures from original wolfenstein 3d

Weapons and enemies from Brutal Doom pk3

Background music and fx original doom (mp3 versions)