Classes

Each player can have a main class and a subclass. Use /class list or (/classes) to display a list of available classes. and then /class [name] or /class sub [name] to select a main or sub-class.

Switching class before reaching mastery will loose any accumulated XP. Mastery is achieved at level 150 (or whatever is set in the main config).

Class Configuration

The /plugins/LegendQuest/classes/ folder contains the available classes for selection.

Each class config file looks like this.

name: Warlord
description: "Veteran fighter hails from the frigid Northlands"
longdescription: "Because one class always hails from the frigid northlands... (Long live Kol!)"
chattag: "[W]"

frequency: 100
default: false
perm: mycustomperm.forwarlord

mainclassonly: true
subclassonly: false

requires: fighter
requiresOne:
  - fighter
  - rouge

speedmod: 0.1

healthmod: 5
healthperlevel: 0.3

manaBonus: 10
manaPerSecond: 1.0
manaPerLevel: 0.1

statmods:
  str: 2
  dex: 1
  int: 0
  wis: 0
  con: 1
  chr: 0

allowedRaces:
  - ANY
allowedGroups:
  - ANY

allowedArmour:
  - leatherarmour
  - ironarmour
  - chainarmour
  - diamondarmour
allowedWeapons:
  - ANY
allowedTools:
  - irontools
  - woodtools
  - stonetools

disallowedWeapons:
  - BOW

allowCrafting: true
allowSmelting: false
allowBrewing: false
allowEnchanting: false
allowRepairing: true
allowTaming: false

disallowedCrafting: 
  - BOW
disallowedEnchanting: 
  - BOW
disallowedRepairing: 
  - BOW

skillPoints: 10
skillPointsPerLevel: 0.1

xpAdjustKill: 20.0
xpAdjustMine: -10.0
xpAdjustSmelt: 5.0

skills:
    dodge:
        level: 0
        cost: 5
        vars:
            soakchance: 60.0
            soak: 2
            dodgemod: 5
    brawler:
        level: 1
        cost: 0
        vars:
            damage: 5
            chance: 75.5
    weaponmaster:
        skillname: SwordMaster
        vars:
            chance: 90.5
            damag: 5
            weapons: "WOOD_SWORD,STONE_SWORD,IRON_SWORD,GOLD_SWORD,DIAMOND_SWORD"
levels:
    10:
        hp: 5 
    50:
        dex: 1
        hp: 5
    100:
        hp: 5
        mana: 5
        sp: 5
        manaregen: 2.5
        allowarmour: CHAINMAIL_BOOTS
        allowcraft: BOOTS

Here's what all the parts do.

name

The name of the class. e.g. Fighter, Mage, Miner, Mercenary

description

A brief description of the class e.g. "Warlord combat class"

longdescription

A long description of the class e.g. "Combat heavy warrior favouring large defence over damage"

chattag

A shorter name to use in chat prefixes. Omit to just use the full class name.

frequency

How common this class is. Used when randomly selecting a class for example an NPC add on.

default

The class that players begin as. Usually used to define a holding class for new players till they change.

perm

The permissions node required to select this class.

allowedRaces

allowedGroups

requires

requiresOne

These settings control the selection of classes. Any classes list in in requires must be mastered to choose this class, allowing for class progression. If requiresOne contains any classes then /one/ of them must be mastered first.

allowedRaces and allowedGroups control which races are permitted for each class. Groups allows you to easily set multiple races easily.

speedmod

Speed modifier added to the base speed.

healthmod

HP bonus added once to the base health level.

healthPerLevel

HP bonus added per level to the races HP.

#bonusMana##

The bonus mana added to race mana used to power skills.

manaPerSecond

The amount of mana regained per second. This is in addition to the manaPerSecond for race.

statmods

Each stat modifies the base star for the player. This is cumulative with race modifiers. Players have a random statline based on their uuid, or all 12s depending on the server config. Each stat effect attribute checks for various elements. For example strength (STR) effects damage, dexterity( DEX) effects hitting/dodging, constitution (CON) hitpoints, intelligence (INT) skill points, wisdom (WIS) enchanting and Charisma (CHR) trading.

allowCrafting

Sets whether the race can use a craft bench, both 2x2 or 3x3 blocked.

allowSmelting

Sets whether the class can use a furnace

allowBrewing

Sets whether this class can brew potions.

allowEnchanting

Sets whether the class can enchant items.

allowRepairing

Sets whether this class can use an anvil.

allowTaming

Sets whether this class can tame animals

disallow[Crafting|Smelting|Brewing|Enchanting|Repairing|Taming]

If the allow ability nodes are true, these lists can be used to exclude specific items or groups.

groups

A list of groups that this race is a member of. This is used to group races together when setting permissions for classes.

skillPoints

The starting number of skill points for this race.

skillPointsPerLevel

Number of skill points extra per level.

allowedWeapons

allowedTools

allowedArmour

dissallowedWeapons

dissallowedTools

dissallowedArmour

These sections set the allowed and disallowed items for each class by material.
By default each item is disallowed unless named as allowed in a race or class. Items marked as disallowed get the final say, prevent use/wearing even is allowed by a different class or race. The data.yml file lists groups of materials that you can refer to for groups.

For example, this above config example allows leather and chain armour, but then disallows BOOTS. Meaning that Hobbits can never wear Boot type around even if a class would later allow.

xpAdjustKill

Percentage modifier to apply to all experience from kills

xpAdjustMine

Percentage modifier to apply to all experience from mining

xpAdjustSmelt

Percentage modifier to apply to all experience from smelting

skills

See the skills section for more information on how this section is configured.

levels

The levels section allows you to give specific 'rewards' at levels of your choice.

you can use the following nodes
hp: health points.
sp: skill points.
mana: mana points
manregen: extra mana regeneration
[str|dex|con|int|wis|chr]: extra stat points
allow[craft|repair|smelt|brew|enchant|tame|weapon|tool|armour]: allow access to a material for the chosen core ability
disallow[craft|repair|smelt|brew|enchant|tame|weapon|tool|armour]: disallow access to a material for the chosen core ability