### Item Configuration Example

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

A comprehensive example of an item configuration in YAML format. This demonstrates how to set the item ID, custom name, lore with variables, enchantments, and item flags.

```yaml
item:
  id: 'DIAMOND_SWORD'
  name: "&4&lSuper Sword"
  lore:
  - "&6This is one of the best"
  - "&6swords on the server!"
  - ""
  - "&8[Created by: &c%player%&8]"
  enchants:
  - 'DAMAGE_ALL;6'
  - 'FIRE_ASPECT;3'
  item_flags:
  - HIDE_ATTRIBUTES
```

--------------------------------

### Inventory Configuration Example

Source: https://ajneb97.gitbook.io/epiccraftingsplus/inventory

Example of an inventory configuration in Inventory.yml, specifying the number of slots, the inventory title, and items within specific slots. This demonstrates how to define a basic inventory structure.

```yaml
Inventories:
  main:
    slots: 45
    title: "&4&lCrafting Inventory"
    21:
      type: category:weapons_armor
      open_inventory: category_weapons_armor
    23:
      type: category:others
      open_inventory: category_others
```

--------------------------------

### Example Category Configuration (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/categories-tutorial

This YAML snippet demonstrates the structure for defining a category in EpicCraftingsPlus. It includes essential properties like permission and item details.

```yaml
'others':
     permission: epiccraftingsplus.categories.others
     item:
       id: 'REDSTONE'
       name: '&dOther Crafts'
       lore:
       - '&7A lot of stuff you can craft,'
       - '&7like money or the &bVIP &7rank.'
```

--------------------------------

### Actions Executed When Crafting Cooldown Starts

Source: https://ajneb97.gitbook.io/epiccraftingsplus/craftings-tutorial

Specifies actions to be executed when a player consumes the required items and the cooldown for the crafting begins. This can be used for various in-game events or commands.

```yaml
actions_when_cooldown_starts:
- "console_command: eco take %player% 1000"
```

--------------------------------

### Set Item Display Name

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Defines a display name for the item, used in messages when the item does not have a custom name. This example shows setting the display name for DIORITE.

```yaml
item:
  id: DIORITE
  display_name: "Diorita"
  amount: 1
```

--------------------------------

### Define Extra Requirements Conditions in YAML

Source: https://ajneb97.gitbook.io/epiccraftingsplus/extra-requirements

This YAML snippet demonstrates how to define multiple conditions for crafting an item. It uses PlaceholderAPI variables to check player level and gamemode. Ensure PlaceholderAPI and relevant expansions are installed for these conditions to function.

```yaml
extra_requirements:
  conditions:
  - "%player_level% >= 15"
  - "%player_gamemode% == SURVIVAL"
```

--------------------------------

### Configure Navigation Items for Category Inventories

Source: https://ajneb97.gitbook.io/epiccraftingsplus/inventory

Sets up 'Previous Page' and 'Next Page' navigation items within category inventories. These items allow players to move between different pages of items within a category. The appearance is configured using item IDs and names, and their functionality depends on the defined slots for preview crafting items.

```yaml
previous_page:
    item:
      id: ARROW
      name: '&7Previous Page'
next_page:
    item:
      id: ARROW
      name: '&7Next Page'
```

--------------------------------

### Configure Craft with Money Item

Source: https://ajneb97.gitbook.io/epiccraftingsplus/inventory

Sets up the 'Craft with Money' item, which appears in the crafting menu when the 'craft with money' option is enabled. Players can click this item to craft using in-game currency, with costs and display names configured.

```yaml
craft_with_money:
    item:
      id: LIME_DYE
      name: '&6&lCraft Using Money'
      lore:
      - '&7Click to craft for &a$%cost%&7.'
```

--------------------------------

### Item Placement in Inventory Slots

Source: https://ajneb97.gitbook.io/epiccraftingsplus/inventory

Demonstrates various formats for placing items within inventory slots in EpicCraftingsPlus. This includes single slots, multiple specific slots, sequential ranges of slots, and combinations of these formats.

```yaml
0:
  item: 
    id: BLACK_STAINED_GLASS_PANE
    name: " "
```

```yaml
0;8;16:
  item: 
    id: BLACK_STAINED_GLASS_PANE
    name: " "
```

```yaml
0-8:
  item: 
    id: BLACK_STAINED_GLASS_PANE
    name: " "
```

```yaml
0-7;9;17-26:
  item: 
    id: BLACK_STAINED_GLASS_PANE
    name: " "
```

--------------------------------

### Configure Preview Crafting Item Display

Source: https://ajneb97.gitbook.io/epiccraftingsplus/inventory

Defines the 'Preview Crafting' item, which represents a crafting recipe in a category inventory. It includes customizable lore for cooldown information, in-cooldown status, ready status, and bypass cooldown options. Clicking this item opens the specific crafting inventory.

```yaml
preview_crafting:
    name: '&eCraft %name%'
    cooldown_info_lore:
    - ''
    - '&9Cooldown: &7%time%'
    in_cooldown_lore:
    - ''
    - '&8[&cThis craft is being created&8]'
    - '&6You need to wait: &7%time%'
    cooldown_ready_lore:
    - ''
    - '&8[&aThis craft is ready to be claimed!&8]'
    - '&6&lCLICK TO GET IT!'
    bypass_cooldown_lore:
    - ''
    - '&c&lRIGHT CLICK to bypass cooldown'
```

