Fuel Master v1.5

The last fuel your furnaces will ever need.


FuelMaster
Every Furnace Has a Story. Every Fuel Has a Purpose.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Paper 1.21+ Unlimited Fuel Types Charge System Smelt Bonuses PAPI + bStats

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

What FuelMaster Solves


Furnace management on most servers is an afterthought. Players stockpile coal instead of exploring. Auto-smelt farms grind to a halt the moment the hopper runs dry. Donor perks amount to a generic "speed boost" that feels like a server setting, not a reward.

FuelMaster fixes that. Every fuel type you define has its own charge pool, smelting speed, XP bonus, double-output chance, custom smelting outputs, a potion aura that affects nearby players, and conditional bonuses gated by biome, time or weather. Define an infinite Eternal Ember that burns forever. Design a Blaze Coal that grants Fire Resistance and extra XP but runs out after 500 smelts. Create an Alchemical Core that turns iron into gold when the moon is up and it is raining. These are not stat tweaks. They are gameplay decisions.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Core Mechanics

Every fuel type has access to the full system below. All values per-type All values in config


Fuel Type System
  • Unlimited named types defined in config.yml, each with its own material and properties
  • Per-type charges: set -1 for infinite, any positive integer for finite fuel that depletes
  • Per-type speed multiplier: 1.0 = vanilla, 2.0 = 2x faster, independent per fuel
  • Per-type CustomModelData: assign a unique CMD per fuel for resource pack integration
  • Lore placeholders {current}, {max}, {speed} update in real time as charges change
  • Load-time validation: materials, particle types, potion effects and sounds checked at startup


Charge System & Refill
  • Finite fuels consume one charge per smelt operation with live lore updates
  • Refill items: click a configured material (e.g. BLAZE_ROD) on the fuel slot to restore all charges
  • Auto-refuel: on depletion, pulls a matching fuel from a nearby player inventory automatically
  • Cooldown system prevents inventory spam with 1-charge fuel types
  • Low charge warnings at threshold, half-threshold, and every 5 below 10 charges
  • Configurable depletion sound. Default: BLOCK_FIRE_EXTINGUISH


Smelting Bonuses
  • XP per smelt: grant bonus experience when items are extracted from the furnace
  • Double output chance: configurable probability to double the result. Overflow drops naturally
  • Custom outputs: define { input → output, chance } rules that override smelt results
  • Potion aura: periodically applies a potion effect to players within a radius of the furnace
  • Conditional gating: restrict bonuses by biome, time of day (DAY/NIGHT), or weather (CLEAR/RAIN/THUNDER)


Visual Effects
  • Per-type particle effects with independent type, animation style, speed and radius
  • 6 animation styles: SPIRAL, CIRCLE, HELIX, PULSE, FOUNTAIN, STATIC
  • Particle proximity culling: only spawn when players are within 32 blocks
  • Glow furnace outline: coloured enchant-style glow on furnaces using FuelMaster fuel
  • Configurable glow colour: YELLOW, RED, GREEN, BLUE, AQUA, WHITE, GOLD, PURPLE, GRAY
  • Sound effects on burn start and smelt complete, independent per event


Action Bar Display
  • Real-time fuel name, current charges and max charges when looking at a furnace
  • Event-driven: PlayerMoveEvent marks players for refresh, AFK players polled less
  • Configurable ray distance and update tick interval


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

How FuelMaster Compares


FeatureFuelMasterTypical Fuel Plugin
Fuel typesUnlimited named types, per-type configSingle item or hardcoded list
Charge systemPer-type charges, refill items, auto-refuelInfinite only, no depletion
Smelt bonusesXP, double output, custom outputs, potion aura, conditionsSpeed multiplier only
Item identificationPDC (NBT) - survives rename, restart, chunk reloadDisplay name or lore matching (brittle)
PerformanceEvent-driven, no server ticks consumed, proximity cullingScheduler loops every tick
Exploit protectionCrafting, hopper, multi-stack, explosion, chunk unload - all guardedNo guards or drill-down per case
Visual feedbackPer-type particles, glow outline, action bar, soundsNone or basic particles


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Who This Is For


  • Survival and SMP servers Remove fuel grinding entirely with infinite fuels. Reward dedicated players with rare fuel types that give real gameplay advantages.
  • Economy and Towny servers Sell finite fuel types in your server shop. Bundle infinite fuels in donor ranks. The charge system creates natural consumable demand.
  • RPG and lore servers Brand every fuel with custom names, lore and particle identity. Build quests around rare fuel types with unique smelting outputs.
  • Network operators Drop FuelMaster into any Paper 1.21+ server. Zero dependencies. Full reload support. bStats metrics. Multi-language out of the box.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Technical Specs


ServerPaper 1.21 - 1.21.x, Java 21+
DependenciesNone. PlaceholderAPI and bStats are optional.
Item IDPersistentDataContainer (NBT) - not display name or lore
APIAdventure Components throughout. Zero deprecated Bukkit calls.
Languagesen_US, pl_PL. Add any locale by dropping a file into lang/.
AnalyticsbStats, optional, toggle in config


Commands

CommandAliasDescriptionPermission
/fuelmaster help/fm helpShows help menu-
/fuelmaster give [amount]/fm giveGive a fuel item to a playerfuelmaster.give
/fuelmaster reload/fm reloadReload config + lang livefuelmaster.reload
/fuelmaster types/fm typesList fuel types with statsfuelmaster.types
/fuelmaster recipes/fm recipesOpen interactive fuel catalog GUIfuelmaster.recipes


Permissions

PermissionDescriptionDefault
fuelmaster.*Access to all FuelMaster featuresop
fuelmaster.useAllows using FuelMaster fuels in furnacestrue
fuelmaster.use.Per-type fuel access (auto-refuel gate)true
fuelmaster.giveGive fuel items via commandop
fuelmaster.reloadReload plugin configurationop
fuelmaster.typesList fuel typestrue
fuelmaster.recipesBrowse fuel catalog GUItrue


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Get FuelMaster

Your players are still feeding furnaces with coal.
That is time they could spend on your server.


Unlimited fuel types. Per-type charges, bonuses and particles. One plugin.

Download. Drop in plugins. Configure. Ship.

Formerly InfiniteFuel. Questions? Ask in our Discord. Feedback welcomed.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Product Info
Statistics
7

Views

0

Purchases

0

Downloads

128.95 KB

File size

16.07.2026

Published

15.07.2026

Updated

Info
Supported software
Supported Versions
1.21 - 1.21.11
Share & Earn

Share and earn part of the profits, an estimated €0.3 per product sale.

Log in to get your link
Product Image
Fuel Master
Fuel Master