FurnacePlus

FurnacePlus

Enhance your Minecraft gameplay with upgraded furnaces!

Overview

FurnacePlus is a Minecraft plugin that allows players to upgrade their furnaces to higher levels, increasing smelting speed and efficiency. With each upgrade, your furnace becomes faster but consumes more fuel, adding a strategic element to resource management. This plugin is perfect for servers looking to enhance the vanilla experience without drastically altering gameplay mechanics.

Features

- Permissions and Commands: Upgrade your furnaces through 5 levels, each providing increased smelting speed. - Permissions and Commands: Increased fuel consumption balances the faster smelting speeds. - Permissions and Commands: All settings, messages, and upgrade requirements are configurable. - Permissions and Commands: Furnaces display their upgrade level when hovered over. - Permissions and Commands: Enjoy sound effects and particle animations upon upgrading. - Permissions and Commands: Includes a reload command for admins to reload configurations on the fly.

Upgrade Levels

| Level | Name | Required Material | Quantity | |-------|------------------|---------------------|----------| | 0 | No Upgrade | N/A | N/A | | 1 | Iron Furnace | Iron Ingot | 16 | | 2 | Gold Furnace | Gold Ingot | 32 | | 3 | Emerald Furnace | Emerald | 16 | | 4 | Diamond Furnace | Diamond | 16 | | 5 | Netherite Furnace| Netherite Ingot | 8 |

- Levels 1-5: Standard furnace behavior. - Levels 1-5: Each level increases smelting speed and fuel consumption.

Installation

1. Reload the plugin from Modrinth. 2. Reload the plugin into your server's `plugins` directory. 3. Reload the plugin to generate the default configuration files. 4. Reload the plugin by editing the `config.yml` file in the `plugins/FurnacePlus` directory as needed. 5. Reload the plugin using `/furnaceplus reload` if you make configuration changes while the server is running.

Configuration

The `config.yml` file allows you to customize:

- Visual effects and sounds per level. - Visual effects and sounds per level. - Visual effects and sounds (materials and quantities). - Visual effects and sounds displayed to players. - Visual effects and sounds upon upgrading.

Example `config.yml`

```yaml

Base smelting speed multiplier

base-speed-multiplier: 1.0

Additional speed per level

speed-multiplier-per-level: 0.5

Base fuel consumption multiplier

base-fuel-consumption-multiplier: 1.0

Additional fuel consumption per level

fuel-consumption-multiplier-per-level: 0.5

Upgrade settings

upgrades: 0: name: "&8No Upgrade" 1: name: "&7Iron Furnace" material: "IRON_INGOT" amount: 16 2: name: "&6Gold Furnace" material: "GOLD_INGOT" amount: 32 3: name: "&aEmerald Furnace" material: "EMERALD" amount: 16 4: name: "&bDiamond Furnace" material: "DIAMOND" amount: 16 5: name: "&cNetherite Furnace" material: "NETHERITE_INGOT" amount: 8

Messages

messages: max_level_reached: "&aYour furnace is already at the maximum level." not_enough_materials: "&cYou don't have enough materials to upgrade." upgrade_successful: "&aYou have upgraded your furnace to: %level_name%." furnace_level_display: "&8Furnace Level: %level_name%" reload_successful: "&aFurnacePlus configuration reloaded successfully." no_permission: "&cYou don't have permission to perform this command."

Visual effects

visual: upgrade_sound: "ENTITY_PLAYER_LEVELUP" upgrade_effect: "VILLAGER_HAPPY" ```

Commands and Permissions

- Permission: `/furnaceplus reload` - Permission: Reloads the plugin configuration. - Permission: `furnaceplus.reload`

How to Use

1. Use the Furnace: Place a standard furnace in the world. 2. Use the Furnace: - Hold the required material in your hand. - Right-click on the furnace. - If you have enough materials, they will be consumed, and the furnace will upgrade. 3. Use the Furnace: Hover over the furnace to see its current level. 4. Use the Furnace: Place fuel and items to smelt as usual. The furnace will operate at increased speed based on its level.

Compatibility

- Server Software: 1.19 - 1.21 - Server Software: Paper, Purpur (requires API that supports `setCookSpeedMultiplier`)

Requirements

- Permissions Plugin: Java 17 or higher - Permissions Plugin (optional): For managing permissions if you wish to restrict command usage.

Known Issues

- Custom Fuels: Increased fuel consumption is implemented by reducing burn time per fuel item. - Custom Fuels: May not correctly adjust fuel consumption for custom fuel items added by other plugins.

Support and Contributions

If you encounter any issues or have suggestions for improvement, please open an issue on the plugin's GitHub repository.

License

This plugin is released under the MIT License.

---

Enhance your Minecraft server with FurnacePlus and give your players a new way to interact with furnaces, adding depth and strategy to their gameplay!