CraftItem Remastered

# CraftItem Use more diverse forging methods to ~~torment~~ delight your players! > Default configurations are in Chinese. Check (https://github.com/mcio-dev/localization) repository for English or other language. ## Features **Why Choose This Remastered Version** + **Feature-Rich**: The original plugin already consumed a lot of players’ time and kept them on edge. We’ve added a more challenging Custom-Fishing mini-game forging mode, as well as a time-based forging mode that only requires patience. It’s more feature-complete than the original. + **Stable Operation**: This plugin has been running on the author’s server for nearly two years, and the version with the new forging modes has been running for almost a year without issues. It’s also one of the signature plugins of the author’s server. Bug fixes are guaranteed when problems arise. + **Bug Fixes**: The original plugin’s code was a mess. Starting from `2.0.0`, we refactored a large portion of the codebase using the (https://github.com/MrXiaoM/PluginBase/) framework, greatly improving development efficiency. In this remastered version, we also fixed serious bugs such as **materials not being consumed when held in the off-hand**. + **Developer-Friendly**: The plugin remains open-source, and the remastered version adds developer-friendly events such as `MaterialDisappearEvent`. By canceling this event, you can prevent valuable materials from being destroyed when a player encounters a major failure. Of course, the new version also includes configuration options to prevent destruction, which should satisfy most use cases. + **Plugin Integration**: Supports basic integration with economy and placeholder plugins. It also supports integration with plugins such as MMOItems, identifying materials by specific plugin item IDs instead of the full item data! (Currently supports MMOItems, MythicMobs, ItemsAdder, etc. (https://github.com/MrXiaoM/CraftItem/blob/25c410403b621ad1fc2020141851f24a7578c714/src/main/java/cn/jrmcdp/craftitem/func/MaterialAdapterManager.java#L42-L51). Contributions for additional plugin support are welcome!) + And more… I forgot! ## Highly Customizable GUI See the configuration file: (https://github.com/MrXiaoM/CraftItem/blob/main/src/main/resources/Gui.yml) Freely edit icon positions, add CustomModelData for custom textures, execute commands on click, use PAPI variables in commands, and more. ## Commands / Permissions Each subcommand corresponds to the permission `craftitem.command.<subcommand>`, such as `craftitem.command.open`. Generally, players do not need any permissions. You can use a menu plugin and execute the console command `ci open <RecipeID> ` to open the forging interface for a player. In the following commands, `<>` indicates required parameters and `` indicates optional parameters. Do not include the brackets when typing commands. + `/ci category <Category> ` Open the category interface for yourself/another player + `/ci open <RecipeID> ` Open the forging interface for yourself/another player + `/ci get <RecipeID> ` Give the forging reward to yourself/another player + `/ci create <RecipeID>` Create a forging recipe + `/ci delete <RecipeID>` Delete a forging recipe + `/ci edit <RecipeID>` Edit a forging recipe + `/ci reload` Reload configuration files If `Setting.RequirePermission` is enabled (enabled by default), opening a forging interface also requires the permission `craftitem.open.<RecipeID>`. --- ## Mode Description This plugin has three forging modes. Understanding how each mode works will help you use the plugin more flexibly. --- **1. Normal Forging Mode** Conflicts with Hard Forging. Available when `Hard Forging` is **disabled**. In this mode, players must place all required materials in their inventory, then click the forge button. After the cost is deducted successfully, forging begins. Each attempt deducts the fee but does not consume materials immediately. However, there is a situation where materials may be deducted after forging ends—see below. First, the plugin randomly generates an intensity value: `Small`, `Medium`, or `Large`, corresponding to three multipliers set in the recipe configuration. A “Clang Clang” / “Forging” title is displayed for a period of time. Then, the plugin determines success based on the configured success rate. If **successful**, depending on the intensity, it may be `Minor Success`, `Success`, or `Major Success`, increasing the forging progress by the corresponding multiplier. If **failed**, it may be `Minor Failure`, `Failure`, or `Major Failure`, decreasing the forging progress accordingly. If the intensity is **Major Failure**, the player will **randomly lose one material**. This is the most torturous—and exciting—part of the original plugin. In this mode, forging **cannot** produce the final item in one attempt. Players must **forge multip