Need help with harmony?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

147 Stars 9 Forks zlib License 225 Commits 12 Opened issues


A modern 3D/2D game engine that uses wgpu.

Services available


Need anything else?

Contributors list

# 307,075
198 commits
# 481,989
1 commit


A modern 3D/2D game engine that uses wgpu and is designed to work out of the box with minimal effort. It uses legion for handling game/rendering data.

Note: Currently this library is very early in development. Things are very likely going to change.


  • [x] A custom async based asset manager that handles loading data for you.
  • [x] Ability to load custom assets via the asset manager.
  • [x] Loads GLTF meshes
  • x image support.
  • [x] Per-material type forward rendering.
  • [x] Unlit materials.
  • [x] Scene's managed by specs world.
  • [x] Entity Transforms
  • [x] Perspective Camera
  • [x] Frustum Culling
  • [x] Render Graph
  • [x] Skybox rendering from an .hdr texture.
  • [x] Multi-threaded rendering
  • [x] Custom render pipelines
  • [x] Directional lighting
  • [x] Clustered Shading (Point)
  • [x] PBR shading model
  • [x] Multi-point light shadow mapping.
  • [x] IMGui integration
  • [ ] Multiple Enviroment probes(almost done).

Future Features (Prioritized)

  1. [ ] HDR/Tonemap rendering
  2. [ ] Temporal SMAA
  3. [ ] SSAO
  4. [ ] Directional Shadow Mapping
  5. [ ] Asset Bundling
  6. [ ] More useful scene features
  7. [ ] WASM Support

Long Term

  • [ ] Investigate using a hybrid rendering pipeline setup similar to halcyon, but without ray tracing(for now..).
  • [ ] Raytracing support?


To run on metal with validation:

METAL_DEVICE_WRAPPER_TYPE=1 cargo run --example hello-cube

To run on vulkan:

cargo run --example hello-cube

Validation should be turned on already you only need to make sure to have the latest vulkan sdk installed.


  • hello-world
    a simple example showcasing the ability to draw text to the screen.
  • hello-cube
    a example of how to load gltf files and display them on the screen.
  • benchmark
    a benchmark that renders 2500 cubes to test performance.


We use shaderc-rs in harmony to compile GLSL into spir-v. This process works great once we have compiled shaderc-rs unfortunetly shaderc-rs uses shaderc which is written in C++. It tends to compile very slow and require certain things to compile successfully. We have an issue to eventually replace shaderc with something written in pure rust, but currently that crate does not exist. For now anyone attempting to use harmony who encounters issues compiling shaderc should take a look at the documentation found in the readme of shaderc-rs's github page which can be found here:

If more help is needed or you feel as though the issue you encountered is directly related to shaderc's usage in harmony feel free to open an issue.


Hello Cube PBR shadow

Known issues

  • No WASM support yet..


  • Termhn:
  • Floatingmountain: for helping out a ton!
  • Connor Fitzgerald Clustered shading help


You can find me on the rust game development discord server. I'm more than happy to help out if I am around!

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.