Infinite Fuel v1.4

» WHAT IS INFINITEFUEL?


InfiniteFuel is a lightweight Paper 1.21+ plugin that introduces a special in-game item — a piece of coal, charcoal, coal block, blaze rod, or lava bucket - that never gets consumed when used as furnace fuel. Place it in a furnace fuel slot and it will burn indefinitely. The item physically stays in the slot, no duplication, no flickering, no fake item tricks. It just works.

The plugin is designed for server administrators who want to give players a meaningful quality-of-life reward, create a rare economy item, or set up donor perks without installing heavy economy frameworks. A single JAR, a single config file, and your players never have to think about fuel again.




» THE PROBLEM IT SOLVES


Fuel management is an invisible tax on your players' time. Survival players stockpile coal instead of exploring. Economy players burn hundreds of stacks per session just to process ore. Auto-smelting farms grind to a halt the moment the hopper runs dry. This constant fuel loop makes your server feel like a chore - not an adventure.

InfiniteFuel removes that friction entirely. One item, placed once, powers a furnace forever. Your players can focus on the parts of the game that actually matter.

Core Mechanics

InfiniteFuel works with all three vanilla smelting blocks out of the box: the standard Furnace, the Blast Furnace and the Smoker. The item is identified via Paper's PersistentDataContainer (NBT) API - not by display name or lore - so it cannot be faked and survives anvil renames, chunk reloads and server restarts without any issues.

A configurable smelting speed multiplier lets you supercharge furnaces that run on Infinite Fuel. Setting it to 2.0x halves smelting time; 1.0x keeps vanilla speed. This is a great lever for creating VIP or donor tiers where premium players smelt faster than everyone else.

1. True Infinite Burning - The fuel item is never consumed. The plugin intercepts FurnaceBurnEvent and extends burn time directly, so there is no item drop, no replacement spawn and no visible flicker. The item physically stays in the slot forever.
2. All Three Furnace Types - Works in Furnace, Blast Furnace and Smoker. Each block type is handled independently so smelting speed bonuses apply correctly to each.
3. Configurable Fuel Materials - Any vanilla fuel material can be whitelisted: Coal, Charcoal, Coal Block, Blaze Rod, Lava Bucket, or others. Each material retains its original visual texture so the item looks natural in the inventory.
4. Smelting Speed Multiplier - Set a decimal multiplier in config (e.g. 2.0 for double speed, 0.5 for half speed). Works independently per material type if needed.

Balance and Economy Protection

Giving players an item that burns infinitely could break your economy if there were no safeguards. InfiniteFuel ships with every relevant exploit vector blocked by default, and each guard is individually toggleable in config so you decide how strict your server is.

1. Crafting Fully Blocked - Infinite Fuel cannot be used as an ingredient in: Crafting Table, Anvil, Smithing Table, Grindstone, Stonecutter, Loom, Cartography Table and Brewing Stand. Your item economy stays intact.
2. Hopper Automation Control - By default, hoppers cannot pick up or move Infinite Fuel. Flip one config flag to allow hopper automation for your highest-tier players.
3. Single-Slot Enforcement - Prevents players from accidentally placing more than one Infinite Fuel into a furnace fuel slot. One item, infinite energy - no wasting or duplicating.
4. Material Whitelist Validation - On startup and reload, every material listed in config is validated against the server's Material registry. Invalid entries are flagged in console so misconfigurations are caught immediately.

Visual Effects

When a furnace is burning on Infinite Fuel, it emits configurable particle animations and sound effects. This gives players instant visual feedback that their furnace is running on something special - and it looks great in screenshots and streams.

1. Six Particle Animation Styles - SPIRAL (particles coil upward), CIRCLE (ring around the furnace), HELIX (double DNA-like pattern), PULSE (pulsing radius), FOUNTAIN (particles arc upward and fall), STATIC (fixed spawn point, no movement). Animation speed and radius are adjustable.
2. Fully Configurable Particle Type - Choose any vanilla particle: FLAME, SOUL_FIRE_FLAME, SMOKE, ENCHANT, and more. Particle count, spread offset and speed are all tunable.
3. Sound Effects - Optional sound plays when Infinite Fuel begins burning and when each smelt completes. Both events are independently configurable with custom sound name, volume and pitch.
4. Fully Custom Item Appearance — Set the item display name and every line of lore in config using & color codes. Name your item "Eternal Ember", "Dragon's Coal", "VIP Fuel" - whatever fits your server's brand.

Administration and Developer Experience


InfiniteFuel is built for server operators who value clean tooling. Everything is controlled from a single, well-documented config.yml. Commands ship with full tab-completion. Language files are hot-reloadable. Config updates are handled automatically on plugin upgrade with automatic backup of your existing file.

