Configuration
Configuration
To configure this plugin, modify the contents of "config.yml" in your "/plugins/HorizonProfessions" directory. Keep in mind this will not be generated until the server is started with the plugin for the first time.
All configuration files for Bukkit use YAML format: http://yaml.org/
- Do not use tabs for indentation, use two spaces instead.
- Capitalisation matters
- Indentation matters
The following options in the configuration file are explained. This guide is also viewable in the configuration file that is generated.
PROFESSIONS List of profession names that you want on the server. professions: - engineer - medic - labourer - pilot - hunter TIERS List of tiers and their names that you want Ensure that they are numbered from 0 to the maximum tier maxLevel - the number of levels a player gains in that tier before progressing to the next one. tiers: 0: name: unskilled maxLevel: 1 1: name: novice maxLevel: 20 2: name: adept maxLevel: 40 3: name: expert OPTIONS fatigue_time - Time of the level-up cooldown in ticks (20 ticks = 1 second). Training and grinding are on seperate timers. permission_prefix - the prefix to all permissions awarded for professions. Format is [permission_prefix].[profession].[tier]. This is used to interface with other plugins that rely on permissions. enable_training - set to false if you don't want players to be able to train. max_exp - the amount of experience earned before level-up. claimable_tiers - the number of free tiers a new player can claim. Set to 0 to disable this. tier_cap - the total number of tiers a player may have in all professions. After they reach this point they gain no experience. place_cooldown - exploit protection against repeatedly breaking and placing blocks. This is the timer in ticks (20 ticks = 1 second). Blocks broken before this timer is up yields no experience. SLAYING The amount of experience for killing each type of mob is configurable Multiple professions may be defined. Mobs can appear under more than one profession. Example configuration: slaying: hunter: chicken: 1 pig: 1 pilot: sheep: 1 cow: 1 This configuration awards 1 experience to hunters for killing chickens and pigs, and 1 experience to pilots for killing sheep and cows. DAMAGE MODIFIER The amount of damage a player deals is configurable. Multiple professions and tiers may be defined. It can be required that the player is holding a specific weapon. Example configuration: damageModifier: hunter: unskilled: 25 novice: 50 adept: 100 expert: 150 weaponReq: - DIAMOND_SWORD - IRON_SWORD - STONE_SWORD - WOOD_SWORD This configuration will cause unskilled hunters to deal 25% the damage they usually would, novices 50%, adepts 100% and experts 150%. However, this modifier only applies if the player is holding any of the items listed. For a list of items, view here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html HEALING Certain professions can be configured with the ability to heal themselves and other players. The item, profession, and tier required are configurable and there may be multiple. For each profession and tier the amount to heal is configurable. Any unlisted professions and tiers will be unable to heal. Example configuration: healing: paper: medic: novice: 2 adept: 4 expert: 6 In this configuration, medics can heal using paper. A novice heals 2HP, an adept heals 4HP, and an expert heals 6HP. 2HP = 1 heart. Unskilled is not listed, so unskilled medics cannot heal. RECIPES The plugin can be configured to award experience when a player crafts an item. This feature is ONLY available if RecipeManager is installed. This feature only applies to recipes specified in RecipeManager configuration. The name of the custom recipe must match the name given here. Example RecipeManager configuration (1): CRAFT Diode @displayresult first redstone + stained_clay:10 + redstone = diode:0:1 This is a recipe with the name Diode. Note: follow RecipeManager's instructions for creating your recipes in that plugin. Example HorizonProfessions configuration (1): recipes: engineer: diode: 5 This specifies that crafting the "Diode" recipe will award 5 experience to engineers. Both plugins must be configured for this to work. Example RecipeManager configuration (2) CRAFT Diode @permission horizonprofessions.engineer.novice, horizonprofessions.engineer.adept, horizonprofessions.engineer.expert | <yellow>You're not sure how to make this. Perhaps a Novice Engineer could help you. @displayresult first redstone + stained_clay:10 + redstone = diode:0:1 @permission horizonprofessions.engineer.novice = diode:0:2 @permission horizonprofessions.engineer.adept = diode:0:3 @permission horizonprofessions.engineer.expert In this example, the recipe will only be craftable by engineers. A novice engineer will receive 1 diode, an adept engineer will receive 2 diodes and an expert engineer will receive 3 diodes. This is made possible because Horizon Professions gives players permission nodes based on their tiers in each profession. The default permission node for your configuration is horizonprofessions.[profession name].[tier name]. However, the prefix can be changed to anything you want instead of "horizonprofessions". This format is recommended if you wish to restrict recipes or provide extra boons to certain professions. BREAK BLOCKS Each block can be configured to only be broken by players with a certain profession and tier. If the player has a tier HIGHER than the requirement, they are permitted to break that block. Multiple professions and tiers may be defined. Each block should only appear once. The plugin also awards experience for breaking the block. Example configuration: breakBlocks: labourer: novice: stone: 1 unskilled: dirt: 1 In this configuration, only novice, adept, and expert labourers can break stone (unskilled labourers can't). When a player breaks stone they get 1 experience. Any labourer (unskilled and above) can break dirt and they get 1 experience for doing so. PLACE BLOCKS Identical in concept and configuration to break blocks. Example configuration: placeBlocks: labourer: novice: potato: 1 In this configuration, only novice, adept and expert labourers can plant potatoes. They get 1 experience for doing so.
Comments