cropped-legend-quest-logo.png

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 2×2 or 3×3 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