ItemCraft

📘 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.