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