Project MMO: Classes

This mod adds a highly configurable class system to Project MMO.

There are 3 types of classes you can gain, primary classes like Wizard and Fighter, subclasses which specialize the primary classes further, and ascended classes. These classes are Project MMO skills, so all configuration is done inside of Project MMO. This mod just adds a system to obtain and manage those classes, as well as (configurable) limitations on how they work.

You gain classes by finding and using Class Insignias. You can manage your classes from the class screen, as well as remove classes if you want to get a new one. Classes, subclasses, and ascended classes can all be configured via Project MMO with interesting perks and attribute bonuses.

This mod was made for modpack creators. It WILL require you to configure these classes (which are just Project MMO skills). You can configure much about how the mod works with the config to suite your needs. This mod does not setup the class perks for you, nor does it add a way of obtaining these books. That is up to you on how you want them to work.

Please Read: The classes added in this mod are simply Project MMO skills in the same way that endurance, swimming, and combat are skills. Instead of gaining these skills through actions in game, you gain them by using these insignias. When you gain the rogue class, you are simply gaining 1 level of the rogue skill. You can add perks to the rogue skill in the Project MMO perks config just like you add perks to any other skill. You will also need to add this skill to your skills config in Project MMO. Subclasses and ascended classes are also just skills. A list of all the skills added by this mod are at the bottom of this page. Please see the How to Use section below for a couple example perks for the rogue class and wizard class to get you going.

Primary Classes

You can gain classes in all 13 D&D classes: Artificer, Barbarian, Bard, Cleric, Druid, Fighter, Monk, Paladin, Ranger, Rogue, Sorcerer, Warlock, and Wizard.

You do this by finding one of 4 insignias, one for each class group:

Red Insignia - Warrior [Barbarian, Fighter, Monk]

White Insignia - Priest [Cleric, Druid, Paladin]

Purple Insignia - Mage [Wizard, Warlock, Sorcerer]

Teal Insignia - Expert [Artificer, Bard, Ranger, Rogue]

There are 4 levels of insignia:

• Iron - Grants a level 1 class - Costs 20 levels
• Gold - Upgrades a class to level 2 - Costs 25 levels
• Emerald - Upgrades a class to level 3 - Costs 30 levels
• Diamond - Upgrades a class to level 4, the max - Costs 40 levels

Sub Classes

Each class has 3 subclass options, of which you can only have one at a time. You must be level 2 in the class in order to take a subclass. They are gained by finding a subclass insignia. 

Similarly to primary class insignias, use one to pick one of the three subclass options available. It costs 30 levels to use. If you already have a subclass you can use the item again and pick a different one to change it to the new one. Here are the Fighter options:

Ascended Classes

Ascended classes are gained when you reach level 4 in both your primary classes, which is the max level. Ascended classes are unique to the two classes you have, so there are 78 different ascended classes. Here are a few examples:

Fighter + Paladin = Warborn (pictured above)

Sorcerer + Warlock = Scion

Bard + Rogue = Nightsong

Managing Classes

You can manage your classes by opening your manage classes screen (default 'O'). This screen lists out your classes, their current levels, subclasses, and if you have an ascended class. It is pictured above.

If you hover over one of your classes a button with a red 'X' will appear. This allows you to delete a class. Be warned, this is irreversible and you will lose any associated subclasses and ascended classes related to the class being removed.

How to Use

No insignias are added to the game by default, nor are any of the perks configured for these classes. This simply gives you a system to gain and manage class skills for Project MMO. These classes are simply Project MMO skills, so in order to give them functionality you will need to add the proper skill to your Project MMO skills config, and perks for those skills to the perks config. All skills are listed at the very bottom for your convenience. I would be careful about granting experience to these skills in any other way than this mod adds or it won't work quite right. 

On top of configuring perks for each class, subclass, and ascended class, you will need to add these items to loot tables of your choosing.

First lets add an entry for rogue to Project MMO skills config. In 1.20.1 this would be found in the serverconfig folder in your world folder. Here's what that entry could look like. I included built in logos you can use for these skills if you want to show them in the skills list. Since you can view these skills in your class management screen though, I would recommend hiding them from the skills list in the client config by setting showInList to false. 

[Skills.Entry.rogue]
	maxLevel = 2147483647
	displayGroupName = false
	useTotalLevels = false
	color = 16777215
	showInList = false
	icon = "pmmo_classes:textures/classes/rogue.png"
	iconSize = 21
	noAfkPenalty = false

You will need to add an entry for every single class, subclass, and ascended class that the players have access to. If you set the showInList to false then you don't need to worry about icons or colors. Just let the class management screen handle that visibility for you. I have custom icons for the primary classes, just modify the icon string above for each class.

If you wanted to make it so someone with the rogue class turned invisible when they crouched you would add this to your pmmo perks config file (in project mmo, not this mod).

[[Perks.For_Event.CROUCH]]
	skill = "rogue"
	perk = "pmmo:effect"
	effect = "minecraft:invisibility"
	duration = 10
	per_level = 1
	min_level = 1
	max_level = 4
	ambient = true

If you wanted to make it so someone with the wizard class gained mana for Iron's Spells and Spellbooks you would add this to your Project MMO perks config:

[[Perks.For_Event.SKILL_UP]]
	skill = "wizard"
	perk = "pmmo:attribute"
	attribute = "irons_spellbooks:max_mana"
	per_level = 100.0
	max_boost = 400.0

You can use any attribute from any mod, or any project mmo perks to configure the class effect. You can even create your own custom perks, consult Project MMO for how to do this. Everything is integrated into Project MMO, please direct questions there for configuring perks for skills.

Recommended Implementation

