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.

!showcase

Why CustomFuel?

• Unlimited custom fuels — assign any Material a 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 messages and switching the language key.
• Debug-friendly — toggle debug.auto-refuel to trace how the scheduler tops up furnaces.

Feature Overview

• Works on Paper 26.2+ (built against API 26.2).
• Java 25 runtime.
• /customfuel reload for admins; /customfuel manage for 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

1. Drop CustomFuel-1.0.0+26.2.jar into plugins/.
2. Start your server to generate the default config.
3. Edit plugins/CustomFuel/config.yml to your liking.
4. Run /customfuel reload to apply changes.