# AuroraCrafting

**AuroraCrafting** is a custom crafting solution for Minecraft servers running PaperMC (and its forks like Purpur and Pufferfish). Folia is also supported as of 1.2.0, but its support is experimental.  ~~This is a paid plugin~~ - not anymore. From the website everyone can download the builds now.

The minimum supported server version is 1.21.4, the plugin as of v2 is only tested above 1.21.4.

## Overview

AuroraCrafting can replace the vanilla crafting table and can be a progressive enhancement for your server. That's your choice to make. Let's see what you can do:

* **It is a full-featured new crafting GUI** that can completely replace the vanilla one. The default configuration looks very similar to the one Hypixel uses on Skyblock.
* You can **create multiple custom workbench GUIs** (in the workbenches folder)
* **Quick crafting slots**. You can lock these slots behind permissions.
  * These slots allow you to look up and craft recipes instantly based on your inventory.
  * It even works with vanilla recipes if enabled (experimental).
* **Vanilla workstations are also supported**, including:
  * Crafting table
  * Smithing table
  * Stonecutter
  * Cauldron
  * Smoker
  * Blast furnace
  * Furnace
  * Campfire
* You can define **amounts for recipe ingredients**. (**also known as stacked ingredients**)
* An integrated smart **recipe book** that is (almost) automatically generated. You can define categories and subcategories as well.
* Commands to directly view the recipes.
* Additionally, you can create **villager shops** using custom items. (You don't need actual villagers or NPCs to open these shops; you just need a command.)
* Remove/disable built-in vanilla recipes. (It also works for other plugin recipes registered in the vanilla way.)

{% hint style="warning" %}
**The main thing you should keep in mind is that this plugin assumes you have at least one item plugin.** Recipes use either just vanilla materials or items from other item plugins (MMOItems, MythicMobs, MythicCrucible, Eco plugins \[eg, EcoItems], ExecutableItems, ExecutableBlocks, Nexo, Oraxen, ItemsAdder, HeadDatabase, CustomFishing, etc).
{% endhint %}

Using item plugins and, therefore, item IDs allows you NOT to change recipes every time you update your items. Recipes will always use the most up-to-date items from your item plugins since you are just using reference IDs in the recipe configs. (For example: `mythicmobs:enchanted_diamond` or `ei:my_executable_item`)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.auroramc.gg/auroracrafting/auroracrafting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.