LegendGuns (Free Edition)

simple but powerful weapon configurations

# the Java class drives this weapon
# weapon type for the base class
base: NormalWithAmmo

display: "&e&lRifle Gun"

# Material from Bukkit API
material: GOLD_BARDING
# Lore for the weapon
lore:
  - "&eThis is a rifle weapon"

# base class specific settings
# in this situation, we need set the parameters for Normal
settings:
  loadup:
    effects:
      start: load-start
      done: load-done
    delay: 25
  shooting:
    effect: shoot
    # NOTICE: this delay is in microseconds
    delay-ms: 200
    # the angle from 0.0-1.0
    recoil:
      # rotate upwards, it will *NOT* interupt the player's movement
      rotate-vert: -1.0
      # max delta value of the horizontal rotation, should be ±N
      rotate-hori-max: 2.0
    burst-shot:
      enabled: true
      count: 3
      delay: 2
  scoping:
    enabled: false
    # zoom stages, value means slowness amplifier
    zoom-stages: []
    # stage indexes that enabled night-vision
    # index starts from 0
    night-vision-stages: []
  # ammunition settings
  ammunition:
    # what types of magazines can be used
    accepted-magazines: [dot55]
    # effect for the weapon when out of ammo
    no-ammo-effect: no-ammo
  bullet:
    # Projectile EntityType from Bukkit API
    projectile: SNOWBALL
    # bullet speed
    speed: 4
    damage:
      # damage type: SINGLE or BLAST
      type: SINGLE
      # use radius if using BLAST type
      # radius: 4
      value: 2.0
    # gravity affected or not?
    # set false for flying objects,
    # for example rockets can run slot but don't drop
    # also if wanna make it weird, set to true
    gravity: false
    effect: bullet
    hit-effect: bullet-hit
    bullets-per-shot: 1
    randomness: 0.01
    # how many ticks before check and remove bullets?
    clear-up:
      # check interval in ticks
      interval: 100
      # bullet time-to-live in microseconds
      ttl-ms: 10000

base: Normal
# ...
settings:
  #...
  shooting:
  # ...
    recoil:
      # rotate upwards, it will *NOT* interupt the player's movement
      rotate-vert: -1.0
      # max delta value of the horizontal rotation, should be ±N
      rotate-hori-max: 2.0
# ...

- Example for a moving object, adding a heart trail.

components:
  just-a-name-for-this-particle:
    category: PARTICLE
    type: REDSTONE
    delay: 0
    repeat-interval: 1
  beautiful-hearts:
    category: PARTICLE
    type: HEART
    repeat-interval: 2

- Example for a single-time effect, effect when out of ammo.

components:
  base-sound:
    category: SOUND
    type: BLOCK_GLASS_PLACE
  high-sound:
    category: SOUND
    type: BLOCK_LEVER_CLICK

General installation steps:
1. Install ProtocolLib on your server (of course)
2. Put `LegendGuns-x.x-xx.jar` into your plugins folder
3. Start your server and shut it down (yea! why not! )
4. Write your configurations about effects/weapons/magazines.
You can start with editing the pre-made templates/examples from:
https://github.com/DragonetMC/LegendGuns-Sample-Config
5. Start your server again

then, for survival servers
- Install LegendGunsCrafting to enable crafting recipes for weapons!

or, for minigame servers
- Install a minigame plugin utilizes LegendGuns
(I will make one very soon! )