FurnaceUpgrade Plugin

A plugin that allows players to upgrade furnaces using in-game currency via ExcellentEconomy.

🧩 Version Compatibility

Plugin version	Supported Paper	Java	Dependency
1.3.0	1.20.2 – 26.2	25	ExcellentEconomy
1.2.3	1.20.2 – 1.21.11	21	CoinsEngine

🚀 Features

• Furnace Upgrades: Level up your furnace for money
• Upgrade Effects:
  • Increased smelting speed
  • Reduced fuel consumption
• Support for All Furnace Types: Regular furnaces, blast furnaces, smokers
• Economy Integration: Works with ExcellentEconomy
• Persistent Data: Furnace level is preserved on block break, crafting (furnace to smoker/blast furnace), and moving

Dependencies:

ExcellentEconomy - required (The plugin is tied to economics)

📦 Installation

1. Make sure ExcellentEconomy is installed
2. Download the latest release
3. Place the .jar in the /plugins folder
4. Restart the server
5. Configure the config file and run /furnaceupgrade reload

⚙️ Configuration

Main configuration file config.yml:

# Economy settings
economy:
  currency: "money" # Name of the currency in ExcellentEconomy
  base-cost: 10 # Cost of the first level if cost is not set for the level
  cost-multiplier: 1.5 # How much the cost increases per level if cost is not set

# Speed and fuel consumption multipliers
base-speed-multiplier: 1.0 # Base smelting speed multiplier
speed-multiplier-per-level: 0.5 # Smelting speed increase per level
base-fuel-consumption-multiplier: 1.0 # Base fuel consumption multiplier
fuel-consumption-multiplier-per-level: 0.25 # Fuel consumption reduction per level

# Visual effects
visual:
  upgrade-sound: "minecraft:entity.player.levelup"
  upgrade-effect: "minecraft:happy_villager"

# Upgrades
upgrades:
  0:
    name: "<gray>Normal</gray>"
    cost: 0 # This level is always free
  1:
    name: "<green>Enhanced</green>"
    cost: 100
  2:
    name: "<blue>Advanced</blue>"
    cost: 250
  3:
    name: "<gold>Epic</gold>"
    cost: 500
  4:
    name: "<dark_purple>Legendary</dark_purple>"
    cost: 1000

# Furnace names and prefix
prefix: "<gradient:blue:gray>[Furnace Upgrade] |</gradient>"
furnace-name: "Furnace"
blast-furnace-name: "Blast Furnace"
smoker-name: "Smoker"

# Messages
messages:
  furnace-level-display: "<gray>{furnace} [{level-name}]"
...

🎮 Usage

Upgrading a Furnace

1. Approach a furnace (regular, blast furnace, or smoker)
2. Make sure your hand is empty
3. SHIFT + Right Click - view information about the next level
4. SHIFT + Right Click again within 5 seconds - upgrade the furnace

Commands

/furnaceupgrade info - display info about all upgrade levels
/furnaceupgrade reload - reload the configuration (requires furnaceupgrade.reload)

Permissions

furnaceupgrade.reload - permission to reload the configuration

🔧 Technical Details

Supported Furnace Types

• FURNACE - regular furnace
• BLAST_FURNACE - blast furnace
• SMOKER - smoker

Data Storage

Furnace levels are stored in PersistentDataContainer, which allows:

• Preserving levels on block break
• Restoring levels when placed

Economy

The plugin uses ExcellentEconomy to handle currency. Ensure that:

1. ExcellentEconomy is installed and configured
2. The currency specified in economy.currency exists