Basic

A basic guide to make a new gun.

In this page I will show you how to create a new gun in the easiest way. And you won't need to calculate or do any difficult tasks.

Step 1

Copy this template:

#NOTE: you can use "&" or "§"
#Must be unique!
<gun-id>: 
  build:
    Material: <replaceme>
    Name: <replaceme>
    Data <replaceme>
    Lore:
    - ''
    - '§7• Clip Ammo: §a{ammo}'
    - '§7• Damage: §a<replaceme> HP'
    - '§7• Max Clip Ammo: §a<replaceme>'
    - '§7• Fire Rate: §a<replaceme>'
    - '§7• Reload: §a<replaceme>'
    - '§7• Range: §a<replaceme>'
    - ''
    #You can add more or delete this
    #For 1.8.8 users: https://helpch.at/docs/1.8/index.html?org/bukkit/inventory/ItemFlag.html
    #For 1.12.2 users: https://helpch.at/docs/1.12.2/index.html?org/bukkit/inventory/ItemFlag.html
    Flags:
    - <replaceme>
    #You can add more or delete this
    #For 1.8.8 users: https://helpch.at/docs/1.8.8/index.html?org/bukkit/enchantments/Enchantment.html
    #For 1.12.2 users: https://helpch.at/docs/1.12.2/index.html?org/bukkit/enchantments/Enchantment.html
    Enchantments:
    - <replaceme>
  stats:
    damage: <replaceme>
    max-clip-ammo: <replaceme>
    fire-rate: <replaceme>
    reload: <replaceme>
    range: <replaceme>
  special:
    can-pierce: <false/true>
    #For particle list you can open README file or scroll down!
    particles: <replaceme>
    shoot-sound: <replaceme>
    shoot-sound-yaw: <replaceme> #Added since 1.0.0
    shoot-sound-pitch: <replaceme> #Added since 1.0.0
    hit-sound: <replaceme>
    hit-sound-yaw: <replaceme> #Added since 1.0.0
    hit-sound-pitch: <replaceme> #Added since 1.0.0
    droppable: <false/true>
    can-knockback: <false/true>
  shop:
    buyable: <false/true>
    #If set this 'false' you can delete all lines below!
    slot: <replaceme>
    currency: <IRON_INGOT/GOLD_INGOT/DIAMOND/EMERALD>
    amount: <replaceme>
    msgName: <replaceme>
    shop-display:
      Material: <replaceme>
      Name: '{color}<replaceme>'
      Data <replaceme>
      Lore:
      - ''
      - '§7• Clip Ammo: §a<replaceme>'
      - '§7• Damage: §a<replaceme>'
      - '§7• Max Clip Ammo: §a<replaceme>'
      - '§7• Fire Rate: §a<replaceme>'
      - '§7• Reload: §a<replaceme>'
      - '§7• Range: §a<replaceme>'
      - ''
      - '§7Cost: §6{cost} {currency}'
      - ''
      - '{buy_status}'
      Flags:
      - HIDE_ATTRIBUTES

You have to replace <replaceme> with the value you like, replace <value1/value2> with "value1" OR "value2". If the value is not a boolean (true or false). I suggest you putting them in a quote '<value>' to prevent error (don't need if there is already a quote). This template is used for normal guns, If you want any special effect in your gun. Please go to here.

Particle list

• EXPLOSION_NORMAL

• EXPLOSION_LARGE

• EXPLOSION_HUGE

• FIREWORKS_SPARK

• WATER_BUBBLE

• WATER_SPLASH

• WATER_WAKE

• SUSPENDED

• SUSPENDED_DEPTH

• CRIT

• CRIT_MAGIC

• SMOKE_NORMAL

• SMOKE_LARGE

• SPELL

• SPELL_INSTANT

• SPELL_MOB

• SPELL_MOB_AMBIENT

• SPELL_WITCH

• DRIP_WATER

• DRIP_LAVA

• VILLAGER_ANGRY

• VILLAGER_HAPPY

• TOWN_AURA

• NOTE

• PORTAL

• ENCHANTMENT_TABLE

• FLAME

• LAVA

• CLOUD

• REDSTONE (supported since BETA-1.0.4!)

• SNOWBALL

• SNOW_SHOVEL

• SLIME

• HEART

• ITEM_CRACK (supported since BETA-1.0.4!)

• BLOCK_CRACK (supported since BETA-1.0.4!)

• BLOCK_DUST (supported since BETA-1.0.4!

Step 2

Execute "/Armedmode reload data" to reload all guns data include the new gun. Or just restart the server.

That's all, no problem, right? But if you have any problem, feel free to ask me on Discord!