zone-organization / nuclear-engine

A W.I.P Modern C++20 Cross-Platform Game Engine with C# Scripting.

W.I.P Cross-platform 3D Game Engine written in C++20 with C# Scripting

Getting Started | Features | Dependencies | RoadMap

Preview

For more examples, please see Samples.

Features

List is W.I.P (There are lots of features not written here)

Engine

- Custom Entity Component System (using entt as back-bone while providing systems that manages components)
- Multi-Threaded tasks execution (Job-system)

Assets

- All assets are loaded/imported asynchronously.
- Uses Assimp to import 40+ 3D model formats.
- Uses Freeimage to import 30+ image formats.
- Uses libsndfile to import 20+ sound files formats.
- All imported assets are exported into a unified formats for faster loading.
- All imported assets have a meta file that describes further loading.
- Every asset is identified with a unique UUID given on its creation.
- Section W.I.P

Graphics

- Dynamic light Component (Directional & Point & Spot)
- Flexable Material System (using different pipelines/shaders/textures for every material)
- Shadow Mapping for all light sources.
- PBR With Image Based Lighting shaders.
- Section W.I.P

Audio

- Uses OpenAL or XAudio2 as a low-level backends
- Section W.I.P

Physics

- PhysX 4.1 integration
- Section W.I.P

Scripting

- C# Scripting through Mono
- Section W.I.P

Building

Follow the instructions below to compile and run the engine from source. If you wish to build with another compiler/platform, please note that:

• The engine requires a C++20 compiler and currently only supports x64 platforms (support for x32 is planned)
• The engine doesn't contain platform-specific code and is written with cross-platform portability in mind, so porting to other platforms should be easy.

Windows

• Visual Studio 2022 or newer is required if you wish to build the solution directly
• Clone repo & submodules
• Run RunCmakeForDependencies.bat
• Compile Assimp & Diligent & OpenAL-soft found in External/CmakeProjects
• Download and compile the remaining dependencies (PhysX & FreeImage & Freetype & msdf-atlas-gen 'as static lib')
• Run CopyDependenciesBinaries.bat
• Open Nuclear Engine.sln and set your solution configuration and platform
• Compile

Other Platforms

• Planned platforms:
  • Desktop: Linux - MacOS
  • Mobile: Android - IOS

Consoles are planned but not a priority now...

Dependencies

Dependencies	Type	Buildling
Assimp	Submodule	built with cmake
DiligentCore	Submodule	built with cmake
OpenAL-soft	Submodule	built with cmake
PhysX 4.1	submodule	Built with their provided build-tools
Freeimage	submodule	Built with their provided build-tools
Freetype	submodule	Built with their provided build-tools
msdf-atlas-gen	submodule	Built with their provided build-tools
Mono	External	Put headers in External/mono
SDL2	External	Put headers in External/SDL/include
libsndfile	External	Put the .lib in your Build Output directory
spdlog	included	Built with the engine
IMGUI	included	Built with the engine
stb_truetype	included	Built with the engine
entt	included	Built with the engine
zpp::bits	included	Built with the engine

Download external dependencies through their sites. Put all their .lib in the bin folder.

RoadMap

• V0.01 Alpha:
  • Complete RenderSystem (50%)
  • Complete AudioSystem Implementation. (75%)
    • Fix AudioSource/Listener Velocity change callbacks
    • Add Support for streaming AudioClips
    • Add AudioCapture support (Microphones)
  • Basic Implementaion of PhysX.
  • Complete Samples & their documentation.

Current To-dos

• W.I.P:

  • CPU & GPU Queries & Memory/Performance Profilers
  • Use CMake instead of Visual Studio / Port to linux.
  • New Rendering Effects (Fog - SSAO - SSR - Motion Blur)
  • PostProcessing effects should be processed per camera not only in the main camera.
  • Start implementing 2D sprite rendering (+ start implementing GUI/Text Rendering)

• On-Hold:

  • Text rendering (text tile-set creation finished)
  • Basic Editor support (Nuclear Editor).
  • Finish reflecting the C++ api to the C# scripting assembly (prob provide a build-time solution that builds a binding lib?)
  • Serializing the scene & assets.

• TODO:

  • CSM
  • FIX BRDF generation in IBL Pipeline
  • Clean and document Samples.
  • GUI (basic widgets)

Contributing

• Contributions are welcome, just open a pull request or an issue. You can also join us in GitHub Discussions.

nuclear-engine's Issues

Core system 100% complete.

Support DirectX 11, 12 , Vulkan and OpenGL 4.

Done with #3

Lua scripting

I like lua :)

Rendering any model with mirrored UVs seems to be broken.

I noticed this in your readme - I haven't tried your engine (yet) but I had a similar issue once in my own project. The fix was simply to use GL_REPEAT instead of GL_CLAMP_TO_EDGE for the texture wrap mode. Maybe this is the case here?

Typo in description

Fast, customizable, cross-platfrom game engine powered by Nuclear Fuel!

Fast, customizable, cross-platform game engine powered by Nuclear Fuel!

RenderSystem Improvements.

Supporting:

• PBR
• Bloom
• HDR
• Dynamic Material

Full support of Diligent Graphics API.