--------------------------------

### Configure Navigation Items for Crafting Menus

Source: https://ajneb97.gitbook.io/epiccraftingsplus/inventory

Configures 'Previous Crafting' and 'Next Crafting' items for the crafting menu. These items enable players to navigate through different crafting recipes within the current category. The items are represented by stained glass panes with customizable names.

```yaml
previous_crafting:
    item:
      id: RED_STAINED_GLASS_PANE
      name: '&7« Previous Crafting «'
next_crafting:
    item:
      id: RED_STAINED_GLASS_PANE
      name: '&7» Next Crafting »'
```

--------------------------------

### Configure Book Data (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Sets the title, generation, author, and pages for a written book item. Page content is stored in JSON format and modification is not recommended.

```yaml
book_data:
    title: "Rules Book"
    generation: ORIGINAL
    author: "Ajneb97"
    pages: []
```

--------------------------------

### Configure Click to Craft Item

Source: https://ajneb97.gitbook.io/epiccraftingsplus/inventory

Defines the 'Click to Craft' item, which players use to initiate the crafting process. This item includes customizable lore for success probability and can display extra requirement messages. It is essential for the crafting_menu inventory.

```yaml
click_to_craft:
    item:
      id: CRAFTING_TABLE
      name: '&2&lClick to Craft It!'
    success_probability_lore:
    - ''
    - '&7Probability of Success: &c%chance%%'
```

--------------------------------

### Item Slot Properties Configuration

Source: https://ajneb97.gitbook.io/epiccraftingsplus/inventory

Illustrates how to configure item slot properties within an inventory. This includes defining the item itself, setting an 'open_inventory' action, adding 'click_actions', and using 'not_show_on_blocked_inventories' and 'not_show_on_blocked_craftings' flags.

```yaml
0-9;17;18;26;27;35;36-44:
       item:
         id: "BLACK_STAINED_GLASS_PANE"
         name: " "
```

```yaml
36:
      item:
        id: "ARROW"
        name: "&7Back to Categories"
      open_inventory: main
```

```yaml
36:
       item:
         id: "ARROW"
         name: "&7Go Back to an external Inventory"
       click_actions:
       - "message: %player% &aOpening the main server menu" 
       - "console_command: chestcommands open %player% menu_server"
```

```yaml
36:
      item:
        id: "ARROW"
        name: "&7Back to Categories"
      open_inventory: main
      not_show_on_blocked_inventories: true
```

```yaml
'36':
      item:
        id: ARROW
        name: '&7Go Back'
      open_inventory: previous
      not_show_on_blocked_craftings: true
```

--------------------------------

### Configure Potion Data (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Defines properties for potion items, including effects, duration, level, extension, upgrade status, type, and color. Supports POTION, SPLASH_POTION, LINGERING_POTION, and TIPPED_ARROW item IDs.

```yaml
potion_data:
    # Format for potion effects:
    # <potion_effect>;<level>;<duration_in_ticks>
    effects:
    - INCREASE_DAMAGE;1;4800
    - WATER_BREATHING;0;12000
    extended: false
    upgraded: false
    type: UNCRAFTABLE
    # Color only works on 1.9+, you can get the Minecraft color value here:
    # https://minecraftcommand.science/armor-color
    color: 6196631
```

--------------------------------

### Configure Armor Trim Data (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Specifies the pattern and material for an armor trim smithing template. Requires Minecraft 1.20+ and references Bukkit's TrimPattern and TrimMaterial.

```yaml
trim_data:
    pattern: ward
    material: redstone
```

--------------------------------

### Configure Category Item for Inventory

Source: https://ajneb97.gitbook.io/epiccraftingsplus/inventory

Defines how category items are displayed and interact within the inventory system. These items link to specific categories defined in categories.yml and open the corresponding inventory when clicked. The format `category:<category name>` is used to link to a category.

```yaml
'21':
   type: category:weapons_armor
'23':
   type: category:others
```

--------------------------------

### YAML Configuration Settings for EpicCraftingsPlus

Source: https://ajneb97.gitbook.io/epiccraftingsplus/config

This snippet displays various configuration options for the EpicCraftingsPlus plugin, written in YAML format. These settings control plugin behavior such as data saving intervals, command blocking, crafting visibility, item requirement checks, inventory types, hologram heights, custom block attachments, cooldown notifications, logging policies, economy integration, MiniMessage usage, and default crafting values.

```yaml
# This option defines the time (in seconds) to automatically save 
# plugin data.
data_auto_save_time: 600

# Whether or not to completely block the /ecraft command so you can
# limit players to only craft through crafting places.
block_ecraft_command: false

# If you set this option to true, players that don't have the necessary 
# permission to craft an item, won't see it on the crafting inventory.
hide_craftings_with_permissions: false 

# If you set this option to true, players that have already crafted a
# one time item, won't see it on the crafting inventory anymore. 
hide_one_time_craftings: false

# If you set this option to true, players that don't have the required 
# items to craft an item, won't see it on the crafting menu.
hide_craftings_with_no_requirements: false

# When enabled, required items will be checked, verifying their real 
# name/lore including color codes.
check_for_color_codes_in_required_items: false

# When enabled, craftings items will be drop to the ground if 
# the player has no space on its inventory.
drop_item_when_full_inventory: false

# Defines the main inventory of the plugin. This allows to replace 
# the main inventory with a category inventory instead, so you can use 
# EpicCraftingsPlus with only 1 category. If you want that, you just need
# to specify a category inventory, like: category_weapons_armor
main_inventory_type: main

# Allows to modify the height of the crafting place hologram 
# and fix some height issues.
crafting_place_hologram_height: 1.2

# With this option you can define specific blocks to open the
# main inventory or crafting categories.
block_attach:
  # Whether this option is enabled or not.
  enabled: false
  
  # Blocks that open certain category.
  # Format: <category>: <block_type>
  # All types here:
  # Latest versions: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
  # Legacy versions: https://helpch.at/docs/1.8/org/bukkit/Material.html
  blocks: 
    main: "CRAFTING_TABLE" 
    weapons_armor: "ANVIL"

```