I recommend starting with the primary class skills and creating perks for level 1. Then integrating the iron insignias into the game via mob loot tables, chests, achievement rewards, store items, villager trades, recipes etc, which are all doable via vanilla minecraft datapacks. You can get even fancier with it with something like KubeJS.

Then add level 2 perks if you didn't make them incremental from level 1, as well as the items. Now that players can reach level 2 I would focus on subclass skills since they can now take subclasses.

Then add level 3 and 4 perks for all primary classes, as well as the emerald and diamond insignias needed to advance to those levels.

Finally, now that players have perks up to level 4 for all classes and can achieve level 4 in all classes, add perks for all ascended classes. You can disable ascended classes until you are ready to turn them on while still letting players get to level 4 in a primary class. Every time a player logs on it checks all of their primary, sub, and ascended classes and fixes whatever is wrong. This includes deleting extra classes or granting ascended classes.

Items Added

This mod adds 4 groups of insignias, each one granting a different level of a different class group. There are also 13 different subclass insignias that allow you to take a subclass, one for each primary class.

Skill Lists

These are the skills you will need to configure in Project MMO in order to configure or add perks to make them actually do something. I highly recommend a mod that adds attributes, or using mod attributes added by mods like Iron's Spells and Spellbooks or Ars Noveau to integrate these skills into other mod's systems.

Primary Class Skills

Subclass Skills

Ascended Class Skills

This mod adds a highly configurable class system to Project MMO.

There are 3 types of classes you can gain, primary classes like Wizard and Fighter, subclasses which specialize the primary classes further, and ascended classes. These classes are Project MMO skills, so all configuration is done inside of Project MMO. This mod just adds a system to obtain and manage those classes, as well as (configurable) limitations on how they work. A list of all of the skills are down below.

You gain classes by finding and using Class Insignias. You can manage your classes from the class screen, as well as remove classes if you want to get a new one. Classes, subclasses, and ascended classes can all be configured via Project MMO with interesting perks and attribute bonuses.

You can configure much about how the mod works with the config to suite your needs.

Primary Classes

You can gain classes in all 13 D&D classes: Artificer, Barbarian, Bard, Cleric, Druid, Fighter, Monk, Paladin, Ranger, Rogue, Sorcerer, Warlock, and Wizard.

You do this by finding one of 4 insignias, one for each class group:

Red Insignia - Warrior [Barbarian, Fighter, Monk]

White Insignia - Priest [Cleric, Druid, Paladin]

Purple Insignia - Mage [Wizard, Warlock, Sorcerer]

Teal Insignia - Expert [Artificer, Bard, Ranger, Rogue]

There are 4 levels of insignia:

• Iron - Grants a level 1 class - Costs 20 levels
• Gold - Upgrades a class to level 2 - Costs 25 levels
• Emerald - Upgrades a class to level 3 - Costs 30 levels
• Diamond - Upgrades a class to level 4, the max - Costs 40 levels

Sub Classes

Each class has 3 subclass options, of which you can only have one at a time. You must be level 2 in the class in order to take a subclass. They are gained by finding a subclass insignia. 

Similarly to primary class insignias, use one to pick one of the three subclass options available. It costs 30 levels to use. If you already have a subclass you can use the item again and pick a different one to change it to the new one. Here are the Fighter options:

Ascended Classes

Ascended classes are gained when you reach level 4 in both your primary classes, which is the max level. Ascended classes are unique to the two classes you have, so there are 78 different ascended classes. Here are a few examples:

Fighter + Paladin = Warborn (pictured above)

Sorcerer + Warlock = Scion

Bard + Rogue = Nightsong

Managing Classes

You can manage your classes by opening your manage classes screen (default 'O'). This screen lists out your classes, their current levels, subclasses, and if you have an ascended class. It is pictured above.

If you hover over one of your classes a button with a red 'X' will appear. This allows you to delete a class. Be warned, this is irreversible and you will lose any associated subclasses and ascended classes related to the class being removed.

Use

No insignias are added to the game by default, nor are any of the perks configured for these classes. This simply gives you a system to gain and manage class skills for Project MMO. These classes are simply Project MMO skills, so in order to give them functionality you will need to add the proper skill to your Project MMO perks (all listed below), or anywhere else you want to use it. I would be careful about granting experience to these skills in any other way than this mod adds or it won't work quite right. On top of configuring perks for each class, subclass, and ascended class, you will need to add these items to loot tables of your choosing. 

Recommended Implementation

I recommend starting with the primary class skills and creating perks for level 1. Then integrating the iron insignias into the game via mob loot tables, chests, achievement rewards, store items, villager trades, recipes etc, which are all doable via vanilla minecraft datapacks. You can get even fancier with it with something like KubeJS.

Then add level 2 perks if you didn't make them incremental from level 1, as well as the items. Now that players can reach level 2 I would focus on subclass skills since they can now take subclasses.

Then add level 3 and 4 perks for all primary classes, as well as the emerald and diamond insignias needed to advance to those levels.

Finally, now that players have perks up to level 4 for all classes and can achieve level 4 in all classes, add perks for all ascended classes. You can disable ascended classes until you are ready to turn them on while still letting players get to level 4 in a primary class. Every time a player logs on it checks all of their primary, sub, and ascended classes and fixes whatever is wrong. This includes deleting extra classes or granting ascended classes.

Items Added

This mod adds 4 groups of insignias, each one granting a different level of a different class group. There are also 13 different subclass insignias that allow you to take a subclass, one for each primary class.

Skill Lists

These are the skills you will need to configure in Project MMO in order to configure or add perks to make them actually do something. I highly recommend a mod that adds attributes, or using mod attributes added by mods like Iron's Spells and Spellbooks or Ars Noveau to integrate these skills into other mod's systems.

Primary Class Skills

Subclass Skills

Ascended Class Skills