Vanillin

How it Works

Vanillin optimizes Minecraft by implementing instanced rendering for entities and block entities through Flywheel.

With Flywheel doing the heavy lifting, Vanillin is able to achieve significant performance improvements on all the game objects it affects. The end result is that ten thousand of something have the same frame time impact as one of something.

Shaders

Flywheel 1.0, and therefore Vanillin, is currently incompatible with shaders. Work is underway to make first party compat a reality.

Optimizations

Vanillin does not optimize everything by default. Special support needs to be built for each type of entity and block entity. Those that are currently optimized are listed below.

✅ = Stable, enabled by default

🧪 = Experimental, enabled behind a config

Block Entities

• ✅ Chests
• ✅ Shulker boxes
• ✅ Bells
• 🧪 Signs

Entities

• ✅ Minecarts (and all variants)

How it Works

Vanillin optimizes Minecraft by implementing instanced rendering for entities and block entities through Flywheel.

With Flywheel doing the heavy lifting, Vanillin is able to achieve significant performance improvements on all the game objects it affects. The end result is that ten thousand of something have the same frame time impact as one of something.

Shaders

Flywheel 1.0, and therefore Vanillin, is currently incompatible with shaders. Work is underway to make first party compat between Flywheel and shaders a reality, but no time estimates can be made.

Optimizations

Vanillin does not optimize everything by default. Special support needs to be built for each type of entity and block entity. Those that are currently optimized are listed below.

✅ = Stable, enabled by default.

🧪 = Experimental, enabled behind a config.

❌ = Temporarily disabled entirely due to crashes/compat/etc.

Block Entities

• ✅ Chests
• ✅ Shulker boxes
• ✅ Bells
• ❌ Signs

Entities

• ✅ Minecarts (and all variants)
• 🧪 Items
• 🧪 Item Displays
• 🧪 Block Displays

Config

To enable experimental optimizations, edit the config file:

Forge/NeoForge

config/vanillin.toml

[entities]
    #Allowed Values: DEFAULT, DISABLE, FORCE_ENABLE
-   "minecraft:item" = "DEFAULT"
+   "minecraft:item" = "FORCE_ENABLE"

Fabric

config/vanillin.json

{
  "entities": {
-   "minecraft:item": "default",
+   "minecraft:item": "force_enable",
  }
}

Alternatively, you can disable optimizations that you find to be causing conflict:

Forge/NeoForge

config/vanillin.toml

[entities]
    #Allowed Values: DEFAULT, DISABLE, FORCE_ENABLE
-   "minecraft:minecart" = "DEFAULT"
+   "minecraft:minecart" = "DISABLE"

Fabric

config/vanillin.json

{
  "entities": {
-   "minecraft:minecart": "default",
+   "minecraft:minecart": "disable",
  }
}