Plugin Overview
✨TerraCraftItems is an advanced item customization plugin designed for Minecraft 1.20+ versions（ paper only）. Through a component-based configuration system, it allows server administrators to flexibly create custom items with unique properties, suitable for various server types such as RPG, survival, and creative.

✨ Core Features
Component-based Item System

• Vanilla Component Support: Supports customizing basic properties like item name, material, model data, maximum stack size, dyeing, etc. (Developed based on NBT API, supports most Minecraft vanilla item components with syntax nearly identical to MC data components)
  • attribute_modifiers
  • blocks_attacks
  • break_sound
  • consumable
  • custom_model_data
  • custom_name
  • damage
  • damage_resistant
  • death_protection
  • dyed_color
  • enchantable
  • enchantment_glint_override
  • enchantments
  • equippable
  • food
  • glider
  • item_name
  • jukebox_playable
  • lore
  • max_damage
  • max_stack_size
  • potion_contents
  • potion_duration_scale
  • rarity
  • repairable
  • repair_cost
  • tool
  • tooltip_display
  • tooltip_style
  • unbreakable
  • use_cooldown
  • use_remainder
  • weapon
  
  
• Additional Component Extensions(Only the following additional components are supported. Other components in the configuration file are extended by the affiliated plugin under development):
  • terra_durability: Custom durability management (does not support durability enchantments)
    • Prioritizes recognizing custom placeholder durability formulas
    • Supports recognizing durability consumption in weapon components
    • Supports recognizing item breaking sounds from break_sound
  • command:Triggers specified commands when the item is consumed
    • Use @Self placeholder, which will be replaced with the user's name when executed

️ Flexible Configuration System

• Item configuration files based on YAML format, supporting text styling (gradients, colors, etc.) using MiniMessage syntax
• Supports configuring dynamic properties like probabilities and damage formulas through expressions
• Multi-language support (Chinese and English provided by default), with customizable message texts

Command Support

• /terracraftitems reload : Reload the plugin
• /terracraftitems get <item name> : Obtain custom items
• /terracraftitems durability <add|reduce|set> <value> : Adjust item durability

Plugin API

• Provides component extension API
  • The meta and other configurations in the example files are custom components extended by this plugin's companion [TerraCraftAttributes] (still in testing)