Описание
# 📘 ItemCraft – Complete Usage Guide (v1.4.1)
---
# 1️⃣ Installation
1. Download the .jar file
2. Place it inside:
plugins/
3. Start your server
4. (Optional) Install FancyHolograms for hologram support
Requirements:
- Paper / Spigot 1.21+
- Java 21
---
# 2️⃣ Creating a New Recipe
## Step 1 – Open the Editor GUI
Command:
/ic
Required permission:
itemcraft.editor
---
## Step 2 – Set Ingredients
The GUI looks like a vanilla crafting table:
[ 3x3 Crafting Grid ] → [ Result Slot ]
- Drag items into the 3x3 grid
- You can use custom amounts (e.g., 32 gold in one slot)
- Place the output item in the Result slot
---
## Step 3 – Set Craft Limit
Use the "Max crafts" button:
- Left Click → +1
- Shift + Left → +10
- Right Click → -1
- Shift + Right → -10
Important:
0 = Unlimited crafting
---
## Step 4 – Choose Limit Mode
Use the "Limit Mode" button.
There are 2 modes:
GLOBAL
- Entire server can craft the recipe X times total
- Stored in: globaldata.yml
PER_PLAYER
- Each player can craft the recipe X times individually
- Stored in: playerdata.yml
You can switch modes freely before saving.
---
## Step 5 – Save the Recipe
Click "Save".
You will be prompted to enter a recipe ID in chat.
Example:
legend_sword
The file will be created in:
plugins/ItemCraft/recipes/legend_sword.yml
---
# 3️⃣ Opening a Recipe Manually
Command:
/ic open
Example:
/ic open legend_sword
Required permission:
itemcraft.open
---
# 4️⃣ Binding a Recipe to a Block
## Bind
Look at a block and run:
/ic gan
Example:
/ic gan legend_sword
That block becomes a custom crafting block.
Required permission:
itemcraft.bind
---
## Unbind
Look at the block and run:
/ic removegan
Required permission:
itemcraft.unbind
---
# 5️⃣ Crafting via Block
Once a block is bound:
- Right-click the block
- The custom crafting GUI opens
- The system will:
- Check materials
- Check craft limit
- Remove required items
- Give output
---
# 6️⃣ FancyHolograms Support
If FancyHolograms is installed:
- A hologram is automatically created when binding a block
- /ic reload refreshes holograms
- Can be enabled/disabled in config.yml
Safe fallback:
If FancyHolograms is not installed, plugin works normally without holograms.
---
# 7️⃣ Reloading the Plugin
Command:
/ic reload
This reloads:
- config
- language files
- recipes
- bindings
- holograms
Permission required:
itemcraft.reload
---
# 8️⃣ File Structure
plugins/ItemCraft/
├── config.yml
├── lang/
├── recipes/
├── bindings.yml
├── playerdata.yml
└── globaldata.yml
Each recipe is stored in its own YAML file.
---
# 9️⃣ Permissions
itemcraft.editor
itemcraft.open
itemcraft.bind
itemcraft.unbind
itemcraft.reload
itemcraft.help
---
# 🔒 Security & Protection
The GUI is fully protected:
- No shift-click exploit
- No drag exploit
- No hotbar swap exploit
- No stealing decorative items
- Safe data saving
- Automatic reload handling
---
# 🎯 Example Setup
Recipe:
- 1 Diamond Block
- 32 Gold
- Result: Netherite Ingot
- Max crafts: 50
- Mode: GLOBAL
After saving:
/ic gan legend_block
Now the entire server can craft it only 50 times total.
---
If you need:
- A short summary version
- SEO optimized description
- A professional GitHub README
- A formatted Modrinth wiki page
- A Discord announcement post
Just tell me which one you want.