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)