FurnanceUpgrade

# 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: (https://modrinth.com/plugin/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`: ```yaml # 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> |</gradient>" furnace-name: "Furnace" blast-furnace-name: "Blast Furnace" smoker-name: "Smoker" # Messages messages: furnace-level-display: "<gray>{furnace} " ... ``` ## 🎮 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 ```text 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