CustomFuel
Bring your furnaces to life. CustomFuel lets you register bespoke furnace fuels, override smelting recipes, and keep furnaces running automatically — all from a single config file.
Why CustomFuel?
- Unlimited custom fuels — assign any
Materiala burn duration (in ticks) and optionally let the furnace recycle the produced output into the fuel slot. - Datapack-free recipes — define smelting transformations (input, output, stack size, exp, cook time) directly in
config.yml. Recipes register as proper Bukkit furnace recipes, so they work with hoppers and vanilla automation. - Hands-on QoL — shift-clicking, hotbar swaps, hoppers, and manual inserts all respect your custom fuels, including the optional auto-refuel behaviour.
- Localized messages — ships with English & German templates. Drop in more languages by adding a section under
messagesand switching thelanguagekey. - Debug-friendly — toggle
debug.auto-refuelto trace how the scheduler tops up furnaces.
Feature Overview
- Works on Paper 26.2+ (built against API 26.2).
- Java 25 runtime.
/customfuel reloadfor admins;/customfuel managefor adding/removing fuels & recipes in-game.- Auto-refuel retries a few ticks to outsmart hopper timing and unloaded chunks.
- Config hot-reload keeps already-registered recipes in sync.
Configuration Snapshot
language: en
fuel:
GREEN_DYE:
burn-time: 160
auto-refuel: true
smelting:
ROTTEN_FLESH:
result: LEATHER
amount: 1
experience: 0.35
cook-time: 200
debug:
auto-refuel: false
Commands & Permissions
| Command | Permission | Description |
|---|---|---|
/customfuel reload |
customfuel.reload |
Reloads the config and reapplies fuels/recipes. |
/customfuel (add|set|remove)fuel |
customfuel.manage |
Manage custom fuels from in-game chat. |
/customfuel (add|set|remove)smelt |
customfuel.manage |
Manage custom smelting recipes. |
/customfuel list [fuel|smelt] |
(none) | Shows the currently registered fuels/recipes. |
Installation
- Drop
CustomFuel-1.0.0+26.2.jarintoplugins/. - Start your server to generate the default config.
- Edit
plugins/CustomFuel/config.ymlto your liking. - Run
/customfuel reloadto apply changes.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 26.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Verified by MCModsHub
- Ships as CustomFuel-1.0.0+26.2.jar — drop this file into the mods folder
- Download size: 35 KB
- Download link checked 21 Aug 2026 — working
These come from our own check of the pack file, not from the source page.