1. /infinitefuel give [amount] - Give Infinite Fuel to any online player. Tab-completion provides player names, material names and amounts. Alias: /ifuel give.
2. /infinitefuel reload - Reloads config.yml and all language files live. No server restart required. Alias: /ifuel reload.
3. /infinitefuel help - Displays all available commands and their syntax in-game.
4. Granular Permission Nodes - infinitefuel.use (default: true), infinitefuel.give (default: op), infinitefuel.reload (default: op), infinitefuel.* for all access. Works with LuckPerms, PermissionsEx and any Vault-compatible permission plugin.
5. Automatic Config Migration - When you install a new plugin version, your old config.yml is automatically backed up and a fresh one is generated. Zero manual migration between updates.
6. Multi-Language Support - Ships with English (en_US) and Polish (pl_PL) out of the box. Every player-facing message is fully translatable via simple YAML language files in plugins/InfiniteFuel/lang/.
7. Debug Mode - Toggle verbose console logging for every furnace interaction, fuel check and speed calculation. Useful during initial setup and troubleshooting.

Most "infinite fuel" implementations on SpigotMC and Modrinth are quick hacks: they spawn a replacement item after consumption, causing a visible flicker and breaking hopper mechanics. Some rely on scheduler timer loops that run every tick and tank TPS on busy servers. A few depend on display name matching that breaks the moment a player renames the item.

InfiniteFuel uses a fundamentally different, modern approach:

1. Event-driven, not timer-driven. The plugin intercepts FurnaceBurnEvent and sets the burn time duration directly. No polling loops, no periodic item restoration, no fake item drops. Performance impact is negligible even on servers with hundreds of active furnaces.
2. PersistentDataContainer (NBT) identification. Items are tagged using the modern Paper NBT API — not display name or lore matching. The tag survives server restarts, chunk reloads, item transfers and anvil renames. A player cannot clone the effect by renaming a normal piece of coal.
3. Adventure API throughout. Zero deprecated Bukkit calls. No setDisplayName(), no setLore(), no legacy chat colour workarounds. Built for Paper 1.21+ from the ground up using the Component and Adventure APIs.
4. Economy-aware design. Every known exploit vector is addressed: crafting abuse, hopper duplication, multi-stack glitches and inventory manipulation are each handled with an explicit, individually configurable guard.
5. No NMS, no reflection, no version-specific code. The plugin uses only stable Paper API surface. There is no NMS access, no reflection hacks and no version-specific compatibility shims that break on every minor update.

Every aspect of InfiniteFuel is controlled from plugins/InfiniteFuel/config.yml. Below is a summary of the available settings. The file ships with inline comments explaining every option.

1. language.locale - Set to en_US or pl_PL (or any custom language file you create).
2. infinite-fuel.enabled — Master switch to enable or disable the entire plugin without uninstalling it.
3. infinite-fuel.prevent-crafting - Block Infinite Fuel from being used in any crafting interface.
4. infinite-fuel.allow-hopper-automation - Allow or deny hoppers from moving Infinite Fuel between containers.
5. infinite-fuel.prevent-multi-stack — Limit the fuel slot to a single Infinite Fuel item at a time.
6. infinite-fuel.allowed-materials - List of material names that can be turned into Infinite Fuel (COAL, CHARCOAL, BLAZE_ROD, LAVA_BUCKET, etc.).
7. infinite-fuel.speed-multiplier - Decimal multiplier for smelting speed. 1.0 = vanilla, 2.0 = double speed.
8. item.name / item.lore - Fully customisable item display name and lore using & color codes. The placeholder {material} inserts the base material name automatically.
9. effects.particles - Particle type, count, offset, speed, animation style (SPIRAL/CIRCLE/HELIX/PULSE/FOUNTAIN/STATIC), animation speed and radius.
10. effects.sounds - Sound name, volume and pitch for burn-start and smelt-complete events. Set to NONE to disable.
11. debug.enabled - Toggle verbose console logging for every furnace interaction.

1. Survival and SMP servers - Reward dedicated players with an item that removes fuel grinding entirely and keeps them engaged with the parts of the game that are actually fun.
2. Economy and Towny servers - List Infinite Fuel in your server shop, add it as a rare mob drop, or bundle it in a donor rank. The configurable material list lets you assign different rarity tiers (Coal vs. Blaze Rod vs. Lava Bucket) to different reward levels.
3. RPG and lore servers - Brand the item with a custom name and lore to fit your world. "Ember of the Forge", "Dragon's Heartstone", "Eternal Ember" - the item looks and behaves however you configure it.
4. Network operators - Zero external dependencies, no NMS, no reflection. Drops into any existing plugin stack without conflict. Permission nodes integrate cleanly with LuckPerms, PermissionsEx and any Vault-compatible system.
5. Minigame and event servers - Use the /ifuel give command to instantly distribute Infinite Fuel as an event reward. The smelting speed multiplier creates a time-limited advantage that feels meaningful.