```yaml
# Send notifications when a crafting with cooldown is ready to
# be claimed.
cooldown_notification:
  # Whether to send notifications when a crafting with cooldown
  # finished its cooldown.
  on_ready: true
  
  # Whether to send notifications when the player joins, when a 
  # crafting with cooldown is ready to be claimed.
  on_join: true
  
  # Sound to play to the player when receiving the notification.
  # Follow this format: <sound>;<volume>;<pitch>
  # Latest Sounds: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
  # Legacy Sounds: https://helpch.at/docs/1.8.8/index.html?org/bukkit/Sound.html
  # You can also use resource pack sounds.
  sound: "BLOCK_NOTE_BLOCK_PLING;2;1.5"
  
# Whether or not a player can only be in one cooldown at once.
one_cooldown_at_the_time: false

# After how many days will the information of the log file be removed.
# If is set to 7 it means logs from 7 days old will be removed.
log_file_clear_time: 7

# Whether all new crafting items should be saved as a copy of the original items.
# Equivalent of using /ecraft create <name> original.
new_crafting_default_save_mode_original: true

# Here you can select the economy plugin to use in some cases.
# Possible options: vault, playerpoints
economy:
  # Economy plugin to use when bypassing crafting cooldowns.
  cooldown_bypass: vault
  # Economy plugin to use when crafting with money.
  craft_with_money: vault

# Defines if every message/text in the plugin should use the MiniMessage format.
# Only works on Paper 1.19.4+.
use_minimessage: false

# Here you can define the default options for new craftings. The options 
# you can add here are the same that every crafting can have.
craftings_default_values:
  actions_when_crafted:
  - "firework: colors:YELLOW,RED type:BALL fade:AQUA power:0"
  cooldown: 30
  hide_required_items_flags: true

```

--------------------------------

### Configure Banner Data (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Sets patterns for banner or shield items. Patterns are defined by color and type, referencing Bukkit's DyeColor and PatternType enums.

```yaml
banner_data:
    patterns:
    - BLUE;SQUARE_BOTTOM_LEFT
    - BLUE;SQUARE_TOP_RIGHT
    - LIME;STRAIGHT_CROSS
```

--------------------------------

### Configure Final Crafting Item

Source: https://ajneb97.gitbook.io/epiccraftingsplus/inventory

Sets up the 'Final Crafting' item, which appears within the crafting inventory. This item displays cooldown information if applicable, using a predefined lore format.

```yaml
final_crafting:
    cooldown_info_lore:
    - ''
    - '&9Cooldown: &7%time%'
```

--------------------------------

### Execute Console Command (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/actions

Executes a command from the server console. The '%player%' variable can be used to reference the player's name, and PlaceholderAPI variables are also supported.

```yaml
console_command: lp user %player% parent set vip
```

--------------------------------

### Configure Firework Star Data (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Defines properties for a firework star, including its effect type, colors, and whether it has flicker or trail. References Bukkit's FireworkEffect.Type and color values.

```yaml
# For firework star
firework_data:
    star_effect: BALL;16777215;14188952,4312372;false;false
```

--------------------------------

### Set Item ID

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Defines the base material or type of the item. Links to Spigot and legacy material documentation are provided.

```yaml
id: 'DIAMOND_SWORD'
```

--------------------------------

### Item Slot Type Configuration

Source: https://ajneb97.gitbook.io/epiccraftingsplus/inventory

Shows how to set the 'type' property for an item slot, which replaces the default item with a custom item defined elsewhere, typically in the 'inventory.yml' file under a 'Custom Items' section.

```yaml
19:
       type: final_crafting
```

--------------------------------

### Category Permission Setting (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/categories-tutorial

This YAML snippet illustrates how to set a specific permission node required for players to access a category. If a player lacks this permission, they will be denied entry.

```yaml
permission: epiccraftingsplus.categories.others
```

--------------------------------

### Configure No Required Items Indicator

Source: https://ajneb97.gitbook.io/epiccraftingsplus/inventory

Sets the 'No Required Items' item, which is displayed only when a crafting recipe does not have any required components. This item, typically a barrier, clearly indicates that no specific items are needed to initiate the craft.

```yaml
no_required_items:
    item:
      id: BARRIER
      name: "&cThis crafting doesn''t have required items"
```

--------------------------------

### Configure Cooldown Bypass Confirmation Items

Source: https://ajneb97.gitbook.io/epiccraftingsplus/inventory

Configures the 'Bypass Cooldown' confirmation items ('Yes' and 'No'). These items are used in the `bypass_cooldown_menu` to accept or deny bypassing the crafting cooldown using money.

