3DEngine 2.0.2

dotnet add package 3DEngine --version 2.0.2
NuGet\Install-Package 3DEngine -Version 2.0.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="3DEngine" Version="2.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add 3DEngine --version 2.0.2
#r "nuget: 3DEngine, 2.0.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install 3DEngine as a Cake Addin
#addin nuget:?package=3DEngine&version=2.0.2

// Install 3DEngine as a Cake Tool
#tool nuget:?package=3DEngine&version=2.0.2

Logo License: MIT

3D Engine - Get it in the Microsoft Store

Documentation

Windows App SDK

Use the WinAppSDK to create beautiful, modern apps for Windows 11 that are backwards compatible to Windows 10 October 2018 Update (build 17763 / version 1809)!

  • Use your current installer (no requirement to use MSIX, but there are reliability/security benefits to using MSIX!)
  • Additive platform APIs (only add what you need, leave the rest of your app as-is)
  • Works with Win32, WPF, WinForms, and more apps

Vortice.Windows

Vortice.Windows is a collection of Win32 and UWP libraries with bindings support for DXGI, WIC, DirectWrite, Direct2D, Direct3D9, Direct3D11, Direct3D12, XInput, XAudio2, X3DAudio, DirectInput, DirectStorage, DirectML, UIAnimation and DirectSound.

This library targets .net7.0 and .net8.0 and uses modern C# 12, see CHANGELOG for list of changes between commits.

If you are looking for high-performance low level bindings, please visit Vortice.Win32

Entity Component System (ECS)

The Entity Component System is an architectural pattern often used in video game development. It facilitates code reusability by separating the data from the behavior. In addition, ECS obeys the "composition over inheritance principle," providing improved flexibility and helping developers identify entities in a game's scene where all the objects are classified as entities. One reason ECS is faster than a game object component system is that you put all the data you need together in the same place in memory. Doing so avoids the performance overhead of having to search around to find it.

NuGet Package

With the NuGet you can also only get the Engine with the NuGet Package Manager and create applications using the 3DEngine (w/o Editor) in a new project and implement all features via code.

If you want the Editor, this is the GitHub Repo for the complete 3DEngine.

dotnet new console -n Project
cd Project
dotnet add package 3DEngine
dotnet add package Costura.Fody
./Project.csproj

Engine usage:

sealed class Program
{
    [STAThread]
    private static void Main() =>
        new Engine.Program().Run();
}

Use the Engine.Kernel to get to the Scene System.

Project Setup:

<Project Sdk="Microsoft.NET.Sdk">
	<PropertyGroup>
		<OutputType>WinExe</OutputType>
		<TargetFramework>net8.0-windows10.0.22000.0</TargetFramework>
		<ImplicitUsings>enable</ImplicitUsings>
		<SatelliteResourceLanguages>en</SatelliteResourceLanguages>
		<PlatformTarget>x64</PlatformTarget>
		<PublishAot>true</PublishAot>
	</PropertyGroup>

	<ItemGroup>
	  <None Remove="FodyWeavers.xml" />
	</ItemGroup>

	<ItemGroup>
		<PackageReference Include="3DEngine" Version="2.0.1" />
		<PackageReference Include="Costura.Fody" Version="5.7.0">
		  <PrivateAssets>all</PrivateAssets>
		</PackageReference>
	</ItemGroup>

	<ItemGroup>
		<Content Update="$(NuGetPackageRoot)\3dengine\2.0.0\contentFiles\any\net8.0-windows10.0.22000\Assets\Resources\Models\Primitives\Cube.obj">
			<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
		</Content>
		<Content Update="$(NuGetPackageRoot)\3dengine\2.0.0\contentFiles\any\net8.0-windows10.0.22000\Assets\Resources\Models\Primitives\Sphere.obj">
			<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
		</Content>
		<Content Update="$(NuGetPackageRoot)\3dengine\2.0.0\contentFiles\any\net8.0-windows10.0.22000\Assets\Resources\Shaders\ImGui.hlsl">
			<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
		</Content>
		<Content Update="$(NuGetPackageRoot)\3dengine\2.0.0\contentFiles\any\net8.0-windows10.0.22000\Assets\Resources\Shaders\Include\Common.hlsli">
			<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
		</Content>
	</ItemGroup>
</Project>

Also set the Files inside the Assets Folder to "CopyIfNewer" in the Properties Panel inside Visual Studio, so it is included in the Build Folder. This will be obsolete in the Future by the USD Format.

Solution

The 3D Engine contains three Projects:

  • 3DEngine (Package)
  • Editor
  • Engine

You can compile the 3DEngine (Package) for the Editor and the Engine as a standalone.

Upcoming Features and Development Roadmap

  • Materials,
  • Render Textures,
  • Compute Shader,
  • Post Processing,
  • Gizmos,
  • USD,
  • Asynchronous Reprojection,
  • Lumen (Erebus, Aruna),
  • Nanite (Nano Tech),
  • Networking,
  • Spatial Audio,
  • PhsyX 5,
  • Export to UWP for Xbox Platform.

As a Unity Developer, I've gathered a collection of top-notch assets from the Unity Asset Store. I plan to incorporate my favorite ones into this game engine when the time is right for implementing them in the creation of various games. Here's a list of some plugins that I'll be integrating into the engine:

Build

In order to compile, you need to install Visual Studio 2022 with the following components:

Screenshots

3D Engine Layout 1 2 3 4 5 6 7 8 9 10 13

Product Compatible and additional computed target framework versions.
.NET net8.0-windows10.0.22000 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.0.2 231 3/7/2024
2.0.1 220 2/25/2024
2.0.0 207 2/25/2024
1.0.7 652 10/20/2023
1.0.6 204 10/20/2023
1.0.5 241 10/19/2023
1.0.4 239 10/18/2023
1.0.3 283 10/18/2023
1.0.2 248 10/18/2023
1.0.1 277 10/18/2023
1.0.0 270 10/13/2023