Fuel Master v1.5

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.



◆ 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

• 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.

◆ Commands


◆ Permissions