Links

Guns

guns.yml

This is the file where all custom guns behaviour and config are stored

Example gun

revolver_gun:
enabled: true
permission: revolver_gun
model_id: 1
vanilla_type: GOLDEN_SWORD
name: '&fRevolver'
specific_properties:
projectile: projectile
events:
gun_shot:
play_sound: revolver_shot
play_effect: SMOKE
gun_no_ammo:
play_sound: revolver_no_ammo
craft_recipe:
enabled: true
pattern:
- III
- ISX
- WXX
ingredients:
I: IRON_INGOT
S: STICK
W: SPRUCE_PLANKS

Specific properties

specific_properties:
projectile: projectile
Guns have a specific property which identifies the compatible projectile. To use guns you must hold the specified custom item in left hand while shoting with gun.
You can create projectiles in items.yml file, it contains generic items which has no particular functionality in the game (ingredients for recipes and some little objects)

Events

events:
gun_shot: #event called when user shots
play_sound: revolver_shot #play a sound (vanilla or custom)
play_effect: SMOKE #play an effect
gun_no_ammo: #event called when user has no projectiles left
play_sound: revolver_no_ammo #play a sound (vanilla or custom)