🪴 Experience Sources

An experience source gives you experience for certain professions when certain events occur. Each experience source has its own specific parameters that you can specify in the config with exp_source_name{param1=P1;param2=p2..}. You must specify the parameter amount=min-max corresponding to the bounds between which the amount of experience will be randomly chosen each time.

You can also use experience sources for your main classes.

Examples

Let's have a look at an example. These are the default experience sources for the Woodcutting profession. It basically gives the player anywhere from 1 to 3 experience points whenever he cuts a log.

exp-sources:
- 'mineblock{type=OAK_LOG;amount=1-3}'
- 'mineblock{type=SPRUCE_LOG;amount=1-3}'
- 'mineblock{type=BIRCH_LOG;amount=1-3}'
- 'mineblock{type=JUNGLE_LOG;amount=1-3}'
- 'mineblock{type=ACACIA_LOG;amount=1-3}'
- 'mineblock{type=BIRCH_LOG;amount=1-3}'
- 'mineblock{type=DARK_OAK_LOG;amount=1-3}'

These are the default experience sources for the farming profession, which grants some experience points whenever the player harvest any type of crops.

exp-sources:
- 'mineblock{type=CARROTS;amount=1-3;crop=true;player-placed=true}'
- 'mineblock{type=POTATOES;amount=1-3;crop=true;player-placed=true}'
- 'mineblock{type=WHEAT;amount=1-3;crop=true;player-placed=true}'

crop=true means that it'll only grant EXP once it's at it's full growth stage. player-placed=true means that it'll grant EXP even if the player placed the block

Experience Sources Tables (Since 1.9.5)

You can create experiences-sources tables in exp-sources.yml. It links an id to a list of experiences sources that you will all be to reference at once.

#Example
test-exp-source: 
  - 'damagedealt{type=physical;amount=250}'
  - 'move{type=WALK;amount=300}'
  - 'from{source=test2}'

test2:
  - 'eat{type=CARROT;amount="50"}'

Every experience source

Source	Usage	Description
From	from{source=exp-source-id}	Loads all the experience source in exp-sources.yml matching to exp-source-id.
Mine Block	mineblock{type=BLOCK_MATERIAL}	More info on Mining.
Kill Mob	killmob{type=MOB_ENTITY_TYPE;amount=1-3}	Killing a mob grants exp
Kill Mythic Mob	killmythicmob{type=MobInternalName;amount=1-3}	Killing a MythicMob grants exp
Fish Item	fishitem{type=ITEM_MATERIAL}	Fishing an item of the specified type grants exp.
Smelt Item	smeltitem{type=ITEM_MATERIAL}	When an item is smelted (furnaces)
Craft Item	craftitem{type=ITEM_MATERIAL}	When an item is crafted
Brew potion	brewpotion{effect=SPEED,REGEN,...}	More info on Alchemy
Place Block	placeblock{type=BLOCK_MATERIAL}	Placing a block of the specified type grants xp.
Repair Item	repairitem{type=ITEM_MATERIAL}	You can define on sithing.yml the amount of xp for each material. Check here the info about smithing..
Enchant Item	enchantitem{type=...}	More info on Enchanting
Climb	climb{type=CLIMB_TYPE}	When you climb one block. The type can be ladder, vines, weeping-vines, twisting-vines. If you don't specify any type it will trigger for all types.
Eat	eat{type=ITEM_MATERIAL}	Give experience when some specific food is eaten. If you don't specify a material for the type it will give exp disregarding what you eat.
Move	move{type=MOVING_TYPE}	Give experience for each block travelled the type can be sneak, fly, swim, sprint or walk.If it is not specified will trigger all the time.
Resource	resource{type=RESOURCE_TYPE}	Gives exp for each resource of type "RESOURCE_TYPE" consumed. Resource type can be mana, stamina or stellium.
Ride	ride{type=ENTITY_TYPE}	When you move riding a certain entity. Check the EntityType enum to specify the type.
Tame	tame{}	Exp given for each damage your wolves make.
Damage Taken	damagetaken{type=DAMAGE_CAUSE} or all damage cause damagetaken{amount=1}	Exp given for each damage a player takes damage from a certain cause. You can do for instance DROWNING, FALL, FIRE or BLOCK_EXPLOSION, Check here the documentation of DamageCause.
Damage Dealt	damagedealt{type=DAMAGE_TYPE} or all damage types damagedealt{amount=1}	Exp given per damage dealt of a certain mmo damage type.The damage type can be magic, physical, weapon, skill, projectile,unarmed, on-hit, minion or dot.