My first: Character creation class

From Divinity Engine Wiki
Revision as of 13:42, 11 September 2017 by Apostol (talk | contribs)
Jump to: navigation, search

Getting started

The Divinity Engine uses XML style file presets in order to load in the available classes during character creation. This data driven approach allows us to define custom presets in character creation in the blink of an eye. The first thing you need to know when creating your first character creation class is the location of the preset files. You can find those located inside : YourMod/CharacterCreation/ClassPresets (If the directory doesn't exist, you can just create it yourself).

Once you find or create the directory inside of your mod, you can just place the provided template file - - inside of it. If you load up character creation now and cycle through the presets, you should be able to see something like the following:
CustomClass.png

Preset breakdown

Now that we've loaded our class preset let's take a look at the most important properties

Class Name

The name of the class which is displayed to the user. The handle property is set to ls::TranslatedStringRepository::s_HandleUnknown by default in order to signal that this string has not been localized for other languages yet.

Class Type

This is the string which is used by code in order to identify the class with its unique type. It doesn't need to be the same as the Class Name, but it is nice to be similar for readability's sake.

Skill Set

This is the skill set name which this preset is assigned by default (the skill set must be defined in the data).

Starting Points

There are four properties under this category : Talents, Attributes, Combat and Civil ability points. Tweaking these will make your class start with a different amount of points available to spend.

Equipment Properties

As you can see the equipment properties are a bit different. They are a list, which specifies the equipment set that each race will wear during the preview in character creation. There are two equipment sets. We use one for the preview and the other when starting the game. Depending on your use case, you can fill in the same equipment set for both. N.B: If you add a custom race, you'll need to fill it in this list as well

Ability, Talent and Attribute Changes

Remember the starting points we defined earlier? We need to tell the game how to distribute those points by default. That's exactly what these properties define. Make sure you don't add more abilities/talents/attributes than you have to spend or the game won't like it and won't allocate them.