Bukkit

general:
  #the name of the projectile displayed in game
  projectileName: Iron Ball
  #the name of the item to load this cannons.projectile
  itemName: Iron-CannonBall
  #the item which is associated with the proectile.
  #items can be assigned to many different projectiles which are used with different cannons
  #example: on cannon can be loaded with stone but will fire an armor piercing round, while a different cannon
  #can be loaded with stone and it will fire an explosive projectile
  loadingItem: '265:0'
  #some item create a block when placed e.g. redstone dust makes a wire if placed on ground. 
  #if you load the dust, type in the wire id and data, else there is a wire on the cannon.
  alternativeId:
    - '1:0'
cannonball:
  #the velocity of the projectile.
  velocity: 6
  #how many blocks the projectile will penetrate before it explodes. If it hits something impenetrable (e.g. obsidian) it will explode instantly.
  penetration: 1
  #whether the .projectile destroys blocks it penetrates. If false it will simple pass through them
  doesPenetrationDamage: true
  #how many seconds after firing the cannons.projectile will detonate if it does not hit anything
  timefuse: 0
  #how many pojectiles are fired
  numberOfBullets: 2
  #the higher this is, the more inaccurate the projectile. This multiplies the "spreadOfCannon" property of the cannon it is fired from
  spreadMultiplier: 1.0
  #different properties of the projectile. if you don't want any of these properties then just leave this all blank.
  #possible properties are: superbreaker, incendiary, teleport
  properties:
    #this means the cannonball will break through obsidian, water, and lava
    #this property sets the impact area on fire. range is determined by the explosion power propery
    - incendiary
explosion:
  #the explosion power of the cannonball when it hits; this number determines the explosions range in blocks.
  #for comparison, the explosion power of a creeper is 3. anything above 50 will cause lag on smaller servers
  explosionPower: 6
  #whether the explosion will destroy blocks
  doesExplosionDamage: true
  #the range of the potion effects specified below
  potionRange: 5
  #how long the effects will last. If the potion duration is <= 0 it will be disabled
  potionDuration: 7
  #how powerful the effect is, the higher this is the more powerful the effect. If set to 1 it has potion effect type II, if 0 potion effect type II
  potionAmplifier: 1
  #which potion effects are used. a list of effects supported by bukkit can be found here-
  #http://jd.bukkit.org/rb/apidocs/org/bukkit/potion/PotionEffectType.html
  potionEffects:
   - harm
   - slow
#options which determine whether blocks are spawned around the impact area. Works with spawn eggs and blocks
placeBlock:
  #the radius where blocks will be placed. If the radius is too small there might be no air gap to spawn a block.
  radius: 3
  #the maximum amount of blocks placed. To disable this feature set the amount to 0.
  amount: 0
  #the velocity of blocks/entities are slinged away from the impact
  velocity: 2.0
  #the blocks which will be placed. does not seem to support more tha one block type at a time. 
  #you can either spawn a block of material, or an entity by using the spawn egg id (383) and its entity id (http://www.minecraftwiki.net/wiki/Data_values#Entity_IDs)
  material:
    #this one is a spawn-egg with its parameters set to spawn primed tnt on impact
    - '383:20'
    #this is a cobweb to slow the enemy, will be spawned a block
    - '30:0'
loadPermission:
  #the permissions required for a player to use this projectile. There can be several permissions to load a projectile
  - cannons.projectile.default

general:
  #name of the cannon
  designName: Classic
signs:
  #this cannon needs a sign to operate. Important for moving cannons.
  isSignRequired: false
ammunition:
  #what the gunpowder is called
  gunpowderName: gunpowder
  #what item is used as gunpowder
  gunpowderType: '289:0'
  #if true, no item is removed from the players inventory
  ammoInfiniteForPlayer: false
  #if true, the cannons does not consume ammunition after firing with redstone
  ammoInfiniteForRedstone: false
  #whether the cannon can reload from a chest
  autoreloadRedstone: true
barrelProperties:
  #maximum gunpowder that can be loaded in the cannon
  maxLoadableGunpowder: 5
  #how much faster the loaded projectile will fired for each gunpowder loaded
  multiplierVelocity: 1.0
  #the angle of which a fired projectile spreads when fired. Basically the lower this is, the more accurate the cannon is
  spreadOfCannon: 1.0
