### Example Rarity Configuration Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/additional-configuration-options/item-rarity.md This is a complete example of a rarity configuration file. It defines the lore tag, weight for tie-breaking, and a list of items that should inherit this rarity. ```yaml # === Lore: the tag shown on the item === lore: - "&a&lCOMMON" # One lore line per entry, added to the item # === Weight: tie-breaking === weight: 1 # Higher weight wins when an item matches multiple rarities # === Items: what gets this rarity === items: # Items from the Item Lookup System; EcoItems should set rarity in their own config instead - diamond ``` -------------------------------- ### Example Recipe Configuration Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/additional-configuration-options/additional-recipes.md This YAML snippet defines a shaped crafting recipe. It specifies the resulting item and amount, an optional permission node, and the ingredients arranged in a 3x3 grid. ```yaml # === Result: what you get === result: ecoitems:enchanted_emerald 9 # The item to give, with an optional amount # === Permission: who can craft it === permission: "ecoitems.craft.enchanted_emerald_block_craft" # Optional; permission required to craft this recipe # === Recipe: the crafting grid === shapeless: false # Optional; whether the recipe is shapeless, defaults to false recipe: # Ingredients: https://plugins.auxilor.io/the-item-lookup-system/recipes - "" - emerald_block 32 - "" - emerald_block 32 - emerald_block 32 - emerald_block 32 - "" - emerald_block 32 - "" ``` -------------------------------- ### Custom Tool Configuration Example Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/how-to-make-a-custom-item/custom-tools.md This YAML configuration defines a custom tool with base item properties and specific mining behavior. It includes default mining speed, durability cost per block, and rules for different block types or tags. ```yaml # === Item: a normal EcoItem === item: item: netherite_pickaxe glint max_damage:4096 item_name:"Hardened Netherite Pickaxe" # The base item lore: [] # The item lore craftable: true # If the item can be crafted crafting-permission: ecoitems.craft.custom_item # Optional; permission required to craft the item recipe-give-amount: 1 # Optional; how many items the recipe gives, defaults to 1 recipe: # The recipe: https://plugins.auxilor.io/the-item-lookup-system/recipes - netherite_ingot - netherite_ingot - netherite_ingot - netherite_ingot - netherite_pickaxe - netherite_ingot - netherite_ingot - netherite_ingot - netherite_ingot # === Tool: the mining behaviour === tool: mining-speed: 1.0 # Default mining speed, used when no rule matches damage-per-block: 1 # Durability removed each time a block is mined rules: # Optional; per-block overrides, first match wins - blocks: - "#mineable_pickaxe" # Block names or tags; tags start with # speed: 45.8 # Mining speed for these blocks - blocks: - "#incorrect_for_netherite_tool" speed: 1 drops: false # Optional; if mined blocks drop items with this tool ``` -------------------------------- ### Item Effects and Conditions Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/how-to-make-a-custom-item/how-to-make-a-custom-item.md Implement item functionality by defining effects that run on specific triggers and conditions that must be met for the effects to activate. This example shows a damage multiplier effect triggered by a melee attack, only active in the Nether. ```yaml effects: - id: damage_multiplier args: multiplier: 1.5 triggers: - melee_attack conditions: - id: in_world args: world: world_the_nether ``` -------------------------------- ### Add EcoItems Dependency Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/api.md Configure your build.gradle.kts to include the Auxilor repository and add EcoItems as a compileOnly dependency. Replace with the desired EcoItems version. ```kotlin repositories { maven("https://repo.auxilor.io/repository/maven-public/") } dependencies { compileOnly("com.willfp:EcoItems:") } ``` -------------------------------- ### Item Section Configuration Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/how-to-make-a-custom-item/how-to-make-a-custom-item.md Configures the base item, display name, lore, and crafting recipe for a custom item. Ensure the 'item' field points to a valid base item ID. ```yaml item: item: iron_sword hide_attributes # The base item: https://plugins.auxilor.io/the-item-lookup-system display-name: "Mithril Sword" # The item display name lore: # The item lore, one entry per line - "&7Damage: &c12❤" - "&8» &#f953c6Deal 50% more damage in the nether" craftable: true # If the item can be crafted crafting-permission: ecoitems.craft.custom_item # Optional; permission required to craft the item shapeless: false # Optional; whether the recipe is shapeless, defaults to false recipe-give-amount: 1 # Optional; how many items the recipe gives, defaults to 1 recipe: # The recipe: https://plugins.auxilor.io/the-item-lookup-system/recipes - "" - ecoitems:mithril 2 - "" - "" - ecoitems:mithril 2 - "" - "" - stick - "" ``` -------------------------------- ### Crafting Permission Configuration Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/additional-configuration-options/additional-recipes.md An optional configuration to restrict recipe usage. Players must have the specified permission node to craft the item. ```yaml permission: "ecoitems.craft.enchanted_emerald_block_craft" # Optional; permission required to craft this recipe ``` -------------------------------- ### Result Item Configuration Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/additional-configuration-options/additional-recipes.md Defines the item produced by a recipe. Specify the item ID and an optional quantity, separated by a space. ```yaml result: ecoitems:enchanted_emerald 9 # The item to give, with an optional amount ``` -------------------------------- ### Tool Section Configuration Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/how-to-make-a-custom-item/custom-tools.md Defines the mining behavior for a custom tool, including default speed, durability cost, and specific rules for block mining. Use this section to customize how the tool interacts with different blocks. ```yaml tool: mining-speed: 1.0 # Default mining speed, used when no rule matches damage-per-block: 1 # Durability removed each time a block is mined rules: # Optional; per-block overrides, first match wins - blocks: - "#mineable_pickaxe" # Block names or tags; tags start with # speed: 45.8 # Mining speed for these blocks - blocks: - "#incorrect_for_netherite_tool" speed: 1 drops: false # Optional; if mined blocks drop items with this tool ``` -------------------------------- ### Custom Item Configuration Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/how-to-make-a-custom-item/how-to-make-a-custom-item.md Defines a custom item with its display name, lore, crafting recipe, and effects. Use this structure to create your own unique items. ```yaml item: item: iron_sword hide_attributes # The base item: https://plugins.auxilor.io/the-item-lookup-system display-name: "Mithril Sword" # The item display name lore: # The item lore, one entry per line - "&7Damage: &c12❤" - "&7Attack Speed: &c1.5" - "" - "MITHRIL BONUS" - "&8» &#f953c6Deal 50% more damage in the nether" craftable: true # If the item can be crafted crafting-permission: ecoitems.craft.custom_item # Optional; permission required to craft the item shapeless: false # Optional; whether the recipe is shapeless, defaults to false recipe-give-amount: 1 # Optional; how many items the recipe gives, defaults to 1 recipe: # The recipe: https://plugins.auxilor.io/the-item-lookup-system/recipes - "" - ecoitems:mithril 2 - "" - "" - ecoitems:mithril 2 - "" - "" - stick - "" # === Attributes: how it behaves === slot: mainhand # The slot the item must be in to activate; defaults to mainhand rarity: rare # Optional; the item rarity from the rarities folder base-damage: 12 # Optional; the item base damage base-attack-speed: 1.5 # Optional; the item base attack speed base-attack-range: 3.0 # Optional; entity interaction range, vanilla default 3.0 # === Effects: what it does === effects: - id: damage_multiplier # The effect to run args: multiplier: 1.5 triggers: - melee_attack # When the effect fires conditions: - id: in_world # A condition that must hold for the effects to run args: world: world_the_nether ``` -------------------------------- ### Shaped and Shapeless Recipe Grid Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/additional-configuration-options/additional-recipes.md Configures the crafting grid for a recipe. Set `shapeless: true` to ignore ingredient positions. Empty slots are represented by `""`. ```yaml shapeless: false # Optional; whether the recipe is shapeless, defaults to false recipe: # Ingredients: https://plugins.auxilor.io/the-item-lookup-system/recipes - "" - emerald_block 32 - "" - emerald_block 32 - emerald_block 32 - emerald_block 32 - "" - emerald_block 32 - "" ``` -------------------------------- ### Default Plugin Configuration Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/plugin-config.md This is the default `config.yml` file for the EcoItems plugin. It controls whether recipes are automatically discovered and the settings for the rarity system. ```yaml discover-recipes: true rarity: enabled: false blank-lore-line: true default: common display-default: true ``` -------------------------------- ### Weight Configuration Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/additional-configuration-options/item-rarity.md Sets the weight for a rarity, used to break ties when an item matches multiple rarities. A higher weight takes precedence. ```yaml weight: 1 # Higher weight wins when an item matches multiple rarities ``` -------------------------------- ### Lore Configuration Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/additional-configuration-options/item-rarity.md Defines the lore tag that will be appended to items of this rarity. Each entry is a separate line of lore and supports color codes. ```yaml lore: - "&a&lCOMMON" # One lore line per entry, added to the item ``` -------------------------------- ### Full Custom Food Item Structure Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/how-to-make-a-custom-item/custom-foods.md This YAML configuration defines a custom food item, including its base item properties and specific food behaviors like nutrition and potion effects. Ensure all fields are correctly set for the item to function as intended. ```yaml # === Item: a normal EcoItem === item: item: cooked_beef glint item_name:"Enchanted Steak" # The base item lore: [] # The item lore craftable: true # If the item can be crafted crafting-permission: ecoitems.craft.custom_item # Optional; permission required to craft the item recipe-give-amount: 1 # Optional; how many items the recipe gives, defaults to 1 recipe: # The recipe: https://plugins.auxilor.io/the-item-lookup-system/recipes - "" - cooked_beef 64 - "" - cooked_beef 64 - cooked_beef 64 - cooked_beef 64 - "" - cooked_beef 64 - "" # === Food: the eating behaviour === food: nutrition: 12 # Hunger restored: https://minecraft.wiki/w/Hunger saturation: 2 # Saturation restored eat-seconds: 1 # Time in seconds it takes to eat can-always-eat: false # Optional; if it can be eaten on a full hunger bar effects: # Optional; potion effects granted on eating - effect: regeneration # The potion effect ID duration: 40 # Duration in ticks level: 1 # The effect level ambient: true # Optional; if the potion is ambient, defaults to true particles: true # Optional; if the potion shows particles, defaults to true icon: true # Optional; if the potion icon shows, defaults to true probability: 100 # Optional; chance the effect is applied, defaults to 100 ``` -------------------------------- ### Food Section Configuration Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/how-to-make-a-custom-item/custom-foods.md This YAML snippet details the 'food' section for a custom EcoItem, specifying how the item behaves when eaten. Adjust nutrition, saturation, and eat time to balance your food item. ```yaml food: nutrition: 12 # Hunger restored: https://minecraft.wiki/w/Hunger saturation: 2 # Saturation restored eat-seconds: 1 # Time in seconds it takes to eat can-always-eat: false # Optional; if it can be eaten on a full hunger bar effects: # Optional; potion effects granted on eating - effect: regeneration # The potion effect ID duration: 40 # Duration in ticks level: 1 # The effect level ambient: true # Optional; if the potion is ambient, defaults to true particles: true # Optional; if the potion shows particles, defaults to true icon: true # Optional; if the potion icon shows, defaults to true probability: 100 # Optional; chance the effect is applied, defaults to 100 ``` -------------------------------- ### Item Assignment Configuration Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/additional-configuration-options/item-rarity.md Assigns this rarity to specific items from the Item Lookup System. For EcoItems, it's recommended to set rarity directly in their own configuration. ```yaml items: # Items from the Item Lookup System - diamond ``` -------------------------------- ### Item Attributes Source: https://github.com/auxilor/ecoitems/blob/master/documentation/ecoitems/how-to-make-a-custom-item/how-to-make-a-custom-item.md Define the basic properties of an item, such as its slot, rarity, and combat stats. The 'slot' attribute determines where the item must be equipped to function. ```yaml slot: mainhand rarity: rare base-damage: 12 base-attack-speed: 1.5 base-attack-range: 3.0 ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.