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. !(https://cdn.modrinth.com/data/cached_images/724f3227c13b5bed71d2afc90594d1e09b7cc83a.gif) ## 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 ```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 ` | *(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.