FurnacesPlus

🔥 FurnacePlus

Advanced furnace speed enhancement plugin for Minecraft Paper servers

FurnacePlus is a powerful plugin that provides players with permission-based furnace smelting speed increases. The plugin offers server administrators maximum control through real-time permission updates and flexible configuration options.

---

✨ Features

- 🚀 Debug Mode: Flexible permission system with `furnaceenhanced.<number>` format - ⚡ Debug Mode: Fast furnace smelting with visible progress - 🔄 Debug Mode: Permission changes take effect immediately - ⚙️ Debug Mode: Detailed config file for complete control - 📊 Debug Mode: Active furnace count and performance tracking - 🛠️ Debug Mode: Reload and information display commands - 🎯 Debug Mode: Low resource usage and high performance - 🔧 Debug Mode: Detailed logging system for developers

---

📥 Installation

1. Check Requirements: - Java 17+ - Paper 1.20+ server - Maven (for compilation)

2. Compile the Plugin: ```bash mvn clean package ```

3. Upload JAR File to Server: - Copy `target/furnaceplus-1.0.0.jar` to your server's `plugins` folder

4. Start Server: - The plugin will automatically create config files when the server starts

---

🔑 Permission System

Permission Format

``` furnaceenhanced.<value> ```

Value Examples:

- `furnaceenhanced.30` → 30% speed increase - `furnaceenhanced.50` → 50% speed increase - `furnaceenhanced.90` → 90% speed increase

Priority System:

- If a player has multiple permissions, the highest value takes effect - Example: If player has `furnaceenhanced.20` and `furnaceenhanced.50`, 50% speed increase applies

Admin Permission:

- `furnaceplus.admin` → Access to plugin commands

---

🎮 Commands

| Command | Description | Permission | |---------|-------------|-----------| | `/furnaceplus help` | Display help menu | `furnaceplus.admin` | | `/furnaceplus reload` | Reload plugin configuration | `furnaceplus.admin` | | `/furnaceplus info` | Show plugin information | `furnaceplus.admin` | | `/furnaceplus stats` | Show furnace statistics | `furnaceplus.admin` |

Alternative: `/fp` shortcut can be used

---

⚙️ Configuration

config.yml

```yaml

Plugin Settings

plugin: debug: false # Enable debug messages prefix: "&8[&6FurnacePlus&8]&r" # Plugin prefix

Furnace Enhancement Settings

furnace: enabled: true # System enabled/disabled max-speed-increase: 90 # Maximum speed increase % update-interval: 2 # Update interval (ticks) real-time-updates: true # Real-time permission updates

Permission Settings

permissions: prefix: "furnaceenhanced." # Permission prefix default-value: 0 # Default speed value

Messages (Color codes supported)

messages: plugin-reloaded: "&aFurnacePlus successfully reloaded!" no-permission: "&cYou don't have permission to use this command!" furnace-enhanced: "&aYour furnace cooking speed: &e{speed}%" error-occurred: "&cAn error occurred while processing your request!" invalid-command: "&cInvalid command usage! Use: /furnaceplus reload" ```

---

📋 Usage Examples

1. Basic Permission Assignment

```bash

Give player 30% speed increase

/lp user player permission set furnaceenhanced.30 true

Give group 50% speed increase

/lp group vip permission set furnaceenhanced.50 true ```

2. Multiple Permission Management

```bash

Multiple speed permissions (highest value takes effect)

/lp user player permission set furnaceenhanced.20 true /lp user player permission set furnaceenhanced.50 true # This will be effective ```

4. Server Group Examples

```bash

Membership levels

/lp group member permission set furnaceenhanced.10 true # Member: 10% speed /lp group premium permission set furnaceenhanced.30 true # Premium: 30% speed /lp group vip permission set furnaceenhanced.50 true # VIP: 50% speed /lp group mvp permission set furnaceenhanced.75 true # MVP: 75% speed ```

---

🔧 Advanced Settings

Update Interval Optimization

```yaml furnace: update-interval: 10 # Default (recommended)

5 = More responsive, higher CPU usage

20 = Lower CPU, less responsive

```

Debug Mode

```yaml plugin: debug: true # Prints detailed logs to console ```

Speed Limits

```yaml furnace: max-speed-increase: 90 # No speed increase above 90% ```

---

🚨 Troubleshooting

🔍 Common Issues

Problem: Plugin not loading

Solution: - Ensure you're using Java 17+ - Use Paper 1.20+ server - Check console errors

Problem: Permissions not working

Solution: - Check permission format is correct: `furnaceenhanced.<positive_number>` - Only positive numbers are supported for speed increases - Ensure permission plugin like LuckPerms is active - Check settings with `/furnaceplus info`

Problem: Furnace speed not changing

Solution: - Check `furnace.enabled: true` in config - Try placing new items in furnace - Enable debug mode and check console logs

Problem: Performance issues

Solution: - Increase `update-interval` value (e.g., 20) - Set `real-time-updates: false` - Disable unnecessary debug mode

📊 Debug Information

To enable debug mode: ```yaml plugin: debug: true ```

This will print the following to console: - Player furnace interactions - Permission check results - Speed calculation details - Performance metrics

---

📈 Performance Tips

1. Disable Real-time Updates if Not Needed: Very low values increase CPU usage 2. Disable Real-time Updates if Not Needed: Remove unused permissions 3. Disable Real-time Updates if Not Needed: Only use during testing 4. Disable Real-time Updates if Not Needed: Provides performance gains