mirror of
https://github.com/Jozufozu/Flywheel.git
synced 2024-11-10 20:45:59 +01:00
62 lines
2.5 KiB
Markdown
62 lines
2.5 KiB
Markdown
<div align="center">
|
|
<img src="https://i.imgur.com/yVFgPpr.png" alt="Logo by @voxel_dani on Twitter" width="250">
|
|
<h1>Flywheel</h1>
|
|
<h6>A modern engine for modded Minecraft.</h6>
|
|
<a href='https://ci.tterrag.com/job/Flywheel/job/Forge/job/1.16/'><img src='https://ci.tterrag.com/job/Flywheel/job/Forge/job/1.16/badge/icon' alt="Jenkins"></a>
|
|
<a href="https://discord.gg/xjD59ThnXy"><img src="https://img.shields.io/discord/841464837406195712?color=5865f2&label=Discord&style=flat" alt="Discord"></a>
|
|
<a href="https://www.curseforge.com/minecraft/mc-mods/flywheel"><img src="http://cf.way2muchnoise.eu/486392.svg" alt="Curseforge Downloads"></a>
|
|
<br>
|
|
</div>
|
|
|
|
### 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`:
|
|
|
|
```groovy
|
|
repositories {
|
|
maven {
|
|
name "tterrag maven"
|
|
url "https://maven.tterrag.com/"
|
|
}
|
|
}
|
|
|
|
dependencies {
|
|
implementation fg.deobf("com.jozufozu.flywheel:Flywheel:${flywheel_version}")
|
|
}
|
|
```
|
|
`${flywheel_version}` gets replaced by the version of Flywheel you want to use, eg. `0.0.3.18`
|
|
|
|
For a list of available Flywheel versions, you can check [the maven](https://maven.tterrag.com/com/jozufozu/flywheel/Flywheel/).
|
|
|
|
If you aren't using mixed mappings (or just want to be safe), add the following properties to your run configurations:
|
|
```groovy
|
|
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.
|