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.3	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: "Normal" cost: 0 # This level is always free 1: name: "Enhanced" cost: 100 2: name: "Advanced" cost: 250 3: name: "Epic" cost: 500 4: name: "<dark_purple>Legendary</dark_purple>" cost: 1000

Furnace names and prefix

prefix: "gradient:blue:gray[Furnace Upgrade] |" furnace-name: "Furnace" blast-furnace-name: "Blast Furnace" smoker-name: "Smoker"

Messages

messages: furnace-level-display: "{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
```text
/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