```yaml
bypass_cooldown_yes:
    item:
      id: GREEN_TERRACOTTA
      name: '&a&lYES'
bypass_cooldown_no:
    item:
      id: RED_TERRACOTTA
      name: '&c&lNO'
```

--------------------------------

### Set Item Enchantments

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Applies enchantments to an item with specified levels. Supports random level ranges. Links to Spigot enchantment documentation are provided.

```yaml
enchants:
  - 'DAMAGE_ALL;6'
  - 'FIRE_ASPECT;3-5'
```

--------------------------------

### Execute Player Command as OP (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/actions

Executes a command as the player with operator privileges. This method is generally not recommended due to potential security risks.

```yaml
player_command_as_op: help
```

--------------------------------

### Crafting Success Rate and Fail Actions

Source: https://ajneb97.gitbook.io/epiccraftingsplus/craftings-tutorial

Introduces a probability of success for crafting. If the player fails, the used items are lost, and actions defined in `fail_actions` are executed. Players can override the chance with permissions like `ecraft.successrate.<crafting>.<chance>`.

```yaml
success_rate:
  chance: 25
  fail_actions:
  - "message: &cThe creation of the &2Magic &dKey &cfailed! The Mystery Vaults can't be opened yet..."
  - "playsound: BLOCK_NOTE_BLOCK_PLING;10;0.1"
```

--------------------------------

### Execute Player Command (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/actions

Executes a command as if the player typed it. Supports PlaceholderAPI variables for dynamic command content.

```yaml
player_command: spawn
```

--------------------------------

### Define Random Crafting Outputs

Source: https://ajneb97.gitbook.io/epiccraftingsplus/craftings-tutorial

Allows a crafting to randomly reward the player with one of several pre-defined craftings upon successful creation. Each random crafting is specified with its name and a probability, which do not need to sum to 100%.

```yaml
random_craftings:
- "super_sword;20"
- "king_helmet;30"
- "epic_bow;50"
```

--------------------------------

### Set Tooltip Style

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Defines the background style for an item's tooltip. Available in Minecraft 1.21.2+, using a namespace:id format.

```yaml
tooltip_style: "custom:ajneb"
```

--------------------------------

### Set Item Amount

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Specifies the quantity of the item in a stack. This is a numerical value.

```yaml
amount: 32
```

--------------------------------

### Configure Firework Rocket Data (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Defines properties for a firework rocket, including its effects, power, and color information. Supports various firework effect types and color values.

```yaml
# For firework rocket
firework_data:
    rocket_effects:
    - BALL_LARGE;11743532,2437522;1973019,15790320;false;true
    power: 1
```

--------------------------------

### Crafting with Money (Requires Vault/PlayerPoints)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/craftings-tutorial

Enables players to purchase items instead of crafting them. This requires the 'craft_with_money' custom item from 'inventories.yml' and the Vault or PlayerPoints plugin. Players need the 'ecraft.use.craftwithmoney' permission.

```yaml
craft_with_money: 5000
```

--------------------------------

### Set Custom Item Name

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Allows for a custom name for the item, supporting color codes, player variables, and random number generation.

```yaml
name: "&aE&bP&cI&dC &6Bow"
```

--------------------------------

### Define Crafting Permission

Source: https://ajneb97.gitbook.io/epiccraftingsplus/craftings-tutorial

Specifies a permission node required for a player to be able to craft the item. If the player lacks this permission, they will be denied access to the crafting recipe.

```yaml
permission: ecraft.supersword
```

--------------------------------

### Specify Required Crafting Materials

Source: https://ajneb97.gitbook.io/epiccraftingsplus/craftings-tutorial

Lists the items required to craft the main item. Each requirement can specify item ID, amount, name, lore, enchantments, and optional properties like 'dont_remove' or 'hide_flags'. This section is vital for defining the input for a crafting recipe.

```yaml
requires:
- 'id:DIAMOND;amount:15;name:&bUnique Diamond;lore:&7A legendary mineral|&7very hard to obtain..'
- 'id:IRON_INGOT;amount:10'
- 'id:CHEST;amount:5;dont_remove'
```

```yaml
requires:
- 'id:DIAMOND_SWORD;amount:1;hide_flags'
```

--------------------------------

### Actions Executed Upon Successful Crafting

Source: https://ajneb97.gitbook.io/epiccraftingsplus/craftings-tutorial

Defines a list of actions to be performed when a player successfully crafts an item. These actions can include broadcasting messages, executing console commands, or triggering firework effects. The `[count_as_item]` prefix can be used to require an empty inventory slot.

```yaml
actions_when_crafted:
- "console_command: broadcast &2&l%player% crafted a &4&lSUPER SWORD&2&l!"
- "firework: colors:YELLOW,RED type:BALL fade:AQUA power:0"
```

```yaml
actions_when_crafted:
- "[count_as_item]console_command: complexturrets give Burst_Turret %player%"
```

--------------------------------

### Enable One-Time Crafting

Source: https://ajneb97.gitbook.io/epiccraftingsplus/craftings-tutorial

If set to true, allows a player to craft the item only once. This is useful for unique or limited-availability items within the game.

```yaml
one_time: true
```

--------------------------------

### Set Custom Item Lore

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Adds a custom description (lore) to the item. Supports color codes, player variables, and random number generation similar to the item name.

