Flywheel mirror in case github ever goes down
Find a file
PepperCode1 83f4aaa4db A fresh batch of refactoring
- Replace ModelTransformer with modular pipeline that closely resembles
the instancing pipeline
  - StructTypes and Materials now provide a VertexTransformer that
mutates a MutableVertexList
- Rewrite all model building to make it cleaner, more flexible, and
easier to use
- Add SimpleMaterial.GlStateShard for easier control over GL state
- Rename and move some classes
2022-07-29 15:58:34 -07:00
.github Merge branch '1.18/dev' into 1.18/next 2022-07-19 00:19:50 -07:00
gradle/wrapper Scheme-a-version 2022-07-15 00:00:54 -07:00
src/main A fresh batch of refactoring 2022-07-29 15:58:34 -07:00
.editorconfig Fix else formatting 2021-06-30 13:03:02 -07:00
.gitattributes Squish 2024-03-07 19:08:15 -08:00
.gitignore Reduce merge conflicts with shader-sanity 2022-01-07 11:50:01 -08:00
build.gradle Merge branch '1.18/dev' into 1.18/next 2022-07-19 00:19:50 -07:00
changelog.txt Update changelog and bug report template 2022-07-11 20:55:01 -04:00
gradle.properties Merge branch '1.18/dev' into 1.18/next 2022-07-19 00:19:50 -07:00
gradlew Scheme-a-version 2022-07-15 00:00:54 -07:00
gradlew.bat Update Gradle wrapper files 2021-07-15 11:58:26 -07:00
LICENSE.md Final fix-ups 2022-07-15 19:29:42 -07:00
README.md Sweeping up 2021-12-14 22:00:44 -08:00
settings.gradle Change project name, update ci badge 2021-11-27 11:33:29 -08:00

Logo by @voxel_dani on Twitter

Flywheel

A modern engine for modded Minecraft.
Jenkins Discord Curseforge Downloads

About

The goal of this project is to provide tools for mod developers so they no longer have to worry about performance, or limitations of Minecraft's archaic rendering engine. That said, this is primarily an outlet for me to have fun with graphics programming.

Instancing

Flywheel provides an alternate, unified path for entity and tile entity rendering that takes advantage of GPU instancing. In doing so, Flywheel gives the developer the flexibility to define their own vertex and instance formats, and write custom shaders to ingest that data.

Shaders

To accomodate the developer and leave more in the hands of the engine, Flywheel provides a custom shader loading and templating system to hide the details of the CPU/GPU interface. This system is a work in progress. There will be breaking changes, and I make no guarantees of backwards compatibility.

Plans

  • Vanilla performance improvements
  • Compute shader particles
  • Deferred rendering
  • Different renderers for differently aged hardware

Getting Started (For Developers)

Add the following repo and dependency to your build.gradle:

repositories {
    maven {
        name "tterrag maven"
        url "https://maven.tterrag.com/"
    }
}

dependencies {
    implementation fg.deobf("com.jozufozu.flywheel:Flywheel-Forge:${flywheel_version}")
}

${flywheel_version} gets replaced by the version of Flywheel you want to use, eg. 1.18-0.3.0.3

For a list of available Flywheel versions, you can check the maven.

If you aren't using mixed mappings (or just want to be safe), add the following properties to your run configurations:

property 'mixin.env.remapRefMap', 'true'
property 'mixin.env.refMapRemappingFile', "${projectDir}/build/createSrgToMcp/output.srg"

This ensures that Flywheel's mixins get properly loaded in your dev env.