✨ What is CustomFurnace?

CustomFurnace is a powerful Minecraft plugin designed to take your server's furnaces to the next level! It allows players to upgrade their regular Furnaces, Blast Furnaces, and Smokers to smelt items faster and make fuel last longer. With support for both in-game currency (via Vault) and points (via PlayerPoints), you can offer flexible upgrade paths. A standout feature is the ability to set different maximum upgrade levels for each currency type, giving players more strategic choices!

Core Features for Players & Admins

Here's what makes CustomFurnace awesome:

* Multi-Level Furnace Upgrades
* Upgrade furnaces through multiple levels, each with increasing benefits.
* Configure different maximum upgrade levels for Gold (Vault) and Points (PlayerPoints)!
* **Faster Smelting:** Each level reduces the time (ticks) needed to smelt items. The lower the number, the faster it cooks!
* **Increased Fuel Efficiency:** Higher-level furnaces make your fuel last significantly longer (20% more duration per level beyond level 1).

* Supports All Vanilla Furnace Types
* Works seamlessly with **Furnaces**, **Blast Furnaces**, and **Smokers**.
* Each type can have its own unique upgrade settings and display names.

* ️ Interactive Upgrade GUI
* A clean and intuitive 3x9 GUI for upgrading furnaces.
* Easily choose your payment method:
* **Gold (Vault):** Gold Block button (Slot 11)
* **Points (PlayerPoints):** Diamond Block button (Slot 15)
* See current furnace stats and what they'll become after upgrading.
* The GUI clearly shows different upgrade paths and costs for each payment type.
* Get instant feedback with updated GUI and balance messages upon successful upgrades.

* Dynamic Multi-Language Support
* Switch between **English (en)** and **Chinese (zh)** on the fly!
* Simply change the `language` setting in `config.yml` and use `/furnace reload`.
* All messages, from GUI text to command feedback, are translated.

* Smart Display System
* **Holographic Displays:** See furnace info (level, speed, payment type) floating above placed furnaces (uses ArmorStands, can be toggled).
* **Item Drop Displays:** Dropped custom furnaces also show their info (can be toggled).
* **In-Inventory Lore:** Detailed information directly on the furnace item in your inventory.
* Each upgrade level can have a unique display name.

* Robust Data Saving
* All furnace data is saved automatically (default: every 300 seconds) in `data.yml`.
* Furnaces keep their upgrades and holographic displays even after server restarts.
* Uses UUIDs to ensure each furnace's data is unique and correctly tracked.

* Dual Economy Integration
* Full support for **Vault** (for gold/in-game currency).
* Full support for **PlayerPoints** (for premium currency/points).
* The plugin checks if these economy systems are active and lets you know.
* You can even enable/disable each economy system independently in `config.yml`.


How it Works (The Magic Behind It!)

* **Speed Boost:** When you start smelting, the plugin adjusts the total cook time based on the furnace's level.
* **Fuel Saver:** When fuel is consumed, the plugin extends its burn time based on the furnace's level. For example, a Level 2 furnace makes fuel last 20% longer, Level 3 makes it last 40% longer, and so on!
* **Floating Info:** Special invisible ArmorStands are placed above upgraded furnaces to show their stats. These are non-intrusive and purely for display.


️ Commands
Manage your CustomFurnaces with these easy commands!


Permissions
Control who can do what with these permission nodes.


⚙️ Configuration Highlights

* **Language Switching:**
1. Open `plugins/CustomFurnace/config.yml`.
2. To set English: `language: en`
3. To set Chinese: `language: zh`
4. Save the file and run `/furnace reload` in-game or console.
* **Custom Messages:** Edit `message_en.yml` (English) or `message_zh.yml` (Chinese) to customize any text the plugin shows. You can use color codes (&a, &c, etc.) and variables (%level%, %speed%, etc.).
* **Display Toggles:** You can turn on/off the holographic displays above placed furnaces and the text on dropped furnace items via `config.yml`.
* **Economy Toggles:** Enable or disable Vault and/or PlayerPoints integration in `config.yml`.
* **Detailed Furnace Settings:** `furnaces.yml` allows deep customization of each furnace type, its levels, upgrade costs for both currencies, smelting speeds, and display names per level.


✅ Requirements & Compatibility

* **Server Version:** Paper 1.20.1+ (PaperMC is highly recommended over Spigot for best performance and API features).
* **Java Version:** Java 17 or newer.
* **Required Dependencies:**
* Vault (if using Gold/in-game currency for upgrades)
* PlayerPoints (if using Points for upgrades)