```yaml
lore:
  - "&6This is one of the best"
  - "&6swords on the server!"
  - ""
  - "&8[Created by: &c%player%&8]"
```

--------------------------------

### Configurable Item Creation in EpicCraftingsPlus (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/commands-and-permissions

Demonstrates the YAML structure for a crafted item saved with the 'configurable' parameter. This format allows for manual modification of item properties directly in the configuration file.

```yaml
item:
  id: PLAYER_HEAD
  name: '&eEmoticon Derp'
  amount: 1
  durability: 3
  nbt:
  - Skulls:ID|534
  skull_data:
    texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHBzOi8vdGV4dHVyZXMubWluZWNyYWZ0Lm5ldC90ZXh0dXJlLzNiYWFiZTcyNGVhZTU5YzVkMTNmNDQyYzdkYzVkMmIxYzZiNzBjMmY4MzM2NGE0ODhjZTU5NzNhZTgwYjRjMyJ9fX0=
    id: 069a79f4-44e9-4726-a5be-fca90e38aaf5
    owner: '' 
```

--------------------------------

### Configure NBT Data (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Adds custom NBT data to an item. This is intended for advanced users and manual modification is discouraged. Supports specific data types like booleans. Functionality is limited to Minecraft versions 1.8-1.20.4.

```yaml
nbt:
  - Unbreakable|true|boolean
```

--------------------------------

### Send Title and Subtitle (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/actions

Sends a title and subtitle to the player with customizable fade-in, stay, and fade-out durations in ticks. 'none' can be used for title or subtitle if only one is desired.

```yaml
title: 20;40;20;&6&lCRAFTED AN EPIC SWORD;none
```

--------------------------------

### Define Inventory GUIs with YAML

Source: https://ajneb97.gitbook.io/epiccraftingsplus/default-files/inventory

This YAML configuration defines various inventory menus for a Minecraft plugin. It specifies the layout, titles, and behaviors of items within each inventory slot, enabling features like item categories, crafting progression, and confirmation dialogues.

```yaml
Inventories:
  main:
    slots: 45
    title: "&4&lCrafting Inventory"
    21:
      type: category:weapons_armor
    23:
      type: category:others
  crafting_menu:
     slots: 45
     title: "&4&lCraft your Item"
     0-9;11;17;18;20;26;27;29;35;36-44:
       item:
         id: "BLACK_STAINED_GLASS_PANE"
         name: " "
     36:
       item:
         id: "ARROW"
         name: "&7Go Back"
       open_inventory: previous
       not_show_on_blocked_craftings: true
     19:
       type: final_crafting
     18:
       type: previous_crafting
       not_show_on_blocked_craftings: true
     20:
       type: next_crafting
       not_show_on_blocked_craftings: true
     41:
       type: click_to_craft
     42:
       type: craft_with_money
     12-16;21-25;30-34:
       type: required_item
     23:
       type: no_required_items
  category_weapons_armor:
    slots: 45
    title: "&4&lWeapons and Armor &8%current_page%/%total_pages%"
    0-9;17;18;26;27;35;36-44:
       item:
         id: "BLACK_STAINED_GLASS_PANE"
         name: " "
    36:
      item:
        id: "ARROW"
        name: "&7Back to Categories"
      open_inventory: main
      not_show_on_blocked_inventories: true
    43:
      type: previous_page
    44:
      type: next_page
    10-16;19-25;28-34:
      type: preview_crafting
  category_others:
    slots: 45
    title: "&4&lOthers &8%current_page%/%total_pages%"
    0-9;17;18;26;27;35;36-44:
       item:
         id: "BLACK_STAINED_GLASS_PANE"
         name: " "
    36:
      item:
        id: "ARROW"
        name: "&7Back to Categories"
      open_inventory: main
      not_show_on_blocked_inventories: true
    43:
      type: previous_page
    44:
      type: next_page
    10-16;19-25;28-34:
      type: preview_crafting
  bypass_cooldown_menu:
    slots: 27
    title: "&4&lBypass Cooldown"
    13:
      item:
        id: "HOPPER"
        name: "&a&lAre you sure?"
        lore:
        - "&7Are you sure you want to bypass the"
        - "&ccooldown &7of: &a%crafting_name% &7?"
        - '&7This will cost you: &2$%bypass_cost%'
    10:
      type: bypass_cooldown_yes
    16:
      type: bypass_cooldown_no
CustomItems:
  previous_page:
    item:
      id: "ARROW"
      name: "&7Previous Page"
  next_page:
    item:
      id: "ARROW"
      name: "&7Next Page"
  previous_crafting:
    item:
      id: "RED_STAINED_GLASS_PANE"
      name: "&7« Previous Crafting «"
  next_crafting:
    item:
      id: "RED_STAINED_GLASS_PANE"
      name: "&7» Next Crafting »"
  final_crafting:
    cooldown_info_lore:
    - ""
    - "&9Cooldown: &7%time%"
  preview_crafting:
    name: "&eCraft %name%"
    cooldown_info_lore:
    - ""
    - "&9Cooldown: &7%time%"
    in_cooldown_lore:
    - ""
    - "&8[&cThis craft is being created&8]"
    - "&6You need to wait: &7%time%"
    cooldown_ready_lore:
    - ""
    - "&8[&aThis craft is ready to be claimed!&8]"
    - "&6&lCLICK TO GET IT!"
    bypass_cooldown_lore:
    - ""
    - "&c&lRIGHT CLICK to bypass cooldown"
  required_item:
    status_lore:
    - ""
    - "&6You need this to craft the item"
    - "&8Status: %current_items%&8/%total_items%"
    no_items_status_color: "&c"
    some_items_status_color: "&e"
    all_items_status_color: "&a"
    not_removed_lore:
    - ""
    - "&8[&7This item will NOT be removed!&8]"
  no_required_items:
    item:
      id: BARRIER
      name: "&cThis crafting doesn't have required items"
  click_to_craft:
    item:
      id: CRAFTING_TABLE
      name: "&2&lClick to Craft It!"
    success_probability_lore:
    - ""
    - "&7Probability of Success: &c%chance%%"
  craft_with_money:
    item:
      id: LIME_DYE
      name: "&6&lCraft Using Money"
      lore:
      - "&7Click to craft for &a$%cost%&7."
  bypass_cooldown_yes:
    item:
      id: GREEN_TERRACOTTA
      name: "&a&lYES"
  bypass_cooldown_no:
    item:
      id: RED_TERRACOTTA
      name: "&c&lNO"

```

