Example Weapons

katana example:

id: katana

base-material: PAPER
custom-model-data: 10001
model: katana
rarity: LEGENDARY

name: "&6&lKatana"
lore:
  - "&7A light legendary blade made for speed."
  - "&7Its sharp edge channels wind and force."
  - ""
  - "&eAbility: &fGround Slam"
  - "&7Right-click to slam nearby enemies."
  - ""
  - "&bAbility: &fSky Launch"
  - "&7Shift-left-click to launch upward."
  - ""
  - "&6Forging unlocks stronger blade perks."

amount: 1

damage: 6.0
speed: 1.6

durability: 150
stackable: false
max-stack-size: 1

# -------------------------------------------------
# FORGERY
# -------------------------------------------------
forgery:
  enabled: true
  max-level: 5

  cost-material: IRON_INGOT
  cost-base-amount: 8
  cost-growth: 4

  damage-per-level: 0.0
  durability-per-level: 0
  power-per-level: 0.0

  levels:
    1:
      display-name: "&aSharpened Edge"
      cost-material: IRON_INGOT
      cost-amount: 8
      damage-bonus: 1.0
      durability-bonus: 15
      power-bonus: 0.05
      perks:
        - "&a+1 Damage"
        - "&a+15 Max Durability"
        - "&7The blade feels sharper."
      commands:
        - "say %player% forged %weapon% to level %level%!"

    2:
      display-name: "&bWind Tempered"
      cost-material: DIAMOND
      cost-amount: 2
      damage-bonus: 1.5
      durability-bonus: 25
      power-bonus: 0.15
      perks:
        - "&b+1.5 Damage"
        - "&b+25 Max Durability"
        - "&7Ability power increased."
        - "&7Sky Launch becomes stronger."

    3:
      display-name: "&dStorm Blade"
      cost-material: DIAMOND
      cost-amount: 4
      damage-bonus: 2.0
      durability-bonus: 40
      power-bonus: 0.25
      perks:
        - "&d+2 Damage"
        - "&d+40 Max Durability"
        - "&7Ground Slam hits harder."
        - "&7Wind pressure surrounds the blade."
      commands:
        - "title %player% title {\"text\":\"Storm Blade\",\"color\":\"light_purple\"}"

    4:
      display-name: "&6Mythic Edge"
      cost-material: NETHERITE_SCRAP
      cost-amount: 2
      damage-bonus: 3.0
      durability-bonus: 60
      power-bonus: 0.35
      perks:
        - "&6+3 Damage"
        - "&6+60 Max Durability"
        - "&7Large ability power boost."
        - "&7The katana becomes mythic-grade."

    5:
      display-name: "&cDragon Fang Katana"
      cost-material: NETHERITE_INGOT
      cost-amount: 1
      damage-bonus: 5.0
      durability-bonus: 100
      power-bonus: 0.50
      perks:
        - "&c+5 Damage"
        - "&c+100 Max Durability"
        - "&7Maximum forge power."
        - "&7The blade reaches its final form."
      commands:
        - "broadcast &c%player% fully forged the Katana!"

# -------------------------------------------------
# REPAIR
# -------------------------------------------------
repair:
  cost-material: IRON_INGOT
  cost-amount: 4

# -------------------------------------------------
# MASTERY
# -------------------------------------------------
mastery:
  enabled: true
  show-in-lore: true

  max-level: 25

  base-needed-xp: 100
  needed-xp-growth: 40

  damage-bonus-per-level: 0.20

  rewards:
    1:
      display-lore:
        - "&7Reward: &aSmall starter bonus"
        - "&7Bonus: &a16 Arrows"
      commands:
        - "give %player% arrow 16"
        - "say %player% reached Katana Mastery Level %level%!"

    5:
      display-lore:
        - "&7Reward: &b2 Diamonds"
        - "&7The katana starts to feel lighter."
      commands:
        - "give %player% diamond 2"
        - "broadcast &6%player% reached Katana Mastery Level 5!"

    10:
      display-lore:
        - "&7Reward: &b5 Diamonds"
        - "&7A reward for skilled sword use."
      commands:
        - "give %player% diamond 5"
        - "title %player% title {\"text\":\"Katana Adept\",\"color\":\"aqua\"}"

    15:
      display-lore:
        - "&7Reward: &6Katana Expert Title"
        - "&7You are becoming dangerous with this blade."
      commands:
        - "give %player% emerald 6"
        - "title %player% title {\"text\":\"Katana Expert\",\"color\":\"gold\"}"

    20:
      display-lore:
        - "&7Reward: &eKatana Champion"
        - "&7Reward: &a5 Emeralds"
      commands:
        - "give %player% emerald 5"
        - "title %player% title {\"text\":\"Katana Champion\",\"color\":\"yellow\"}"

    25:
      display-lore:
        - "&7Reward: &dKatana Master"
        - "&7You have mastered this legendary weapon."
      commands:
        - "give %player% netherite_scrap 2"
        - "broadcast &d%player% has mastered the Katana!"

# -------------------------------------------------
# ABILITIES
# -------------------------------------------------
abilities:
  right-click:
    enabled: true
    name: "Ground Slam"
    type: GROUND_SLAM
    power: 2.4
    damage: 20.0
    radius: 3.0
    cooldown: 6
    durability-cost: 2
    message: "&cYou slammed the ground!"

  shift-left-click:
    enabled: true
    name: "Sky Launch"
    type: LAUNCH_UP
    power: 2.4
    damage: 8.0
    radius: 2.0
    cooldown: 8
    durability-cost: 1
    message: "&bYou launched upward!"

# -------------------------------------------------
# RECIPE
# -------------------------------------------------
recipe:
  enabled: true
  shape:
    - " I "
    - " I "
    - " S "
  ingredients:
    I:
      material: IRON_INGOT
      amount: 2
    S:
      material: STICK
      amount: 1