timings:
  #how long anyone near the cannon without a helmet will be confused when the cannon is fired
  blastConfusion: 5
  #the delay in seconds between when someone fires a cannon and when the actual projectiles fired from the cannon
  fuseBurnTime: 1
  #the time in seconds before the cannon can be fired again
  barrelCooldownTime: 10
angles:
  #used to adjust in what direction a projectile is fired from a cannon. adjust this if your cannon is firing sideways or at itself
  defaultHorizonatalFacing: west
  #the default angle vertical angle which the cannon aims at when built. this is good for mortars and similar upwards firing weapons
  defaultVerticalAngle: 0.0
  #min and max horizontal angles determine how far to the left and right the cannon can be aim
  maxHorizontalAngle: 45.0
  minHorizontalAngle: -45.0
  #min and max vertical angles determine how far upwards or downwards the cannon can be aimed
  maxVerticalAngle: 45.0
  minVerticalAngle: -45.0
  #each change of the angles will change angle by this amount
  angleStepSize: 1.0
  #how fast the cannons can be turned in ticks
  angleUpdateSpeed: 5.0
realisticBehaviour:
  #whether a player has to right click while holding the firing item (e.g flint and steel) for the cannon to be fired
  isFiringItemRequired: false
  #the cannon move one block back after firing (not implemented yet)
  hasRecoil: false
  #whether you have to load the cannon from the same place the projectile is fired (aka muzzle loading) (not implemented yet)
  isFrontloader: false
  #whether the whole cannon can be rotated 90 degrees (not implemented yet)
  isRotatable: false
  #whether the cannon can be used with fire missions to bombarded a certain location (not implemented yet)
  supportsFireMission: false
permissions:
  #all the permissions required for a player to use certain parts of the cannon
  build: cannons.player.build
  load: cannons.player.load
  fire: cannons.player.fire
  adjust: cannons.player.adjust
  autoaim: cannons.player.autoaim
  targetTracking: cannons.player.tracking
  redstone: cannons.player.redstone
  autoreload: cannons.player.autoreload
  #how much better the player can handle the cannon.
  #possible values are cannons.player.spreadmultiplier.1 - cannons.player.spreadmultiplier.10 for a multiplier of 0.1 - 1.0
  spreadMultiplier: cannons.player.spreadmultiplier
accessRestriction:
  #whether only the owner of the cannon can use it or not (not implemented yet)
  ownerOnly: false
allowedProjectiles:
  #these are the list of projectiles a cannon can fire. The projectiles are taken from the config files in the projectiles folder.
  #they do not have to be named after an in-game item and can be named anything.
  #make sure the name matches the name of the config file of the projectile you want this cannon to be able to fire. the .yml part does not need to be included
  - cobblestone
  - Iron-CannonBall
constructionBlocks:
  #blocks of the cannon schematic which are ignored and not required to build the cannon. Default is sand
  ignore: '12:0'
  #the block which the projectile is fired from the cannon, direction can be adjusted using the defaultHorizontalFacing property. Default is block of snow
  muzzle: '80:0'
  #the block used to indicate when a cannon has been fired. default is torch. Makes fancy smoke on this location
  firingIndicator: '50:5'
  #the block used to indicate where the player can place chests or signs on the cannon. Default is a blank wall sign
  chestAndSign: '68:-1'
  #indicates where redstone torches can be placed for redstone autoload and firing to work. Default is redstone torch
  redstoneTorch: '76:5'
  #the block used to indicate where redstone wiring needs to be placed for redstone autoloading and firing to work. Default is redstone dust
  restoneWireAndRepeater: '93:-1'
  #options for where a redstone signal needs to lead to in order to activate redstone autoloading and firing
  redstoneTrigger: 
    #the block used by the schematic to indicate where the redstone signal needs to lead to. Default is a lever
    schematic: '69:-1'
    #the block used in game where the redstone signal needs to lead to. Default is stone button
    ingame: '77:-1'
  #the blocks which a player right clicks in order to fire a cannon
  rightClickTrigger: 
    #the block used in the cannons schematic which is used to fire the cannon when right clicked by a player. Default is torch
    schematic: '50:5'
    #the block used in game to fire the cannon when right clicked by a player. Default is torch
    ingame: '50:5'
  #list of blocks in the schematic that will be protected from explosions (e.g. buttons, because they break easily)
  protectedBlocks:
    - '50:5'
    - '69:-1'
    - '77:-1'