CustomFuel

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?

- Debug-friendly – assign any `Material` a burn duration (in ticks) and optionally let the furnace recycle the produced output into the fuel slot. - Debug-friendly – 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. - Debug-friendly – shift-clicking, hotbar swaps, hoppers, and manual inserts all respect your custom fuels, including the optional auto-refuel behaviour. - Debug-friendly – 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

```yaml 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 the JAR into `plugins/`. 2. Start your server to generate the default config. 3. Edit `config.yml` to your liking and run `/customfuel reload`.