⚡ CustomCraftPlus — Expanded Crafting for Paper 1.21+

Create custom 3x3, 4x4, 5x5, and 6x6 crafting recipes right inside your server using interactive in-game GUIs! No more messy YAML or base64 item strings.

---

🌟 Why CustomCraftPlus?

Standard Minecraft restricts crafting to a simple 3x3 grid. Whether you are running an RPG server, a Skyblock server, or a Custom Survival SMP, your end-game items deserve legendary crafting formulas.

CustomCraftPlus breaks past the vanilla limits by introducing fully functional 4x4, 5x5, and 6x6 crafting tables directly into Paper 1.21+, combined with an ultra-friendly In-Game Recipe Creator GUI that lets you create and save recipes with a single click.

---

🔥 Key Features

📐 1. Four Crafting Grid Sizes

• 3x3 (9 slots): Standard crafting grid. Recipes created here can optionally also be crafted inside vanilla crafting tables (register-vanilla-3x3: true).
• 4x4 (16 slots): Advanced 4x4 crafting grid inside a spacious double-chest GUI.
• 5x5 (25 slots): Master 5x5 crafting grid inside a spacious double-chest GUI.
• 6x6 (36 slots): Legendary 6x6 crafting grid utilizing the full 36-slot area inside a double-chest GUI.
• Size Selector Menu: If a player runs /craft without arguments, an interactive menu allows them to choose which grid size to open!

🎨 2. Interactive In-Game Recipe Creator (/ccraft create)

Say goodbye to complicated YAML configuration errors, broken NBT strings, and external web generators:

1. Run /ccraft create <recipe_id> <3|4|5|6>.
2. Place your exact ingredient items inside the crafting grid slots. Fully supports custom display names, lore, enchantments, CustomModelData, and NBT (PersistentDataContainer) tags!
3. Place your desired result item into the output slot.
4. Click the interactive buttons at the bottom right to toggle Shapeless vs. Shaped crafting and Exact NBT Matching.
5. Click Save & Register Recipe — your recipe is immediately active across the server and saved cleanly to recipes.yml!

🧰 3. Portable Crafting Benches (/ccraft bench)

Want to give your players a portable end-game crafting tool?

• Run /ccraft bench <player> <size> to give them a custom Portable Crafting Bench item (3x3, 4x4, 5x5, or 6x6).
• When right-clicked anywhere in the world, the item opens the corresponding custom crafting grid instantly!
• Secured with Bukkit PersistentDataContainer tags so players cannot rename ordinary items to cheat.

🌍 4. Immersive World Block Triggers

Want custom crafting tables placed right inside your survival world without typing commands? In config.yml, you can bind standard Minecraft blocks so when players right-click them, they open your expanded crafting menus:

block-triggers:
  enabled: true
  require-sneak: false  # Shift + Right Click optional
  blocks:
    FLETCHING_TABLE: "FOUR_BY_FOUR"
    SMITHING_TABLE: "FIVE_BY_FIVE"
    ENCHANTING_TABLE: "SIX_BY_SIX"

🧠 5. Smart Crafting Engine & Protection

• Centered / Offset Pattern Matching: When crafting a shaped recipe smaller than the open grid (such as a 3x3 recipe inside a 5x5 table), the algorithm dynamically calculates bounding boxes. Players can place the recipe in the center or corner and it will craft flawlessly!
• Shift-Crafting Support: Automatically calculates the maximum crafts available based on ingredients and inventory space, depositing items directly to the player's inventory.
• Item Return Protection: If a player closes the crafting GUI (ESC or E) with ingredients still inside the grid, all items are safely returned to their inventory or dropped on the ground so nothing is ever lost.
• Interactive Recipe Book (/ccraft list): Players can browse paginated menus of all registered custom recipes and click any item to preview its exact crafting grid layout!

---

📋 Commands & Permissions

Command	Aliases	Description	Permission	Default
/craft [size]	/bench, /megacraft, /ecraft	Opens the size selector menu or a specific grid size (3, 4, 5, 6).	ccraft.use ccraft.craft.3 ccraft.craft.4 ccraft.craft.5 ccraft.craft.6	true true true true true
/ccraft list	/recipes, /ccp	Opens the Recipe Browser / Recipe Book GUI.	ccraft.use	true
/ccraft create <id> <size>		Opens the interactive Recipe Creator GUI for size (3, 4, 5, or 6).	ccraft.admin	op
/ccraft bench <player> <size>	/ccraft givebench	Gives a portable crafting item (3, 4, 5, or 6) to a player.	ccraft.admin	op
/ccraft delete <id>		Deletes the specified custom recipe from memory and recipes.yml.	ccraft.admin	op
/ccraft reload		Reloads config.yml and recipes.yml without restarting the server.	ccraft.admin	op
/ccraft give <player> <id> [amt]		Gives the result item of recipe <id> directly to a player.	ccraft.admin	op

---

🛠️ Installation & Compatibility

1. Download CustomCraftPlus-1.0.0.jar and place it inside your server's plugins/ folder.
2. Ensure your server is running Paper 1.21 or newer (or forks like Purpur/Folia) on Java 21.
3. Restart or reload your server. Configuration files will automatically generate in plugins/CustomCraftPlus/.

---

❓ Frequently Asked Questions (FAQ)

Q: Does this require any client-side mods?
A: No! CustomCraftPlus runs 100% server-side using standard Minecraft chest GUIs, item data, and sound effects. Players joining with vanilla clients on 1.21+ can use all features immediately.

Q: Can I use custom items from other plugins (like MythicMobs, ItemsAdder, Oraxen, or MMOItems) as ingredients or results?
A: Yes! When you use the /ccraft create GUI, CustomCraftPlus clones exact ItemStack metadata including NBT tags, CustomModelData, display names, and lore. Anything you drop into the creator slot is exactly what the recipe requires and outputs.

Q: Can I disable vanilla 3x3 table integration?
A: Yes! Simply set register-vanilla-3x3: false inside config.yml and run /ccraft reload.

---

💖 Support & Contributing

If you enjoy CustomCraftPlus, please leave a review and report any thing on dc