/DwarfGameEngine

A Java-based minimalistic game engine and software renderer.

Primary LanguageJavaMIT LicenseMIT



Dwarf Game Engine

A Java-based minimalistic game engine and software renderer.

ScreenshotsAboutKey FeaturesHow To UseLicense

Screenshots

lights gif screenshot1 screenshot2 screenshot3

About This Project

DwarfGameEngine started as a learning project to explore 3D graphics while I was studying Java. Inspired by a tutorial video by javidx9 on YouTube, I set out to develop my own game engine. After almost a year of work, I'm pleased to say that the project has reached a state where I consider it somewhat finished. Along the way, I've gained valuable experience and knowledge, motivating me to continue improving and refining the engine.

Key Features

  • Pixel shaders
  • Perspective correct attribute interpolation
  • Vertex attributes: normal, worldPos, depth, texcoord
  • Built-in phong and diffuse lighting
  • Simple OBJ loader
  • Scene management
  • Screen space 2D renderer
  • And more...
    These are some of the key features offered by DwarfGameEngine.

Weaknesses

I'll be honest the engine is severely limited in terms of performance. The 3D rendering is painfully slow partly because it's in software but also due to the fact that the engine is single threaded and I am not very good at optimizing things😅. To get reasonable frame rates you'll have to run the engine on low resolutions. However that's not to say I'm gonna leave it like this. This is only the alpha version so I am planning to come back to this and hopefully improve the performance

How To Use

To get started, follow these steps:

  1. Download the latest release of DwarfGameEngine from the repository and unzip the archive. You can find the download link here
  2. Inside the extracted folder, locate "DwarfGameEngine.jar".
  3. Add "DwarfGameEngine.jar" to the classpath of your project.
  4. Add "DwarfGameEngineSrc.jar" as the source file for the jar. This will help your IDE understand the source code and provide helpful suggestions while you're writing your code.
  5. With these configurations in place, you are now ready to start coding some 3D or 2D games. Check out the wiki for more

License

MIT