CraftItem

Use more diverse forging methods to torment delight your players!

Default configurations are in Chinese. Check 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 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. Compatibility code here. Contributions for additional plugin support are welcome!)
• And more… I forgot!

Highly Customizable GUI

See the configuration file: Gui.yml (Github)
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> [Player] 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> [Player] Open the category interface for yourself/another player
• /ci open <RecipeID> [Player] Open the forging interface for yourself/another player
• /ci get <RecipeID> [Player] 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 multiple times until the progress reaches 100% to obtain the final product.

When the final product is obtained, all materials in the player’s inventory are consumed.

Tip
Set the multipliers to 100 100 100 and the success rate to 100, and forging will succeed in one attempt, immediately granting the final product.
(Classic forging logic—since Normal Forging can already achieve this, there’s no need for a separate mode.)

---

2. Time-Based Forging Mode (New in Remastered Version)

Coexists with Normal and Hard Forging modes. Available when Forge Duration is set to a specific time.

In this mode, players must place all required materials in their inventory and click the forge button. After the cost is deducted successfully, forging begins. This time, the plugin will immediately remove all materials from the player’s inventory and record the start time.

Players can view the current forging progress in the menu. Once the elapsed time reaches the configured forge duration, progress reaches 100%, and the player can claim the final product from the forging interface.

---

3. Hard Forging Mode (New in Remastered Version)

Conflicts with Normal Forging. Available when Hard Forging is enabled.

This mode is almost identical to Normal Forging, with only one key difference.

In Hard Forging, before reaching the step:
“Then determine success based on the configured success rate,”
the process is interrupted. The “Clang Clang” title is canceled and replaced with a Custom-Fishing mini-game.

If the mini-game succeeds, the process resumes from the interrupted point and determines forging success.
If the mini-game fails, forging ends immediately and is counted as a failure.

Hard Forging also randomly generates an intensity value, which affects the increase or decrease of forging progress.

The fun part is: even if the mini-game succeeds, forging can still fail, as shown in the last image of this post.
If the mini-game fails, forging will definitely fail.

That’s why it’s called “Hard Forging.”

It’s essentially adding a fairly difficult “CAPTCHA” before Normal Forging begins. If you configure extremely challenging mini-games in the “Random Game Settings,” even humans might struggle to pass.

Tip
Similar to Normal Forging, set both multipliers and success rate to 100, and players only need to complete the mini-game once to obtain the forged item.

Hope you and your players have fun! :)