ItemCraft

<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/2nm-RTGtRRk" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe># ItemCraft – Complete Usage Guide (v1.4.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 ---

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

Opening a Recipe Manually

Command: /ic open <id> Example: /ic open legend_sword Required permission: itemcraft.open ---

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

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

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

Reloading the Plugin

Command: /ic reload This reloads: - config - language files - recipes - bindings - holograms Permission required: itemcraft.reload ---

File Structure

plugins/ItemCraft/ ├── config.yml ├── lang/ ├── recipes/ ├── bindings.yml ├── playerdata.yml └── globaldata.yml Each recipe is stored in its own YAML file. ---

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.