Forging999

## Features ### Core Features - **Time-Based Forging** - Recipes take real time to complete, continuing even when offline - **Progressive Leveling** - Unlock more forge slots and time bonuses as you level up - **Multiple Forge Slots** - Up to 5 concurrent forging slots (unlocked through leveling) - **Fuel System** - Lava-based fuel system required to power the forge - **Custom Recipes** - Fully configurable recipes via config or in-game commands - **Category Organization** - Organize recipes into custom categories - **Progress Tracking** - Visual progress bars and time remaining displays - **Auto-Claim Notification** - Players are notified when items are ready ### Integration Features - **ItemsAdder Support** - Full compatibility with ItemsAdder custom items - **Custom Model Data** - Support for resource pack custom model data - **Persistent Data** - All progress saved and persists through restarts ### Quality of Life - **Batch Claiming** - Claim all completed items at once - **Ingredient Checking** - Visual feedback showing if you have required materials - **Time Formatting** - Human-readable time displays (1h 30m 45s) - **Tab Completion** - Full tab completion for all commands - **Hot Reload** - Reload configuration without server restart --- ## Installation 1. Download the Forging999 plugin JAR file 2. Place it in your server's `plugins` folder 3. Start or restart your server 4. The plugin will generate default configuration files 5. (Optional) Install ItemsAdder for custom item support --- ## Commands ### Player Commands | Command | Description | |---------|-------------| | `/forge` | Opens the main forge GUI | | `/forge help` | Displays the help menu with all available commands | ### Admin Commands | Command | Description | |---------|-------------| | `/forge reload` | Reloads the plugin configuration | | `/forge settime <player> <seconds>` | Sets a player's total forging time | | `/forge setlevel <player> <level>` | Sets a player's forge level (1-5) | ### Recipe Management Commands | Command | Description | |---------|-------------| | `/forge recipe add <category> <item> <lava_cost> <time> <materials>` | Adds a new recipe | | `/forge recipe remove <category> <recipe_name>` | Removes a recipe from a category | | `/forge recipe list` | Lists all recipe categories | | `/forge recipe list <category>` | Lists all recipes in a specific category | ### Category Management Commands | Command | Description | |---------|-------------| | `/forge category add <name> ` | Creates a new recipe category | | `/forge category remove <name>` | Deletes a recipe category | | `/forge category list` | Lists all available categories | ### Recipe Add Command Detailed Usage /forge recipe add <category> <hand|item_id> <lava_cost> <forge_time> <materials> **Parameters:** - `category` - The category to add the recipe to (must exist) - `hand|item_id` - Use "hand" to use held item, or specify item ID - `lava_cost` - Fuel cost in millibuckets (mb) - `forge_time` - Time in seconds or formatted (1h, 30m, 1h30m) - `materials` - Required ingredients (comma-separated) **Examples:** /forge recipe add ores hand 500 3600 RAW_IRON:1 /forge recipe add parts DIAMOND_SWORD 800 1h30m DIAMOND:2,STICK:1 /forge recipe add custom ia:myitems:sword 600 2h IRON_INGOT:4,DIAMOND:2 --- ## Permissions | Permission | Description | Default | |------------|-------------|---------| | `forging999.use` | Allows access to the forge GUI | All players | | `forging999.admin` | Allows access to admin commands | Operators | --- ## Forge System ### Main Interface The forge interface is a 54-slot GUI containing: - **Forge Slots (5 max)** - Central slots where forging takes place - **Timer Display** - Shows remaining time for each active recipe - **Fuel Indicator** - Displays current lava fuel amount - **Upgrade Button** - Shows level progress and upgrade requirements - **Recipe Browser** - Access to all available recipes by category - **Claim Button** - Quickly claim all completed items ### Forge Slot States 1. **Locked** - Slot not yet unlocked (requires higher forge level) 2. **Empty** - Available for a new recipe 3. **Active** - Currently forging (shows progress bar and time remaining) 4. **Complete** - Ready to claim (highlighted with completion indicator) ### Forging Process 1. Click an empty forge slot 2. Select a recipe category 3. Choose a recipe (must have ingredients and fuel) 4. Ingredients and fuel are consumed 5. Wait for the timer to complete 6. Claim your forged item --- ## Leveling System ### Overview The forge leveling system rewards players for using the forge. As players spend more time forging, they unlock additional slots and time reduction bonuses. ### Level Progression | Level | Forge Slots | Time Reduction | Required Forging Time | |-------|-------------|----------------|----------------------| | 1 | 1 slot | 0% | Starting level | | 2 | 2 slots | 10% | 20 minutes total | | 3 | 3 slots | 2