Custom Fuel
by cs127
Custom Fuel lets server owners decide which items a furnace accepts as fuel, how long each one burns, and which vanilla fuels to remove.
What it does
Settings live in a custom fuel.json file in the config folder, and the file has two optional top-level entries, include and exclude. Each one is a map whose keys are item IDs or item tags, and whose values are burn times in ticks given as integers. A value of zero or a negative number means the item is placed in the fuel slot but never burns. The exclude entry is an array of item IDs or tags that should no longer be usable as fuel.
The mod applies the include and exclude lists on top of the vanilla fuel list, so vanilla fuel items keep working unless they are excluded by hand. Because the behaviour relies on vanilla code, the change point is kept in one place for future versions. The current limitation is that exclusions must be tags, so to remove a single item a server owner creates a datapack with a custom tag that contains only that item and excludes the tag. Custom Fuel is published for Fabric and Quilt, covering 1.21.2 – 1.21.11, and requires Fabric API on both loaders.
Key features
Configurable furnace fuel
Furnace fuel items are set in a config file rather than fixed by the vanilla fuel list.
Burn time per item
Each added item or tag gets its own burn time in ticks, and zero or negative values leave it unburnable.
Exclusions by tag
Vanilla fuels can be removed with the exclude array, and single items are removed through a datapack tag.
Vanilla fuels kept by default
Inclusions and exclusions are layered on the vanilla list, so unchanged entries keep their behaviour.
Compatibility
Latest build for each game version and loader.
1.21.x10 of 10 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Use cases
Balancing fuel on a server
A server owner can remove coal or lengthen the burn time of a chosen fuel to fit the economy of a world.
Who it’s for: Server owners who want to change furnace fuel for a whole world, and modpack makers who need fuel rules without editing vanilla data.
How it compares
Smarter Furnace is server-side only, released under the MIT License, and published for Fabric on 1.21.1. Unkindled is server-side only, open source under the MIT License, and covers 1.21 – 1.21.1 on Fabric and NeoForge, so Custom Fuel is the choice for Fabric and Quilt on 1.21.2 – 1.21.11.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Custom Fuel | Fabric and Quilt | 1.21.2 – 1.21.11 | Server-side only | 2025-10-18 |
| Smarter Furnace | Fabric | 1.21.1 | Server-side only | 2025-12-15 |
| Unkindled | Fabric and NeoForge | 1.21 – 1.21.1 | Server-side only | 2024-10-09 |
Questions
Does Custom Fuel need Fabric API?
Does a player need Custom Fuel installed?
How is a single item removed from fuel?
In the catalog
Custom Fuel is one of 29,952 Game mechanics mods on ModsFinder, and one of 19,630 Game mechanics mods for Fabric. 19,862 mods support Minecraft 1.21.11.
Similar mods
What the author says
This mod lets you configure which items can be used as furnace fuel. The settings are stored in custom_fuel.json in the config folder.
Official listing
- Modrinth page
- modrinth.com/mod/custom-fuel
- Owner
- cs127
- Published
- 2025-10-18
- Updated on Modrinth
- 2025-10-18
- Facts verified
- 2026-10-15