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 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 / modern Bukkit 1.20+ (built & tested against API 1.21).
• Java 17+ 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 (add	set	remove)smelt`
`/customfuel list [fuel	smelt]`	(none)

Installation

1. Drop the JAR into plugins/.
2. Start your server to generate the default config.
3. Edit config.yml to your liking and run /customfuel reload.