# 📘 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 <id>

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 <id>

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.