--------------------------------

### Configure Saving Original Item

Source: https://ajneb97.gitbook.io/epiccraftingsplus/craftings-tutorial

Determines if the crafted item should be an exact copy of the original item used in the crafting recipe. This option is typically managed automatically by the `/ecraft create <name> original` command.

```yaml
save_original_item: false
```

--------------------------------

### Category Item Definition (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/categories-tutorial

This YAML snippet shows how to define the item that represents a category. It utilizes standard item properties such as ID, name, and lore, which can be further customized.

```yaml
item:
       id: 'REDSTONE'
       name: '&dOther Crafts'
       lore:
       - '&7A lot of stuff you can craft,'
       - '&7like money or the &bVIP &7rank.'
```

--------------------------------

### Original Item Creation in EpicCraftingsPlus (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/commands-and-permissions

Illustrates the YAML structure for a crafted item saved with the 'original' parameter. This saves an exact copy of the item, preserving all properties and internal data, but prevents manual editing and PlaceholderAPI usage.

```yaml
item:
  original:
      ==: org.bukkit.inventory.ItemStack
      v: 3700
      type: PLAYER_HEAD
      meta:
        ==: ItemMeta
        meta-type: SKULL
        display-name: '{"text":"","extra":[{"text":"Emoticon Derp","obfuscated":false,"italic":false,"underlined":false,"strikethrough":false,"color":"yellow","bold":false}]}'
        Damage: 3
        internal: H4sIAAAAAAAA/+NiYOBg4AzOLs3JKbbydGFgNjU2YQAAOpvx+xUAAAA=
        skull-owner:
          ==: PlayerProfile
          uniqueId: 069a79f4-44e9-4726-a5be-fca90e38aaf5
          properties:
          - name: textures
            value: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHBzOi8vdGV4dHVyZXMubWluZWNyYWZ0Lm5ldC90ZXh0dXJlLzNiYWFiZTcyNGVhZTU5YzVkMTNmNDQyYzdkYzVkMmIxYzZiNzBjMmY4MzM2NGE0ODhjZTU5NzNhZTgwYjRjMyJ9fX0= 
```

--------------------------------

### Set Skull Texture and ID (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Configures a player head item with a specific texture and a unique ID. The texture is provided as a base64 encoded string, and the ID can be a UUID.

```yaml
skull_data:
    texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOTA4Yjc3MmVjYWVlNzA2MjM1ZDFhZGJmMGI5YTI5YjU4YmE5YzBlZDYwZGU2ZjEwZWZiMWE3Zjg2ZDllIn19fQ=="
    id: "ec62ea75-402c-44fb-8f71-bef0015a4634"
```

--------------------------------

### Ignore Properties of Required Items

Source: https://ajneb97.gitbook.io/epiccraftingsplus/craftings-tutorial

Allows players to craft items even if certain properties of the required items do not match exactly. Options include ignoring names, data values, lore, enchantments, and custom model data.

```yaml
ignore_required_items_name: true
ignore_required_items_datavalue: true
ignore_required_items_lore: true
ignore_required_items_enchants: true
ignore_required_items_custom_model_data: true
```

--------------------------------

### Configure Crafting Cooldown

Source: https://ajneb97.gitbook.io/epiccraftingsplus/craftings-tutorial

Sets a cooldown period in seconds before a player can craft the item again. Players with specific permissions or operator status can bypass this cooldown. Essential for balancing item acquisition.

```yaml
cooldown: 7200
```

--------------------------------

### Set Item Flags

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Hides specific item properties, such as enchantments or attributes, from being displayed. Links to Spigot ItemFlag documentation are provided.

```yaml
item_flags:
  - HIDE_ATTRIBUTES
```

--------------------------------

### Assign Crafting to a Category

Source: https://ajneb97.gitbook.io/epiccraftingsplus/craftings-tutorial

Assigns the crafting recipe to a specific category. The category name must exist in the `categories.yml` file. This helps in organizing and managing multiple crafting recipes.

```yaml
category: weapons_armor
```

--------------------------------

### Custom Permission Error Actions (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/categories-tutorial

This YAML snippet defines custom actions to be executed when a player attempts to open a category without the necessary permissions. These actions can include sending messages and playing sounds.

