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 - 🚀 **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:** ```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&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