Bukkit

put this to false if you dont want VineControl to do anything
vinecontrol_enabled: true

put this to false if you dont want bonemeal to do anything (overrides bonemeal permission)
bonemeal_enabled: true

this is maximum length your vines can grow before being cut
max_length: 20

if a vine needs cutting, a random amount of blocks is cut from its bottom, specify its range here
max_cut: 5

if a vine gets cut it will leave atleast this many vines hanging, if the vine has not outgrown its minimum length it will not be cut at all.
min_length: 3

if set to true, vines wil stay above the ground... unless minimum length is not met
above_ground: true

vine growth speed in %. 100=full growth speed 0=no growth at all, if set higher than 100 it will not speed growth up
growthrate: 100

use this to prevent vines growing on glass and other blocks

blacklist:
  -GLASS
  -WOOL
  -etc

to configure multiple worlds simply add them to the list like this:

global:
  vinecontrol_enabled: true
  bonemeal_enabled: true
  above_ground: true
  min_length: 1
  max_length: 10
  max_cut: 5
  growthrate: 100
  blacklist:
    - GLASS
exampleWorld:
  blacklist:
    - GLASS
    - WOOL

Regions are very similar but need to be defined whitin a world:

global:
  config
world:
  config
  region1:
    config
  region2:
    config
world1:
  config
  region1:
    config
  region2:
    config

global:
  vinecontrol_enabled: true
  bonemeal_enabled: true
  above_ground: true
  min_length: 1
  max_length: 10
  max_cut: 5
  growthrate: 100
  blacklist:
    - GLASS
exampleWorld:
  blacklist:
    - GLASS
    - WOOL
  exampleRegion:
    bonemeal_enabled: false
    min_length: 3
    max_length: 15
    growthrate: 50
exampleWorld2:
  vinecontrol_enabled: false
  bonemeal_enabled: false

settings are inherited, meaning that if you don't put "max_length" in the region config, it will use the max length of the world that region is located in, if you don't put it in the world config either, it will use the global config, if it is not set in the global config it will use hardcoded defaults

WARNING:
Never make max_cut bigger than max_length,
it might remove entire vines or delete blocks above your vines!!!!!!

make sure that min_length + max_cut is smaller then max_length!!!!
i.e: if min_length = 1 and max_cut = 5
1+5 = 6, so max_length should be atleast 6!!!!
otherwise vines will be cut shorter than the min_lenght!!!!!
(as a precaution, vinecontrol will not work in these scenario's)

if vines have not reached their min_length,
they will not be cut if they are near the ground
so a long min_length may have adverse effects

regions should be defined within their worlds
the examples below show the correct structure
region names/ID's are case-sensetive!!!