```yaml
actions:
       permission_error:
         - "message: &cThis category will be unlocked while you progress..."
         - "playsound: BLOCK_NOTE_BLOCK_PLING;10;0.1"
```

--------------------------------

### Play Sound Effect (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/actions

Plays a specified sound effect to the player with adjustable volume and pitch. Links to Spigot Javadocs are provided for sound lists.

```yaml
playsound: BLOCK_NOTE_BLOCK_PLING;10;0.1
```

--------------------------------

### Configure Required Item Status Lore

Source: https://ajneb97.gitbook.io/epiccraftingsplus/inventory

Defines the lore for 'Required Item' entries in the crafting menu, indicating the status of required components. It shows the current count versus the total needed and uses different colors to represent the status (none, some, or all items acquired). It also includes an option to specify if the item is not removed after crafting.

```yaml
required_item:
    status_lore:
    - ''
    - '&6You need this to craft the item'
    - '&8Status: %current_items%&8/%total_items%'
    no_items_status_color: '&c'
    some_items_status_color: '&e'
    all_items_status_color: '&a'
    not_removed_lore:
    - ''
    - '&8[&7This item will NOT be removed!&8]'
```

--------------------------------

### Set Item Attributes

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Modifies item attributes like health or speed. Requires careful configuration including attribute name, operation, value, UUID, and slot. Links to relevant Spigot documentation are provided.

```yaml
attributes:
  - GENERIC_MAX_HEALTH;ADD_SCALAR;0.1;1ab87334-7a32-4307-b783-c5519f735260;HAND
  - GENERIC_MOVEMENT_SPEED;ADD_SCALAR;0.35;766d5332-e2b1-493d-af98-5d3046da3f0a;HAND
```

--------------------------------

### Play Resource Pack Sound Effect (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/actions

Plays a custom sound effect from a resource pack to the player, using the same format as the standard 'playsound' action.

```yaml
playsound_resource_pack: scorpions:custom.my_custom_sound;10;1
```

--------------------------------

### Set Item Durability

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Specifies the durability or data value for an item. This is a simple integer value.

```yaml
durability: 5
```

--------------------------------

### Handle Pre-Craft Event in Java

Source: https://ajneb97.gitbook.io/epiccraftingsplus/api

This event is triggered just before a player attempts to craft an item. It allows access to the player and the crafting recipe details, enabling modifications or cancellations before material deduction.

```java
// Event called when player is trying to craft an item.
@EventHandler
public void preCraftEvent(EpicCraftingsPreCraftEvent event){
  Player player = event.getPlayer();
  Crafting crafting = event.getCrafting();
}
```

--------------------------------

### Set Item Model

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Applies a custom model to an item, affecting its appearance in-game. Available from Minecraft 1.21.4+, using a namespace:id format.

```yaml
model: "custom:model_1"
```

--------------------------------

### Set Crafting Priority

Source: https://ajneb97.gitbook.io/epiccraftingsplus/craftings-tutorial

Determines the order in which craftings are displayed or processed if multiple recipes match. A higher number indicates a lower priority (placed later). This is useful for managing overlapping crafting recipes.

```yaml
priority: 4
```

--------------------------------

### Define 'OR' Conditions in YAML

Source: https://ajneb97.gitbook.io/epiccraftingsplus/extra-requirements

This YAML snippet shows how to implement 'OR' logic within extra requirements. A crafting attempt will succeed if either the player's level is 20 or above, OR if the player is an operator. This allows for more flexible crafting conditions.

```yaml
extra_requirements:
  conditions:
  - "%player_level% >= 20 or %player_is_op% == yes"
```

--------------------------------

### Set Skull Owner to Player (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Configures a player head item to use the texture of the player who is crafting it, utilizing the %player% variable.

```yaml
skull_data:
    owner: %player%
```

--------------------------------

### Set Leather Armor Color

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Applies a specific color to leather armor items using an RGB integer value.

```yaml
color: 8439583
```

--------------------------------

### YAML Messages Configuration for EpicCraftings+

Source: https://ajneb97.gitbook.io/epiccraftingsplus/default-files/messages

This YAML configuration file defines all the messages displayed to players by the EpicCraftings+ plugin. It includes prefixes, command feedback, error messages, inventory titles, and more. Customization is achieved by modifying the string values associated with each key.

