🔥 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

• 🚀 Permission-Based Speed Control: Flexible permission system with furnaceenhanced.<number> format
• ⚡ Speed Increase Support: Fast furnace smelting with visible progress
• 🔄 Real-Time Updates: Permission changes take effect immediately
• ⚙️ Flexible Configuration: Detailed config file for complete control
• 📊 Statistics System: Active furnace count and performance tracking
• 🛠️ Admin Commands: Reload and information display commands
• 🎯 Optimization: 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:

   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

# 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

# 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

# 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

# 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

furnace:
  update-interval: 10  # Default (recommended)
  # 5  = More responsive, higher CPU usage
  # 20 = Lower CPU, less responsive

Debug Mode

plugin:
  debug: true  # Prints detailed logs to console

Speed Limits

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:

plugin:
  debug: true

This will print the following to console:

• Player furnace interactions
• Permission check results
• Speed calculation details
• Performance metrics

---

📈 Performance Tips

1. Optimize Update Interval: Very low values increase CPU usage
2. Clean Unused Permissions: Remove unused permissions
3. Disable Debug in Production: Only use during testing
4. Disable Real-time Updates if Not Needed: Provides performance gains