Overview
LivingItems transforms standard Minecraft tools into interactive living companions. Each item has a personality, gender, mood, and bond with the player. Items respond to actions, feeding, and use, providing dynamic reactions.

Commands

• /li awaken
  - Description: Awakens a held tool, turning it into a living item.
  - Permission: livingitems.awaken
  - Usage:
  Code (Text):

  /li awaken
  - Notes:
  • Only tools can be awakened.
  • Awakened items gain a random personality and gender.
  • Item lore is updated:
    
    Code (Text):

    
    §6Awakened
    §ePersonality: <personality>
    §eGender: <gender>
     
• /li repair
• - Description: Repairs a living item using material in the offhand.
  - Permission: livingitems.repair
  - Usage:
  Code (Text):

  /li repair
  - Notes:
  • Item must be in main hand.
  • Place valid repair material in offhand.
  • Consumes one unit per use.
  • Restores durability.
• /li info
  - Description: Displays detailed stats of a living item.
  - Usage:
  Code (Text):

  /li info
  - Output Example:
  
  Code (Text):

  
  ----- Living Item Info -----
  Type: DIAMOND_PICKAXE
  Bond: 25
  Mood: 10
  Personality: BRAVE
  Gender: MALE
  ----------------------------
   
• /li rename <newname>
  - Description: Renames the living item if bond ≥ 10.
  - Usage:
  Code (Text):

  /li rename Excalibur
  - Notes:
  • Requires bond ≥ 10.
  • Displays personalized reaction after renaming.
• /li talk
  - Description: Interacts with your living item for a personalized reaction.
  - Usage:
  Code (Text):

  /li talk
• /li reload
  - Description: Reloads plugin configuration.
  - Permission: livingitems.reload
  - Usage:
  Code (Text):

  /li reload

Features

• Awakened Items: Tools gain personality, gender, and custom lore.
• Dynamic Reactions: Items respond to:
  • Mining blocks
  • Combat
  • Enchanting
  • Grindstone use
  • Idle randomly (idle talk)
• Over 100 Reactions: Every combination of personality, gender, and mood has a unique reaction.
• Feed & Repair: Use offhand materials to bond, improve mood, and restore durability.
• Permissions: Control access to commands.
• Persistent Storage: All item data saved in data.yml.

Materials & Effects

Material	Effect	Reaction Type
IRON_INGOT	Bond + Mood	FEED_GOOD
GOLD_INGOT	Bond + Mood	FEED_GOOD
DIAMOND	Bond + Mood	FEED_GOOD
NETHERITE_INGOT	Bond + Mood	FEED_GOOD
COPPER_INGOT	Bond + Mood	FEED_BAD
COAL	Bond + Mood	FEED_BAD

Idle Reactions

• Every 5 minutes, living items may send a random reaction based on mood and personality.
• Configurable chance in config.yml:
  
  Code (Text):

  idle:
    talkChance: 0.05

Example Usage

• Hold a diamond pickaxe.
• Code (Text):

  /li awaken
  → Pickaxe becomes a living item.
• Place an iron ingot in offhand.
• Code (Text):

  /li feed
  → Increases bond and triggers a reaction.
• Mine a block → Pickaxe reacts based on mood and personality.
• Code (Text):

  /li info
  → Check bond, mood, personality, and gender.
• Code (Text):

  /li rename MinerBuddy
  → Renames pickaxe if bond ≥ 10.
• Code (Text):

  /li repair
  with a diamond in offhand → Restores durability.