MSylvia / Prowl

An Open Source C# 3D Game Engine under MIT license, inspired by Unity and featuring a Dear ImGUI editor and built on Silk.NET

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Github top languages GitHub version GitHub license GitHub issues GitHub stars Discord

๐ŸŽฎ An Open Source Unity-like Engine! ๐ŸŽฎ

  1. About The Project
  2. Features
  3. Getting Started
  4. Roadmap
  5. Contributing
  6. Acknowledgments
  7. License
  8. Dependencies
  9. Screenshots

๐Ÿ“ About The Project ๐Ÿ“

Prowl is an open-source, MIT-licensed game engine developed in pure C# in .NET 8, (which surprisingly has no runtime fees believe it or not! ๐Ÿ˜ฎ). It aims to provide a seamless transition for developers familiar with Unity by maintaining a similar API while also following KISS and staying as small and customizable as possible. This engine is intended to be customized to your needs, everything is written to be a "Minimal" Production-Ready Implementation. Ideally, there will be plenty of Modules/Packages to expand on functionality for those who don't want (or are unable) to expand the base engine.

Showcase

โœจ Features โœจ

  • General:

    • Unity-like Editor & Scripting API
    • C# Scripting
    • Gameobject & Component structure
    • .NET 8
    • Dear ImGUI Editor, including ImGuizmo, ImPlot, ImNodes
    • Editor with support for Editor Scripts and Custom Editors
    • Physics (Bepu Physics 2)
      • Colliders: Box, Sphere, Capsule, Cylinder, Mesh Collider
      • Rigidbody-based Character Controller
    • Unity-like Coroutines
    • Playtest directly in Editor
    • ScriptableObjects
    • Projects & Project Settings
    • Unity-like Serializer to create In-Memory Graphs
      • Graph -> Text (System.Text.Json)
      • Graph -> Binary
    • Full 64-bit using Doubles
    • Large World Coordinates Support
      • Camera Relative Rendering
    • Scene System
    • Modular Audio Backend
      • OpenAL
      • Currently only supports .wav files
    • Prefabs
    • Build System - Build to Standalone Application
      • Packed Asset files
    • Node System (A Port of xNode from Unity)
    • CSG (Constructive Solid Geometry) API (No CSG Level Editor Yet)
  • Graphics Rendering:

    • Modular Graphics Backend
      • OpenGL
    • PBR (Physically Based Rendering) using Cook-Torrance BRDF
      • Albedo Map
      • Normal Map
      • Roughness Map
      • Metallic Map
      • Ambient Occclusion Map
      • Emission Map
    • Node-Based Customizable Render Pipelines
    • Deferred Renderer
    • Point, Spot, and Directional Lights
    • Shadow Mapping + Contact Hardening (Variable Penumbra)
    • Post Processing
      • HDR with Tonemapping (Melon, Aces, Reinhard, Uncharted, Filmic)
      • Bokeh Depth of Field
      • Screen Space Reflections
      • Kawase Multi-Pass Bloom
      • Temporal Anti-Aliasing
    • Stochastic Transparency
    • Adjustable Render Resolutions per camera
    • Dedicated Shadow Pass for Shaders
    • Procedural Skybox with Skybox-Blended Fog
    • GPU Skinned Mesh Rendering
    • Skeletal Animations
  • Asset Pipeline:

    • A Powerful Asset Pipeline with a very similar structure to unity
    • Meta Files & Reference by GUID
    • Import Caching
    • Support for Custom Importers
    • Supports many major file formats via ImageMagick, Assimp, etc
    • Sub-Assets, Assets stored inside other assets
    • Dependency Tracking

(back to top)

๐Ÿš€ Getting Started ๐Ÿš€

Getting Prowl up and running is super easy!

Note: There are no official releases yet so you need to download this repository to use Prowl!

Prerequisites

Installation

  1. Clone the repo
  2. Open .sln file with Visual Studio Version 17.8.0+
  3. That's it! ๐Ÿ˜„ ๐ŸŽ‰

(back to top)

๐Ÿ—บ๏ธ Roadmap ๐Ÿ—บ๏ธ

Engine

  • ๐Ÿ› ๏ธ Cross Platform
    • โœ”๏ธ Windows - Fully functional
    • โœ”๏ธ MacOS - ImGUI asserts cause crashes occasionally
    • ๐Ÿ› ๏ธ Linux
    • โŒ Andriod
    • โŒ iOS
    • โŒ Web
  • โŒ UI Engine
  • โŒ VR Support
  • โŒ Navmesh and AI Agents
  • โŒ Networking Solution

Rendering

  • โŒ SSAO, Screen-Space Decals, etc.
  • โŒ Realtime GI
  • โŒ Lightmaps and Light Probes
  • โŒ Cascaded shadow mapping
  • โŒ Particle System
  • โŒ Terrain Engine

Editor

  • โŒ Package Manager (Packages partially implemented)
  • โŒ Animation Tools
  • โŒ Live Collaborative Tools
  • โŒ Visual Scripting
  • โŒ Material Node Editor
  • โŒ 2D Support

See the open issues for a full list of proposed features (and known issues).

(back to top)

๐Ÿค Contributing ๐Ÿค

๐Ÿš€ Welcome to the Prowl community! We're thrilled that you're interested in contributing.

We're not too proud to admit it โ€“ we need your help. ๐Ÿ†˜

Developing a game engine is a colossal task, and we can't do it alone. We need passionate developers, designers, testers, and documentation enthusiasts, people like you to help make Prowl the best it can be. ๐Ÿ’ช

How You Can Contribute

Code Contributions ๐Ÿ’ป

Whether you're a seasoned developer or just getting started, your code contributions are invaluable. We have a list of open issues that you can tackle, or feel free to propose your own improvements.

Bug Reports ๐Ÿ›

Encountered a bug? We want to know! Submit detailed bug reports on our issue tracker to help us squash those pesky bugs.

Feature Requests ๐Ÿ’ก

Have a fantastic idea for a new feature? Share it with us! Open a feature request and let's discuss how we can make Prowl even better.

Spread the Word ๐Ÿ“ฃ

Not a developer? No problem! You can still contribute by spreading the word. Share your experiences with Prowl on social media, blogs, or forums. Let the world know about the exciting things happening here.

Contributor Recognition ๐Ÿ†

We're not just asking for contributors; we're asking for partners in this journey. Every small contribution is a step toward realizing Prowl.

All contributors will be acknowledged in our Acknowledgments section.

Thank you for considering contributing to Prowl. Together, let's build something amazing!

(back to top)

๐Ÿ™ Acknowledgments ๐Ÿ™

  • Hat tip to the creators of Raylib, While we are no longer based upon it, it has shaved off hours of development time getting the engine to a usable state.
  • Some ideas/code have been taken from the amazing 2D Engine Duality.

(back to top)

Contributors ๐ŸŒŸ

License ๐Ÿ“œ

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Dependencies ๐Ÿ“ฆ

Runtime

Editor

(back to top)

๐Ÿ“ธ Screenshots ๐Ÿ“ธ

image

image animations Bokeh Depth of Field Editor image Flight Model image image image

(back to top)

About

An Open Source C# 3D Game Engine under MIT license, inspired by Unity and featuring a Dear ImGUI editor and built on Silk.NET

License:MIT License


Languages

Language:C# 96.5%Language:GLSL 3.5%