```yaml
prefix: '&2[&a&lEpicCraftings&9&l+&2] '
configReloaded: '&aConfig reloaded.'
commandCreateError: '&cYou need to use: &7/ecraft create <name>'
commandEditError: '&cYou need to use: &7/ecraft edit <name>'
commandDeleteError: '&cYou need to use: &7/ecraft delete <name>'
commandGiveError: '&cYou need to use: &7/ecraft give <player> <name>'
commandPermissionsError: '&cYou don''t have permissions.'
mustHaveItemInHand: '&cYou must have an item in your hand!'
craftingAlreadyExists: '&cA crafting named &7%name% &calready exists!'
craftingDoesNotExists: '&cThe crafting &7%name% &cdoesn''t exists!'
craftError: '&cYou don''t have the sufficient amount of items to craft this!'
craftSuccessful: '&bYou have successfully created x%amount% %name%&b!'
craftWithMoneySuccessful: '&bYou have successfully created x%amount% %name%&b paying
  &a$%money%&b!'
createCraftingInventoryTitle: '&4&lCreating Crafting'
createCraftingInventoryInfoCategoryName: '&4&lSELECT A CATEGORY'
createCraftingInventoryInfoCategoryLore:
- '&7Click on a category to add the'
- '&e%name% &7crafting.'
createCraftingInventoryInfoRequiredItemsName: '&4&lADD REQUIRED ITEMS'
createCraftingInventoryInfoRequiredItemsLore:
- '&7Drag and place the required items of'
- '&7this crafting.'
createCraftingInventoryCreateName: '&4&lCREATE CRAFTING'
createCraftingInventoryCreateLore:
- '&7Click to create!'
noRequiredItems: '&cYou must add at least one required item!'
craftingCreationFailed: '&cCrafting creation failed!'
craftingCreated: '&aCrafting &e%name% &acreated! You can modify its properties on
  the &7%name%.yml &aconfig file.'
craftingDeleted: '&aCrafting &e%name% &adeleted!'
extraRequirementsMessageStatusSymbolTrue: '&a&l✔'
extraRequirementsMessageStatusSymbolFalse: '&c&l✖'
craftErrorExtraRequirements: '&cYou dont''t have the necessary requirements to craft
this!'
craftErrorNoPermissions: '&cYou don''t have permissions to craft this.'
craftWithMoneyNoMoney: '&cYou don''t have the sufficient amount of money to craft
this item!'
craftOneTimeError: '&cYou''ve already crafted this item. You can''t do it again!'
errorPlayerNotOnline: '&cThat player is not online!'
craftGive: '&aYou gave: &7%name% &ato &e%player%&a!'
craftReceived: '&aYou have received: &7x%amount% %name%&a!'
craftNoLeftSpaceError: '&cYou don''t have sufficient space in your inventory to craft
this!'
timeSeconds: s
timeMinutes: m
timeHours: h
timeDays: d
craftCooldownCreated: '&bGood! Now you need to wait &7%time% &buntil %name% &bis created!'
craftCooldownFinishMessage: '&7%name% &bcrafting has finished creating! You can reclaim
it now.'
craftCooldownError: '&cThis crafting is in cooldown, you can''t craft it again!'
craftCooldownBypassedMessage: '&8[&aCooldown Bypassed&8]'
categoryOpenErrorNoPermissions: '&cYou don''t have permissions to open this category!'
categoryDoesNotExists: '&cThe category &7%name% &cdoesn''t exists!'
notLookingBlock: '&cYou must be looking at a block.'
craftingPlaceAlreadyExists: '&cA crafting place in that location already exists!'
craftingPlaceAdded: '&aCrafting Place added!'
craftingPlaceCategoryAdded: '&aCrafting Place for category &7%name% &aadded!'
craftingPlaceHologram:
- '&4&n-&c&lCRAFTING PLACE&4&n-'
- '&8[&eRight Click to Craft&8]'
craftingPlaceCategoryHologram:
- '&4&n-&c&lCRAFTING PLACE&4&n-'
- '&7[%category_alias%&7]'
- '&8[&eRight Click to Craft&8]'
craftingPlaceNotLookingError: '&cYou must be looking at a crafting place.'
craftingPlaceRemoved: '&aCrafting Place removed!'
craftingPlaceRemoveError: '&cTo remove this crafting place, use &7/ecraft removeplace
&clooking at block.'
ecraftCommandBlocked: '&cThat command is blocked!'
cooldownOneAtTheTimeError: '&cYou can''t craft another item because you are crafting
one already.'
craftCooldownBypassedWithMoneyMessage: '&bCooldown Bypassed! Cost: &a$%cost%'
craftCooldownBypassNoMoney: '&cYou don''t have the sufficient amount of money to bypass
the cooldown of this item!'
pluginDisabledError: '&cThe plugin has detected some errors. Check them and fix them
using &7/ecraft verify'

```

--------------------------------

### Spawn Firework (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/actions

Spawns a firework at the player's location with specified colors, type, fade colors, and power. Links to Spigot Javadocs for colors and types are provided.

```yaml
firework: colors:YELLOW,RED type:BALL fade:AQUA power:0
```

--------------------------------

### Set Cooldown Bypass Cost

Source: https://ajneb97.gitbook.io/epiccraftingsplus/craftings-tutorial

Allows players to bypass the crafting cooldown by spending in-game currency, requiring Vault or PlayerPoints integration. Players interact with a specific menu to initiate the bypass.

```yaml
cooldown_bypass_cost: 5000
```

--------------------------------

### Set Custom Model Component Data

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Configures advanced custom model data for Minecraft 1.21.4 and later. It supports lists of strings, flags, floats, and colors.

```yaml
custom_model_component_data:
  strings:
  - "string1"
  flags:
  - "flag1"
  - "flag2"
  floats: []
  colors: []
```

--------------------------------

### Hide Item Tooltip

Source: https://ajneb97.gitbook.io/epiccraftingsplus/items-tutorial

Controls whether the item's tooltip (description) is visible. This feature is available from Minecraft version 1.20.6 onwards.

```yaml
hide_tooltip: true
```

--------------------------------

### Send Message (YAML)

Source: https://ajneb97.gitbook.io/epiccraftingsplus/actions

Sends a plain text message to the player. Supports PlaceholderAPI variables. If 'use_minimessage' is enabled in config, MiniMessage formatting can be used.

```yaml
message: &fHello there
```

```yaml
message: <white>Hello there
```