Item Configuration
10/4/25Less than 1 minute
Item Configuration
The Avaritia plugin allows you to highly customize the properties of each item through configuration files.
File Location
Item configuration files are located in the /plugins/Avaritia_Plugin/items/
directory. Each .yml
file typically represents a category of items.
Structure
Each item is identified by its unique item ID.
# Example: infinity_sword.yml
infinity_sword:
material: DIAMOND_SWORD
custom_model_data: 1000
display_name: "items.infinity_sword.name"
lore:
- "items.infinity_sword.lore.0"
- "items.infinity_sword.lore.1"
enchantments:
- "sharpness:10"
- "unbreaking:3"
attributes:
generic.attack_damage: 9999
unbreakable: true
Property Details
material
: The base Minecraft material of the item.custom_model_data
: The CustomModelData (CMD) value of the item, used by resource packs to change its texture.display_name
: The display name of the item. This is usually a key pointing to the language file.lore
: The description text (Lore) of the item. This is usually a list of keys pointing to the language file.enchantments
(Optional): Enchantments to be added to the item.- Format:
"enchantment_name:level"
.
- Format:
attributes
(Optional): Attribute modifiers to be added to the item.- Format:
"attribute_name:value"
.
- Format:
unbreakable
(Optional): Sets whether the item is unbreakable.true
: Unbreakable.false
: Breakable.
How to Create a New Item
- Create a new
.yml
file in theitems
folder, for example,my_item.yml
. - Define your item in the file, ensuring it has a unique top-level ID (e.g.,
my_custom_sword
). - Configure its
material
,display_name
, and other properties. - In the recipe files, reference it using
avaritia:my_custom_sword
as a result or ingredient. - Reload the plugin with
/avaritia reload
, then get the item with/avaritia give <player> my_custom_sword
.