# How to Start

## Requirements

**1) Spigot**

{% hint style="warning" %}
You need Spigot or Paper for the plugin to work. Don't use Craftbukkit.
{% endhint %}

## **Optional Dependencies**

**1) Vault or PlayerPoints**

{% hint style="info" %}
If you want players to bypass cooldowns or craft items using money, you need one of the following:\
**Vault + Economy plugin:** <https://www.spigotmc.org/resources/vault.34315/>\
**PlayerPoints:** <https://www.spigotmc.org/resources/playerpoints.80745/>
{% endhint %}

**2) PlaceholderAPI**

{% hint style="info" %}
If you want to add extra requirements, you will need PlaceholderAPI for all the variables: <https://www.spigotmc.org/resources/placeholderapi.6245/>
{% endhint %}

**3) Holographic Displays, Decent Holograms, FancyHolograms**

{% hint style="info" %}
If you want to create holograms above crafting places you will need one of these plugins:\
Holographic Displays: <https://dev.bukkit.org/projects/holographic-displays>\
Decent Holograms: <https://www.spigotmc.org/resources/96927/>\
FancyHolograms: <https://modrinth.com/plugin/fancyholograms>
{% endhint %}

## Installation and first steps

To install the plugin on your server place the EpicCraftingsPlus plugin inside your plugins folder and start your server.

Inmediately you can use the `/ecraft` command to access the main inventory in which you will find 2 categories; Weapons/Armors and Others craftings. Each crafting is one file, and you can find them in the `craftings` folder. To create a new crafting do the following:

1. Use the `/ecraft create <name>` command while holding an item in your hand. This item will be the final crafting.

\
\
You can also use the `/ecraft create <name> original` command, to save an EXACT/ORIGINAL COPY of the item into the config. This prevents some complex items from other plugins to broke when giving them again to the player. Click [**HERE**](https://ajneb97.gitbook.io/epiccraftingsplus/commands-and-permissions#crafting-creation-with-original-parameter) to know more.

{% hint style="info" %}
By default, crafting items are saved grabbing all of their ORIGINAL DATA, an exact copy of the original item. This prevents some complex items from other plugins to broke when giving them again to the player. Click [**HERE** ](https://ajneb97.gitbook.io/epiccraftingsplus/commands-and-permissions#crafting-creation-with-original-and-configurable-parameters)to know more. This can also be achieved using the `/ecraft create <name> original` command.

If you want to be able to modify crafting items on the configuration file, you must use the `/ecraft create <name> configurable` command instead. This however will not save all item data.
{% endhint %}

1. The crafting is now created but you must set some basic configurations. An edit inventory will be opened. Here you can set a category for this crafting and its required items.
2. What you can do now is to configure many of the new crafting properties in the generated file inside the `craftings` folder. Click [**HERE**](https://ajneb97.gitbook.io/epiccraftingsplus/craftings-tutorial) to read about these options.
3. If you want to modify crafting priorities easy, I recommend you to use the `/ecraft editall` command to do so. This will open the main editing inventory.


---

# 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://ajneb97.gitbook.io/epiccraftingsplus/how-to-start.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.
