Abilities, Kill Effects & Throwables

This plugin supports custom abilities, kill effects, and a few throwable weapons.

• Abilities are defined in custom_items.yml

• Kill effects are defined in killeffects.yml

• Kits reference ability items using CUSTOM_ITEM:<id> inside kits.yml (example: CUSTOM_ITEM:sight)

• You can create/edit/delete abilities and killeffects.

Abilities (custom items)

Abilities are configured in custom_items.yml. You can create new custom items and then assign them to any kit by adding CUSTOM_ITEM:<id> to that kit’s kitItems list.

How to assign a custom ability to a kit

1

Create or edit an ability

Create (or edit) an ability in custom_items.yml. Example id: sight

2

Add the ability to a kit

Add it to a kit in kits.yml: Example: CUSTOM_ITEM:sight

Important limitations

Some items/abilities are hardcoded for now:

• Wizard spells: attack and support

• Throwable Golden Axe: axe

For hardcoded items (attack, support, axe) you can only change:

• name

• lore

✅ You may assign them to any kit you want ❌ Do NOT change material (item type) it must stay the same because they are hardcoded.

Throwable weapons

Only these are throwable (hardcoded):

• GOLDEN_AXE (the axe custom item)

• TNT (used by the Bombardier kit)

Bombardier’s TNT is throwable on right click. TNT currently can break only WOODEN type of FENCES

Tips

• If an ability item is consumed (like soup), keeping cooldown at 0 makes sense because it’s removed from inventory.

• If you add new custom items, keep the ids simple (lowercase recommended) so they’re easy to reference as CUSTOM_ITEM:<id>.

Timing rules

• Duration is in ticks

  • 20 ticks = 1 second

  • Example: 100 / 20 = 5 seconds

• Cooldown is in seconds

Example (custom_items.yml) format

custom_items.yml

items:
  spear:
    material: TRIDENT
    name: "&bEpic Spear"
    lore:
      - "&7A mighty spear."
    cooldown: 0
    enchantments:
      loyalty: 1
    effects:

  stew:
    material: MUSHROOM_STEW
    name: "&aHealing Stew"
    lore:
      - "&7Grants regeneration"
    ##COOLDOWN 0 ON SOUP BECAUSE ITS EATEN AND REMOVED FROM INVENTORY
    cooldown: 0
    amount: 1
    effects:
      - type: REGENERATION
        duration: 100
        amplifier: 1

  rage:
    material: NETHER_WART
    name: "&cRage Potion"
    lore:
      - "&7Speed & Strength boost"
    cooldown: 45
    amount: 1
    effects:
      - type: SPEED
        duration: 100
        amplifier: 2
      - type: NAUSEA
        duration: 100
        amplifier: 0
      - type: INCREASE_DAMAGE
        duration: 100
        amplifier: 0

  ragnarok:
    material: MAGMA_CREAM
    name: "&6Ragnarok"
    lore:
      - "&7Powerful ancient ragnar fight effect"
    amount: 1
    effects:
      - type: INCREASE_DAMAGE
        duration: 100
        amplifier: 0
      - type: RESISTANCE
        duration: 100
        amplifier: 0
      - type: SLOWNESS
        duration: 100
        amplifier: 1

  sight:
    material: FERMENTED_SPIDER_EYE
    name: "&bSight"
    lore:
      - "&7Grants jump & night vision"
    cooldown: 45
    amount: 1
    effects:
      - type: JUMP
        duration: 200
        amplifier: 1
      - type: NIGHT_VISION
        duration: 100
        amplifier: 1
      - type: SPEED
        duration: 100
        amplifier: 1

  oathstone:
    material: PRISMARINE_SHARD
    name: "&9Oathstone"
    lore:
      - "&7Sworn upon the honor of old kings."
      - "&7Grants resistance and speed."
      - "&8Cooldown: 45 seconds"
    amount: 1
    cooldown: 45
    effects:
      - type: RESISTANCE
        duration: 160
        amplifier: 1
      - type: SPEED
        duration: 100
        amplifier: 0

  ##ON THIS ITEMS BELOW YOU CAN JUST CHANGE NAME AND LORE
  ##DO NOT CHANGE MATERIAL OR ITEM NAME
  ## THEY WILL REMAIN HARDCODED FOR NOW
  attack:
    material: BLAZE_ROD
    name: "&cWizard Attack Spell"
    lore:
      - "&7Deals damage to nearby enemies"
  support:
    material: STICK
    name: "&aWizard Support Spell"
    lore:
      - "&7Heals and buffs nearby allies"
  axe:
    material: GOLDEN_AXE
    name: "&eThrowable Axe"
    lore:
      - "&7Right-click to throw!"

Kill effects (kill rewards)

Kill effects are fully customizable. When a player gets a kill, you can:

• give them items

• apply potion effects

Example (killeffects.yml)

killeffects.yml

kits:
  Marksman:
    effects:
      - give_item: SPECTRAL_ARROW
        amount: 1
      - type: SPEED
        duration: 100
        amplifier: 1

  Spearman:
    effects:
      - type: SPEED
        duration: 120
        amplifier: 1

  Wizard:
    effects:
      - type: ABSORPTION
        duration: 100
        amplifier: 1

  Knight:
    effects:
      - type: REGENERATION
        duration: 100
        amplifier: 0
      - type: ABSORPTION
        duration: 100
        amplifier: 0

  Skald:
    effects:
      - type: REGENERATION
        duration: 120
        amplifier: 1
      - type: ABSORPTION
        duration: 120
        amplifier: 0

  Berserker:
    effects:
      - type: RESISTANCE
        duration: 100
        amplifier: 1
      - type: REGENERATION
        duration: 100
        amplifier: 0

  Bombardier:
    effects:
      - type: SPEED
        duration: 100
        amplifier: 0
      - type: JUMP
        duration: 100
        amplifier: 1

  Warrior:
    effects:
      - type: RESISTANCE
        duration: 100
        amplifier: 1