Alena: Alena uploaded a new version of File:Dwarves Female ABC.zip

My first: Character

2017-10-12T08:36:55Z

Alena: /* Downloadable files */

Creating a character can be roughly divided into three parts: 
* Creating a creature (monster or animal)
* Creating body parts and hairstyles (heads, hairstyles, beards)
* Creating Armor
 
Creating custom characters is a very technical and complicated process. It will require artistic skills and profound knowledge of 3d modelling, texturing, rigging, skinning, animation and Larian editor. 
''If you do not possess all the skills mentioned above and still want to make custom characters we strongly recommend reusing existing rigs and animations. ''

To make a creature you can either: 
* Make your own custom creature, rig, animations
* Make your own custom creature that will use already existing rig and animations (recommended)

Larian pipeline of creature creation in a nutshell:
# Concept
# Creation a high poly asset in zbrush
# Retopo, unwrap
# Texturing
# Testing your mesh in the editor
# Rigging
# Skinning
# Animating
''Note: if you're reusing existing rig you can skip #6 and #8'' 
 
== File formats ==

In the editor 3d models are saved as granny files (.GR2). 
The textures are saved as DirectDraw Surface (.dds). 
{| class="wikitable"
|-
| More info on Granny 3D can be found [http://www.radgametools.com/granny.html here]
|-
| More info on DirectDraw Surface can be found [https://en.wikipedia.org/wiki/DirectDraw_Surface here]
|-
|}

== Creature editor set-up ==
Lets take an example of the troll creature. 
To be able to implement a troll creature in the game you need: 
Resources: 
* 3d model
* Textures: Base Map(BM) Normal map (NM) and Physical map(PM)
* Material
* Physics mesh
* Ragdoll mesh
* Animation files (won't be covered in this guide)
Special editor files (more on them later): 
* Visual Set
* Root Template
 
Example file of the troll creature: [[:File:Creatures_Troll_ABC.zip|Troll example]] 
Example of all the resource files in content browser: 
[[File:Troll ContentBrowserResourses.jpeg|none]]

== Modelling ==
'''General modelling tips: '''
* All the joints areas should have the proper cuts (bending cuts- see below), aligned accordingly along with the respective naked model of the race you’re modeling.
* The armors are using the same rig as the naked model, joints need to be placed correctly, with as similar cuts as possible.
* No Scaling applied to the meshes: reset X-form.
* No N-gons. Only 3 (triangles) and 4-gons (quads) are allowed.
* Delete any unused vertices and floating triangles.
 

[[File:Joints1.jpeg|none]]
Reasons for the Cuts: 
The cuts that are made will be used to squash and stretch at joint areas. 
[[File:Joints2.jpeg|none]]
The green and red meshes are skinned to the same rig and posed in the same way. 
The green mesh has the correct shapes to create a nice rolling bend of the knee.
whilst the red mesh is missing the shapes and cannot be bend in the same way. 
[[File:Joints3.jpeg|none]]
When creating the shapes there must be enhough space to straigten the leg
the red mesh has a shape to small to straighten the leg without it collapsing on itself 
[[File:Joints4.jpeg|none]]
In this example the shapes do not match the location of the kneejoint
and there for are not used in the skinning. 
Make sure when creating the mesh to look at the '''size''' of the shape and '''location''' of the joints. 

[[File:Fingers.jpeg|none]]
When making the Fingers make sure they all rotate the same way in their base position 
* Bottom of feet should be as flat as possible.
* Use smoothing groups sparingly AND intelligently: don’t use 32 smoothing groups when 4 is enough.
* Make sure the armor/clothing pieces are not clipping through one another.
* The vertices along the center world line (symmetry line) should be obviously aligned correctly in the center.
* Close your armor pieces: the player starts with a naked model then can individually dress up his character with any armor piece you’re going to make. It is therefore important there are no holes. Also, make sure your Lowerbody and Upperbody pieces hide the cut at the waistline level.
* About objects that can bend (e.g. tails), don't put concave (=bending inwards) curves in it. They should be as straight as possible in neutral pose.
* Final character should be centered on origin (x0,y0,z0) and fit the naked model provided.
 
Don't forget to make a physics mesh for your character, it needs it to collide with environment and so the player can click and select your character on the screen.

== Textures ==
 
In DOS2 we use f Physically-Based Rendering (PBR). 
To learn more about PBR you can read [https://www.allegorithmic.com/pbr-guide PBR Guide by Allegorithmic here]. 
 
A creature, like troll, usually needs basemap (BM), normal map(NM) and physical map(PM) textures. 
Larian editor uses .dds textures. 
Texture examples: 
[[File:TextureExamplesTroll.jpeg|none]] 
We pack Metallness in the Red channel, Roughness in the Green channel and Ambient Occlusion in the Blue channel of Physical map. 
''Why our NM and PM textures look different from the ones used in other game engines ?'' 
-In image files (including dds) the red channel gets the least bytes assigned to it this causes some detail loss which you don't want. 
To circumvent it/improve quality, we swivel our red channel into the alpha channel to instead of outputting RGB with output xGBR maps. 
Larian primarily uses Substance Painter for texturing our characters and assets. [https://www.allegorithmic.com/buy You can get/try it here]. 
 
== Materials ==
 
After you imported your mesh and textures in the editor you need to create a material. 
We have a couple of Larian materials(shaders) you can use: 
[[File:Materials.jpeg|none]] character folder: [[File:CharacterMaterials.jpeg|none]] 
Character materials have fresnel effect on them so you can see your character in various environment and it also has MSK system, that helps you change colors on certan things like skin and cloths (more on MSK later). 
If you don't need this functionality you can use any material from the "Base_PBR" folder. 
After you created your material assign your textures in it and assign material to your mesh. (double click on material in content browser; double click on the mesh in content browser) 
If your are not using MSK but still want to use character material, just leave it empty (don't enable it in the box) or assign a black texture to it. 
You can edit the functionality of the material by right clicking it in content browser and selecting "Open in editor". 
[[File:MaterialEditor2.jpeg|none]] 
Beware if you make changes and save the material all the assets that are using the material will change accordingly. 
You can always make edits and "save as" a separate copy for testing purposes. 
Material source file can be easily changed if you select your material in the content browser and go to the side bar. 
[[File:MaterialSourceFile.jpeg|none]] 
If you change the sourcefile of the material you need to reassign textures. 
You can also see a "Material Type" parameter in the side bar of the material. the parameter will trigger different sound effects in the game depending in the type of your material, so don't leave it unassigned. 
== Visual Sets ==
Visual sets are special editor files, which help us organizing characters, their armor, body parts and colors. 
It also possible to a create without the visual set, in case you don't need any functionality mentioned above. 
Visual Set consists of 9 visual lists, where you can put meshes and 3 color lists where you can store colors. 
Visual set example: 
[[File:VisualSetExample.jpeg|none]] 
If you're working on a unique creature that doesn't need as many equipment pieces as our regular characters, you can put armor meshes in any visual list. (the names in brackets are for your convenience and consistency). 
Although it is recommended to keep something in either list #3(Torso) or #2(Head) because of material sounds functionality. 
Our troll example visual set:
[[File:TrollVisualSetExample2.jpeg|none]] 
Troll creature doesn't need to equip armor so it has some unique meshes in visual 3 (torso) list. 
!Important! You can also leave the meshes unassigned meshes by pressing "X" button. 
Space in the visual set is very limited, cause each visual set is stored in unit64. So you might have to create multiple visual sets for different armors. 
 

'''Colors in the visual set''' 
There are 3 color tabs in the Visual lists: Skin, Hair and Cloth colors. And 5 color rows you can change on the bottom. 
In the lists you can select and store colors. And in the rows on the bottom you can select colors from the list. 
[[File:VisualSetColors.jpeg|none]] 
To be able to edit colors from the visual set you need your mesh to use character pbr material and have MSKskin and/or MSKcloth. 
''Our MSK pipeline will be described below. ''

== Root Template ==
To be able to spawn a character in the editor you will need to create a root template for it. 
More advanced [[My_first:_Root_template|guide about root templates here]]
[[File:RootTemplateTroll.jpeg|none]] 
You will need to edit following parameters for your creature: 
* Ai Bounds - preferably a cylinder for the creature.
* DisplayName
* Physical Resource (physical mesh of your character)
* VisualResourseID - your actual mesh with the rig (could also be just a file with the rig)
* VisualSetResourseID (if any)
Make sure it has: 
* ExplodedResourseID
* ExplosionFX
* HitFX
* Icon
* RagdollResourseID
* Stats
Do not scale creatures unless you really need to. If scale a creature some animations, like climbing will not work properly. 
Small scale like 1.1 -1.3 is generally ok. 
Only use "IsPlayer" property for testing. 
Beware if you make your character "IsPlayer" the equipment system will not work properly. (More about equipment below) 

'''Root templates and Visual sets.'''
There are 3 ways of using visual sets for creatures in root templates: 
# Not using visual set for creatures - you put character mesh with all boned in VisualResourseID
# Using visual set only for armor/equipment for your character - character mesh with all boned in VisualResourseID + visual set with armor meshes, skinned to the character.
# Using visual set for both body parts and armor - just the rig with all bones in VisualResourseID +visual set with naked body parts and armor.
Most of the animals use #1, most of the creatures with equipment use #2 and ALL of NPC of our playable races use #3 approach. 

== Character creation visuals==
 
If you want to change Character Creation(CC) visuals you need to change "hero" root templates of our playable races: 
[[File:HeroRootTemplates.jpeg|none]] 
Hero root templates also have their own "hero" visual sets: 
[[File:HeroVisualSets.jpeg|none]] 
If you add/delete meshes from hero visual sets it will appear/disappear in Character Creation(CC). So to add/modify meshes in CC you just need to add them in those visual sets. 
Hair, Heads and Facial Features come from hero visual sets. while colors and armors in CC come from stats. 
To change the color selection available in character creation you need to change Race Presets files: 
[[File:racepresetsFile.jpeg|none]] 
To change or add color of the hair/skin you will need to change the value of the colors. 
Example of the value of the color: 
[[File:ExampleColorValue.jpeg|none]] 
Color value is "0xff" + it's Hex Color Code. So completely while color will be 0xffffffff; completely black - 0xff000000 

 
To change armor equipment and colors you will need to modify "ItemProgression", "Equipmet" and "Item Colors" stat files. Those will require more advanced knowledge. Guide on stats is still WIP here.

== Armor and Equipment ==
There is a difference in code between playable and NPC characters. NPC characters, as mentioned above, use visual sets for armor, while player characters use equipment. NPC visuals is just a rig in it's root template with all the armor and body parts stored in visual sets, while player characters have their naked body parts in them, which can't be unequiped, and are hidden when player equips armor from eq root templates. 
So when you make armor you need to ask yourself a question: 

''Do you want players to be able to equip your armor piece or is it going to be just a unique npc/creature armor? ''
'''If not:''' 
You just need to create a mesh, import it to editor and add it it your NPC visual set. 
'''If yes''' you will also need:
* Create meshes for each race and gender. So you need to have 8 meshes + 8 skeleton version variation.
* Your armor pieces needs to be made and cut the same way as already existing equipment, so they could fit with each other.
* Meshes need to be textured and masked the same way (read about MSK system below)
* Create separate eq root template and add your meshes to eq data.
* Create foldable mesh of your armor piece (Mesh that you see when you drop an armor piece on the ground)
* Crete an icon for your eq root template
* Give stats to your new equipment and make sure it can be generated for loot.

 
As an example you can check how Lizards female platemail armor is set up : 
[[:File:LizardFemalePlatemailExample.zip|Lizard Female files]] 
You will need to work in Lizards_Female_Armor_ABC, use other files as references. 
Note: if you export armor only include bones that you need, don't include entire skeleton. 
But! The character root should be always included. 
If you're making a helmet or any other piece of armor that only skinned to 1 bone, make it rigid. 
Go to "Extra Attributes" tab in maya and put "Rigid = true", otherwise it won't work in the editor. 
 

'''Cloth Simulation''' 
Cloth meshes shouldn't have any thickness. 
To add cloth simulation you need add "Cloth=1" in "Extra Attributes" tab in maya and add vertex paint on your mesh. 
Black for fixed vertices (0, 0, 0) Red for simulated vertices (255, 0 ,0) 
You can preview how it looks in the example file: 
[[File:ExampleFileCloth.jpeg|none]] 
In Maya, select your mesh -> go to Polygons tab -> Color -> Paint Vertex Color 
Make sure there are no elements with only red vertices. With no black vertices to fix the cloth in place it will fall apart to pieces. These pieces will fall through the level without being connected to anything. 
Make sure your cloth simulated mesh has only 1 smoothing group. To be sure in Maya, select your mesh -> go to Polygons tab -> Normals -> Soften Edge 
Try not to go too high poly with your cloth simulated meshes, as it will affect performance. Keep it <400 vertices per cloth mesh. 
Don't put cloth simulated meshes in the areas where they will bend (elbows, shoulders, knees) it won't look good. 
If you added cloth to a mesh when you double click on it in content browser you will be able to edit some cloth parameters: 
[[File:ClothParameters.jpeg|none]] 
Pose matching is one of the most important parameter you'll find there. Don't put it on 0 cause it will fly around too much. If you put it to high your cloth mesh will be too stiff or wouldn't simulate at all. Best results could be achieved when it's between 0.01 - 0.2 
 
'''Equipment root templates''' 
If you want to change existing equipment or add new one you'll have to work with eq roots. Each eq root has it's Equipment Data:
[[File:EqDataExample.jpeg|none]] 
You need to assign meshes to each race gender and tick the box if you want to deactivate any visual of any body part (usually you should). 
We have "Deactivate Equipment Slot Visuals" there as well, but it is used in very rare cases when we want to hide certain equipment slot whenever something is equipped. For example we have a very long robe that hides any trousers your character equips. 
 
'''Skeleton/Undead equipment''' 
Undeads are using the same rigs as alive characters versions so you can avoid remodeling entire mesh by just duplicating the existing mesh from the alive version and assigning Helper_Invisible_A material to the naked bodyparts in it. If the naked skin was baked in the texture you can use a different character material (replace the source file of the material to Characters_PRB_Skeletons from the CHaracters_PBR folder and reassign the textures) 
 
'''Hair and Helmets''' 
If you're are making an equip-able helmet you need to add a separate mesh with hair to it. It needs to be in the same granny but separate mesh with "_Hair_" in its name. In this case if a player is bald and equips your hair mesh from the helmet won't be rendered. 
[[File:HelmetHair.jpeg|none]] 
The hair and helmet is in one layer "Humans_Female_Armor_Mage_B_Helmet_A" hair is called Humans_Female_Armor_Mage_B_Hair_E_Mesh. If the player is bald and equips this helmet he'll only equip the hat.
 
== Downloadable files ==
Example files of the creatures Animals: 
[[:File:Animals_Bear_ABC.zip|Bear example]] 
[[:File:Animals_Boar_ABC.zip|Boar example]] 
[[:File:Animals_Cattle_ABC.zip|Cattle example]] 
[[:File:Animals_Crocodile_ABC.zip|Crocodile example]] 
[[:File:Animals_Deer_ABC.zip|Deer example]] 
[[:File:Animals_Dog_ABC.zip|Dog example]] 
[[:File:Animals_Frog_ABC.zip|Frog example]] 
[[:File:Animals_Pig_ABC.zip|Pig example]] 
[[:File:Animals_Rat_ABC.zip|Rat example]] 
[[:File:Animals_Salamander_ABC.zip|Salamander example]] 
[[:File:Animals_Squirrel_ABC.zip|Squirrel example]] 
[[:File:Animals_Tiger_ABC.zip|Tiger example]] 
[[:File:Animals_Turtle_ABC.zip|Turtle example]] 
[[:File:Animals_Wolf_ABC.zip|Wolf example]] 

Example files of the creatures Creatures: 
[[:File:Creatures_ElementalDevil_ABC.zip|ElementalDevil example]] 
[[:File:Creatures_Gheist_A.zip|Gheist example]] 
[[:File:Creatures_Giant_Insect_ABC.zip|Insect example]] 
[[:File:Creatures_Merman_ABC.zip|Merman example]] 
[[:File:Creatures_Nightmare_Werewolf_ABC.zip|Werewolf example]] 
[[:File:Creatures_Raanaar_Automaton_ABC.zip|Automaton example]] 
[[:File:Creatures_SourcePuppet_ABC.zip|SourcePuppet example]] 
[[:File:Creatures_Troll_ABC.zip|Troll example]] 

Playable Races Armor: 

[[:File:Humans_Male_ABC.zip|Human Male files]] 
[[:File:Humans_Female_ABC.zip|Human Female files]] 
[[:File:Dwarves_Female_ABC.zip|Dwarves Female files]] 
[[:File:Dwarves_Male_ABC.zip|Dwarves Male files]] 
[[:File:LizardFemalePlatemailExample.zip|Lizard Female files]] 
[[:File:Elves_Female_ABC.zip|Elves Female files]] 

[[:File:Weapons_REF_A.zip|Weapons REF]]

My first: Character

2017-10-11T15:40:29Z

Alena:

Creating a character can be roughly divided into three parts: 
* Creating a creature (monster or animal)
* Creating body parts and hairstyles (heads, hairstyles, beards)
* Creating Armor
 
Creating custom characters is a very technical and complicated process. It will require artistic skills and profound knowledge of 3d modelling, texturing, rigging, skinning, animation and Larian editor. 
''If you do not possess all the skills mentioned above and still want to make custom characters we strongly recommend reusing existing rigs and animations. ''

To make a creature you can either: 
* Make your own custom creature, rig, animations
* Make your own custom creature that will use already existing rig and animations (recommended)

Larian pipeline of creature creation in a nutshell:
# Concept
# Creation a high poly asset in zbrush
# Retopo, unwrap
# Texturing
# Testing your mesh in the editor
# Rigging
# Skinning
# Animating
''Note: if you're reusing existing rig you can skip #6 and #8'' 
 
== File formats ==

In the editor 3d models are saved as granny files (.GR2). 
The textures are saved as DirectDraw Surface (.dds). 
{| class="wikitable"
|-
| More info on Granny 3D can be found [http://www.radgametools.com/granny.html here]
|-
| More info on DirectDraw Surface can be found [https://en.wikipedia.org/wiki/DirectDraw_Surface here]
|-
|}

== Creature editor set-up ==
Lets take an example of the troll creature. 
To be able to implement a troll creature in the game you need: 
Resources: 
* 3d model
* Textures: Base Map(BM) Normal map (NM) and Physical map(PM)
* Material
* Physics mesh
* Ragdoll mesh
* Animation files (won't be covered in this guide)
Special editor files (more on them later): 
* Visual Set
* Root Template
 
Example file of the troll creature: [[:File:Creatures_Troll_ABC.zip|Troll example]] 
Example of all the resource files in content browser: 
[[File:Troll ContentBrowserResourses.jpeg|none]]

== Modelling ==
'''General modelling tips: '''
* All the joints areas should have the proper cuts (bending cuts- see below), aligned accordingly along with the respective naked model of the race you’re modeling.
* The armors are using the same rig as the naked model, joints need to be placed correctly, with as similar cuts as possible.
* No Scaling applied to the meshes: reset X-form.
* No N-gons. Only 3 (triangles) and 4-gons (quads) are allowed.
* Delete any unused vertices and floating triangles.
 

[[File:Joints1.jpeg|none]]
Reasons for the Cuts: 
The cuts that are made will be used to squash and stretch at joint areas. 
[[File:Joints2.jpeg|none]]
The green and red meshes are skinned to the same rig and posed in the same way. 
The green mesh has the correct shapes to create a nice rolling bend of the knee.
whilst the red mesh is missing the shapes and cannot be bend in the same way. 
[[File:Joints3.jpeg|none]]
When creating the shapes there must be enhough space to straigten the leg
the red mesh has a shape to small to straighten the leg without it collapsing on itself 
[[File:Joints4.jpeg|none]]
In this example the shapes do not match the location of the kneejoint
and there for are not used in the skinning. 
Make sure when creating the mesh to look at the '''size''' of the shape and '''location''' of the joints. 

[[File:Fingers.jpeg|none]]
When making the Fingers make sure they all rotate the same way in their base position 
* Bottom of feet should be as flat as possible.
* Use smoothing groups sparingly AND intelligently: don’t use 32 smoothing groups when 4 is enough.
* Make sure the armor/clothing pieces are not clipping through one another.
* The vertices along the center world line (symmetry line) should be obviously aligned correctly in the center.
* Close your armor pieces: the player starts with a naked model then can individually dress up his character with any armor piece you’re going to make. It is therefore important there are no holes. Also, make sure your Lowerbody and Upperbody pieces hide the cut at the waistline level.
* About objects that can bend (e.g. tails), don't put concave (=bending inwards) curves in it. They should be as straight as possible in neutral pose.
* Final character should be centered on origin (x0,y0,z0) and fit the naked model provided.
 
Don't forget to make a physics mesh for your character, it needs it to collide with environment and so the player can click and select your character on the screen.

== Textures ==
 
In DOS2 we use f Physically-Based Rendering (PBR). 
To learn more about PBR you can read [https://www.allegorithmic.com/pbr-guide PBR Guide by Allegorithmic here]. 
 
A creature, like troll, usually needs basemap (BM), normal map(NM) and physical map(PM) textures. 
Larian editor uses .dds textures. 
Texture examples: 
[[File:TextureExamplesTroll.jpeg|none]] 
We pack Metallness in the Red channel, Roughness in the Green channel and Ambient Occlusion in the Blue channel of Physical map. 
''Why our NM and PM textures look different from the ones used in other game engines ?'' 
-In image files (including dds) the red channel gets the least bytes assigned to it this causes some detail loss which you don't want. 
To circumvent it/improve quality, we swivel our red channel into the alpha channel to instead of outputting RGB with output xGBR maps. 
Larian primarily uses Substance Painter for texturing our characters and assets. [https://www.allegorithmic.com/buy You can get/try it here]. 
 
== Materials ==
 
After you imported your mesh and textures in the editor you need to create a material. 
We have a couple of Larian materials(shaders) you can use: 
[[File:Materials.jpeg|none]] character folder: [[File:CharacterMaterials.jpeg|none]] 
Character materials have fresnel effect on them so you can see your character in various environment and it also has MSK system, that helps you change colors on certan things like skin and cloths (more on MSK later). 
If you don't need this functionality you can use any material from the "Base_PBR" folder. 
After you created your material assign your textures in it and assign material to your mesh. (double click on material in content browser; double click on the mesh in content browser) 
If your are not using MSK but still want to use character material, just leave it empty (don't enable it in the box) or assign a black texture to it. 
You can edit the functionality of the material by right clicking it in content browser and selecting "Open in editor". 
[[File:MaterialEditor2.jpeg|none]] 
Beware if you make changes and save the material all the assets that are using the material will change accordingly. 
You can always make edits and "save as" a separate copy for testing purposes. 
Material source file can be easily changed if you select your material in the content browser and go to the side bar. 
[[File:MaterialSourceFile.jpeg|none]] 
If you change the sourcefile of the material you need to reassign textures. 
You can also see a "Material Type" parameter in the side bar of the material. the parameter will trigger different sound effects in the game depending in the type of your material, so don't leave it unassigned. 
== Visual Sets ==
Visual sets are special editor files, which help us organizing characters, their armor, body parts and colors. 
It also possible to a create without the visual set, in case you don't need any functionality mentioned above. 
Visual Set consists of 9 visual lists, where you can put meshes and 3 color lists where you can store colors. 
Visual set example: 
[[File:VisualSetExample.jpeg|none]] 
If you're working on a unique creature that doesn't need as many equipment pieces as our regular characters, you can put armor meshes in any visual list. (the names in brackets are for your convenience and consistency). 
Although it is recommended to keep something in either list #3(Torso) or #2(Head) because of material sounds functionality. 
Our troll example visual set:
[[File:TrollVisualSetExample2.jpeg|none]] 
Troll creature doesn't need to equip armor so it has some unique meshes in visual 3 (torso) list. 
!Important! You can also leave the meshes unassigned meshes by pressing "X" button. 
Space in the visual set is very limited, cause each visual set is stored in unit64. So you might have to create multiple visual sets for different armors. 
 

'''Colors in the visual set''' 
There are 3 color tabs in the Visual lists: Skin, Hair and Cloth colors. And 5 color rows you can change on the bottom. 
In the lists you can select and store colors. And in the rows on the bottom you can select colors from the list. 
[[File:VisualSetColors.jpeg|none]] 
To be able to edit colors from the visual set you need your mesh to use character pbr material and have MSKskin and/or MSKcloth. 
''Our MSK pipeline will be described below. ''

== Root Template ==
To be able to spawn a character in the editor you will need to create a root template for it. 
More advanced [[My_first:_Root_template|guide about root templates here]]
[[File:RootTemplateTroll.jpeg|none]] 
You will need to edit following parameters for your creature: 
* Ai Bounds - preferably a cylinder for the creature.
* DisplayName
* Physical Resource (physical mesh of your character)
* VisualResourseID - your actual mesh with the rig (could also be just a file with the rig)
* VisualSetResourseID (if any)
Make sure it has: 
* ExplodedResourseID
* ExplosionFX
* HitFX
* Icon
* RagdollResourseID
* Stats
Do not scale creatures unless you really need to. If scale a creature some animations, like climbing will not work properly. 
Small scale like 1.1 -1.3 is generally ok. 
Only use "IsPlayer" property for testing. 
Beware if you make your character "IsPlayer" the equipment system will not work properly. (More about equipment below) 

'''Root templates and Visual sets.'''
There are 3 ways of using visual sets for creatures in root templates: 
# Not using visual set for creatures - you put character mesh with all boned in VisualResourseID
# Using visual set only for armor/equipment for your character - character mesh with all boned in VisualResourseID + visual set with armor meshes, skinned to the character.
# Using visual set for both body parts and armor - just the rig with all bones in VisualResourseID +visual set with naked body parts and armor.
Most of the animals use #1, most of the creatures with equipment use #2 and ALL of NPC of our playable races use #3 approach. 

== Character creation visuals==
 
If you want to change Character Creation(CC) visuals you need to change "hero" root templates of our playable races: 
[[File:HeroRootTemplates.jpeg|none]] 
Hero root templates also have their own "hero" visual sets: 
[[File:HeroVisualSets.jpeg|none]] 
If you add/delete meshes from hero visual sets it will appear/disappear in Character Creation(CC). So to add/modify meshes in CC you just need to add them in those visual sets. 
Hair, Heads and Facial Features come from hero visual sets. while colors and armors in CC come from stats. 
To change the color selection available in character creation you need to change Race Presets files: 
[[File:racepresetsFile.jpeg|none]] 
To change or add color of the hair/skin you will need to change the value of the colors. 
Example of the value of the color: 
[[File:ExampleColorValue.jpeg|none]] 
Color value is "0xff" + it's Hex Color Code. So completely while color will be 0xffffffff; completely black - 0xff000000 

 
To change armor equipment and colors you will need to modify "ItemProgression", "Equipmet" and "Item Colors" stat files. Those will require more advanced knowledge. Guide on stats is still WIP here.

== Armor and Equipment ==
There is a difference in code between playable and NPC characters. NPC characters, as mentioned above, use visual sets for armor, while player characters use equipment. NPC visuals is just a rig in it's root template with all the armor and body parts stored in visual sets, while player characters have their naked body parts in them, which can't be unequiped, and are hidden when player equips armor from eq root templates. 
So when you make armor you need to ask yourself a question: 

''Do you want players to be able to equip your armor piece or is it going to be just a unique npc/creature armor? ''
'''If not:''' 
You just need to create a mesh, import it to editor and add it it your NPC visual set. 
'''If yes''' you will also need:
* Create meshes for each race and gender. So you need to have 8 meshes + 8 skeleton version variation.
* Your armor pieces needs to be made and cut the same way as already existing equipment, so they could fit with each other.
* Meshes need to be textured and masked the same way (read about MSK system below)
* Create separate eq root template and add your meshes to eq data.
* Create foldable mesh of your armor piece (Mesh that you see when you drop an armor piece on the ground)
* Crete an icon for your eq root template
* Give stats to your new equipment and make sure it can be generated for loot.

 
As an example you can check how Lizards female platemail armor is set up : 
[[:File:LizardFemalePlatemailExample.zip|Lizard Female files]] 
You will need to work in Lizards_Female_Armor_ABC, use other files as references. 
Note: if you export armor only include bones that you need, don't include entire skeleton. 
But! The character root should be always included. 
If you're making a helmet or any other piece of armor that only skinned to 1 bone, make it rigid. 
Go to "Extra Attributes" tab in maya and put "Rigid = true", otherwise it won't work in the editor. 
 

'''Cloth Simulation''' 
Cloth meshes shouldn't have any thickness. 
To add cloth simulation you need add "Cloth=1" in "Extra Attributes" tab in maya and add vertex paint on your mesh. 
Black for fixed vertices (0, 0, 0) Red for simulated vertices (255, 0 ,0) 
You can preview how it looks in the example file: 
[[File:ExampleFileCloth.jpeg|none]] 
In Maya, select your mesh -> go to Polygons tab -> Color -> Paint Vertex Color 
Make sure there are no elements with only red vertices. With no black vertices to fix the cloth in place it will fall apart to pieces. These pieces will fall through the level without being connected to anything. 
Make sure your cloth simulated mesh has only 1 smoothing group. To be sure in Maya, select your mesh -> go to Polygons tab -> Normals -> Soften Edge 
Try not to go too high poly with your cloth simulated meshes, as it will affect performance. Keep it <400 vertices per cloth mesh. 
Don't put cloth simulated meshes in the areas where they will bend (elbows, shoulders, knees) it won't look good. 
If you added cloth to a mesh when you double click on it in content browser you will be able to edit some cloth parameters: 
[[File:ClothParameters.jpeg|none]] 
Pose matching is one of the most important parameter you'll find there. Don't put it on 0 cause it will fly around too much. If you put it to high your cloth mesh will be too stiff or wouldn't simulate at all. Best results could be achieved when it's between 0.01 - 0.2 
 
'''Equipment root templates''' 
If you want to change existing equipment or add new one you'll have to work with eq roots. Each eq root has it's Equipment Data:
[[File:EqDataExample.jpeg|none]] 
You need to assign meshes to each race gender and tick the box if you want to deactivate any visual of any body part (usually you should). 
We have "Deactivate Equipment Slot Visuals" there as well, but it is used in very rare cases when we want to hide certain equipment slot whenever something is equipped. For example we have a very long robe that hides any trousers your character equips. 
 
'''Skeleton/Undead equipment''' 
Undeads are using the same rigs as alive characters versions so you can avoid remodeling entire mesh by just duplicating the existing mesh from the alive version and assigning Helper_Invisible_A material to the naked bodyparts in it. If the naked skin was baked in the texture you can use a different character material (replace the source file of the material to Characters_PRB_Skeletons from the CHaracters_PBR folder and reassign the textures) 
 
'''Hair and Helmets''' 
If you're are making an equip-able helmet you need to add a separate mesh with hair to it. It needs to be in the same granny but separate mesh with "_Hair_" in its name. In this case if a player is bald and equips your hair mesh from the helmet won't be rendered. 
[[File:HelmetHair.jpeg|none]] 
The hair and helmet is in one layer "Humans_Female_Armor_Mage_B_Helmet_A" hair is called Humans_Female_Armor_Mage_B_Hair_E_Mesh. If the player is bald and equips this helmet he'll only equip the hat.
 
== Downloadable files ==
Example files of the creatures Animals: 
[[:File:Animals_Bear_ABC.zip|Bear example]] 
[[:File:Animals_Boar_ABC.zip|Boar example]] 
[[:File:Animals_Cattle_ABC.zip|Cattle example]] 
[[:File:Animals_Crocodile_ABC.zip|Crocodile example]] 
[[:File:Animals_Deer_ABC.zip|Deer example]] 
[[:File:Animals_Dog_ABC.zip|Dog example]] 
[[:File:Animals_Frog_ABC.zip|Frog example]] 
[[:File:Animals_Pig_ABC.zip|Pig example]] 
[[:File:Animals_Rat_ABC.zip|Rat example]] 
[[:File:Animals_Salamander_ABC.zip|Salamander example]] 
[[:File:Animals_Squirrel_ABC.zip|Squirrel example]] 
[[:File:Animals_Tiger_ABC.zip|Tiger example]] 
[[:File:Animals_Turtle_ABC.zip|Turtle example]] 
[[:File:Animals_Wolf_ABC.zip|Wolf example]] 

Example files of the creatures Creatures: 
[[:File:Creatures_ElementalDevil_ABC.zip|ElementalDevil example]] 
[[:File:Creatures_Gheist_A.zip|Gheist example]] 
[[:File:Creatures_Giant_Insect_ABC.zip|Insect example]] 
[[:File:Creatures_Merman_ABC.zip|Merman example]] 
[[:File:Creatures_Nightmare_Werewolf_ABC.zip|Werewolf example]] 
[[:File:Creatures_Raanaar_Automaton_ABC.zip|Automaton example]] 
[[:File:Creatures_SourcePuppet_ABC.zip|SourcePuppet example]] 
[[:File:Creatures_Troll_ABC.zip|Troll example]] 

Playable Races Armor: 

[[:File:Humans_Male_ABC.zip|Human Male files]] 
[[:File:Humans_Female_ABC.zip|Human Female files]] 
[[:File:Dwarves_Female_ABC.zip|Dwarves Female files]] 
[[:File:Dwarves_Male_ABC.zip|Dwarves Male files]] 
[[:File:LizardFemalePlatemailExample.zip|Lizard Female files]]

File:Dwarves Male ABC.zip

2017-10-11T15:39:57Z

Alena:

File:Dwarves Female ABC.zip

2017-10-11T15:34:12Z

Alena:

My first: Character

2017-10-11T15:33:54Z

Alena: /* Downloadable files */

Creating a character can be roughly divided into three parts: 
* Creating a creature (monster or animal)
* Creating body parts and hairstyles (heads, hairstyles, beards)
* Creating Armor
 
Creating custom characters is a very technical and complicated process. It will require artistic skills and profound knowledge of 3d modelling, texturing, rigging, skinning, animation and Larian editor. 
''If you do not possess all the skills mentioned above and still want to make custom characters we strongly recommend reusing existing rigs and animations. ''

To make a creature you can either: 
* Make your own custom creature, rig, animations
* Make your own custom creature that will use already existing rig and animations (recommended)

Larian pipeline of creature creation in a nutshell:
# Concept
# Creation a high poly asset in zbrush
# Retopo, unwrap
# Texturing
# Testing your mesh in the editor
# Rigging
# Skinning
# Animating
''Note: if you're reusing existing rig you can skip #6 and #8'' 
 
== File formats ==

In the editor 3d models are saved as granny files (.GR2). 
The textures are saved as DirectDraw Surface (.dds). 
{| class="wikitable"
|-
| More info on Granny 3D can be found [http://www.radgametools.com/granny.html here]
|-
| More info on DirectDraw Surface can be found [https://en.wikipedia.org/wiki/DirectDraw_Surface here]
|-
|}

== Creature editor set-up ==
Lets take an example of the troll creature. 
To be able to implement a troll creature in the game you need: 
Resources: 
* 3d model
* Textures: Base Map(BM) Normal map (NM) and Physical map(PM)
* Material
* Physics mesh
* Ragdoll mesh
* Animation files (won't be covered in this guide)
Special editor files (more on them later): 
* Visual Set
* Root Template
 
Example file of the troll creature: [[:File:Creatures_Troll_ABC.zip|Troll example]] 
Example of all the resource files in content browser: 
[[File:Troll ContentBrowserResourses.jpeg|none]]

== Modelling ==
'''General modelling tips: '''
* All the joints areas should have the proper cuts (bending cuts- see below), aligned accordingly along with the respective naked model of the race you’re modeling.
* The armors are using the same rig as the naked model, joints need to be placed correctly, with as similar cuts as possible.
* No Scaling applied to the meshes: reset X-form.
* No N-gons. Only 3 (triangles) and 4-gons (quads) are allowed.
* Delete any unused vertices and floating triangles.
 

[[File:Joints1.jpeg|none]]
Reasons for the Cuts: 
The cuts that are made will be used to squash and stretch at joint areas. 
[[File:Joints2.jpeg|none]]
The green and red meshes are skinned to the same rig and posed in the same way. 
The green mesh has the correct shapes to create a nice rolling bend of the knee.
whilst the red mesh is missing the shapes and cannot be bend in the same way. 
[[File:Joints3.jpeg|none]]
When creating the shapes there must be enhough space to straigten the leg
the red mesh has a shape to small to straighten the leg without it collapsing on itself 
[[File:Joints4.jpeg|none]]
In this example the shapes do not match the location of the kneejoint
and there for are not used in the skinning. 
Make sure when creating the mesh to look at the '''size''' of the shape and '''location''' of the joints. 

[[File:Fingers.jpeg|none]]
When making the Fingers make sure they all rotate the same way in their base position 
* Bottom of feet should be as flat as possible.
* Use smoothing groups sparingly AND intelligently: don’t use 32 smoothing groups when 4 is enough.
* Make sure the armor/clothing pieces are not clipping through one another.
* The vertices along the center world line (symmetry line) should be obviously aligned correctly in the center.
* Close your armor pieces: the player starts with a naked model then can individually dress up his character with any armor piece you’re going to make. It is therefore important there are no holes. Also, make sure your Lowerbody and Upperbody pieces hide the cut at the waistline level.
* About objects that can bend (e.g. tails), don't put concave (=bending inwards) curves in it. They should be as straight as possible in neutral pose.
* Final character should be centered on origin (x0,y0,z0) and fit the naked model provided.
 
Don't forget to make a physics mesh for your character, it needs it to collide with environment and so the player can click and select your character on the screen.

== Textures ==
 
In DOS2 we use f Physically-Based Rendering (PBR). 
To learn more about PBR you can read [https://www.allegorithmic.com/pbr-guide PBR Guide by Allegorithmic here]. 
 
A creature, like troll, usually needs basemap (BM), normal map(NM) and physical map(PM) textures. 
Larian editor uses .dds textures. 
Texture examples: 
[[File:TextureExamplesTroll.jpeg|none]] 
We pack Metallness in the Red channel, Roughness in the Green channel and Ambient Occlusion in the Blue channel of Physical map. 
''Why our NM and PM textures look different from the ones used in other game engines ?'' 
-In image files (including dds) the red channel gets the least bytes assigned to it this causes some detail loss which you don't want. 
To circumvent it/improve quality, we swivel our red channel into the alpha channel to instead of outputting RGB with output xGBR maps. 
Larian primarily uses Substance Painter for texturing our characters and assets. [https://www.allegorithmic.com/buy You can get/try it here]. 
 
== Materials ==
 
After you imported your mesh and textures in the editor you need to create a material. 
We have a couple of Larian materials(shaders) you can use: 
[[File:Materials.jpeg|none]] character folder: [[File:CharacterMaterials.jpeg|none]] 
Character materials have fresnel effect on them so you can see your character in various environment and it also has MSK system, that helps you change colors on certan things like skin and cloths (more on MSK later). 
If you don't need this functionality you can use any material from the "Base_PBR" folder. 
After you created your material assign your textures in it and assign material to your mesh. (double click on material in content browser; double click on the mesh in content browser) 
If your are not using MSK but still want to use character material, just leave it empty (don't enable it in the box) or assign a black texture to it. 
You can edit the functionality of the material by right clicking it in content browser and selecting "Open in editor". 
[[File:MaterialEditor2.jpeg|none]] 
Beware if you make changes and save the material all the assets that are using the material will change accordingly. 
You can always make edits and "save as" a separate copy for testing purposes. 
Material source file can be easily changed if you select your material in the content browser and go to the side bar. 
[[File:MaterialSourceFile.jpeg|none]] 
If you change the sourcefile of the material you need to reassign textures. 
You can also see a "Material Type" parameter in the side bar of the material. the parameter will trigger different sound effects in the game depending in the type of your material, so don't leave it unassigned. 
== Visual Sets ==
Visual sets are special editor files, which help us organizing characters, their armor, body parts and colors. 
It also possible to a create without the visual set, in case you don't need any functionality mentioned above. 
Visual Set consists of 9 visual lists, where you can put meshes and 3 color lists where you can store colors. 
Visual set example: 
[[File:VisualSetExample.jpeg|none]] 
If you're working on a unique creature that doesn't need as many equipment pieces as our regular characters, you can put armor meshes in any visual list. (the names in brackets are for your convenience and consistency). 
Although it is recommended to keep something in either list #3(Torso) or #2(Head) because of material sounds functionality. 
Our troll example visual set:
[[File:TrollVisualSetExample2.jpeg|none]] 
Troll creature doesn't need to equip armor so it has some unique meshes in visual 3 (torso) list. 
!Important! You can also leave the meshes unassigned meshes by pressing "X" button. 
Space in the visual set is very limited, cause each visual set is stored in unit64. So you might have to create multiple visual sets for different armors. 
 

'''Colors in the visual set''' 
There are 3 color tabs in the Visual lists: Skin, Hair and Cloth colors. And 5 color rows you can change on the bottom. 
In the lists you can select and store colors. And in the rows on the bottom you can select colors from the list. 
[[File:VisualSetColors.jpeg|none]] 
To be able to edit colors from the visual set you need your mesh to use character pbr material and have MSKskin and/or MSKcloth. 
''Our MSK pipeline will be described below. ''

== Root Template ==
To be able to spawn a character in the editor you will need to create a root template for it. 
More advanced [[My_first:_Root_template|guide about root templates here]]
[[File:RootTemplateTroll.jpeg|none]] 
You will need to edit following parameters for your creature: 
* Ai Bounds - preferably a cylinder for the creature.
* DisplayName
* Physical Resource (physical mesh of your character)
* VisualResourseID - your actual mesh with the rig (could also be just a file with the rig)
* VisualSetResourseID (if any)
Make sure it has: 
* ExplodedResourseID
* ExplosionFX
* HitFX
* Icon
* RagdollResourseID
* Stats
Do not scale creatures unless you really need to. If scale a creature some animations, like climbing will not work properly. 
Small scale like 1.1 -1.3 is generally ok. 
Only use "IsPlayer" property for testing. 
Beware if you make your character "IsPlayer" the equipment system will not work properly. (More about equipment below) 

'''Root templates and Visual sets.'''
There are 3 ways of using visual sets for creatures in root templates: 
# Not using visual set for creatures - you put character mesh with all boned in VisualResourseID
# Using visual set only for armor/equipment for your character - character mesh with all boned in VisualResourseID + visual set with armor meshes, skinned to the character.
# Using visual set for both body parts and armor - just the rig with all bones in VisualResourseID +visual set with naked body parts and armor.
Most of the animals use #1, most of the creatures with equipment use #2 and ALL of NPC of our playable races use #3 approach. 

== Character creation visuals==
 
If you want to change Character Creation(CC) visuals you need to change "hero" root templates of our playable races: 
[[File:HeroRootTemplates.jpeg|none]] 
Hero root templates also have their own "hero" visual sets: 
[[File:HeroVisualSets.jpeg|none]] 
If you add/delete meshes from hero visual sets it will appear/disappear in Character Creation(CC). So to add/modify meshes in CC you just need to add them in those visual sets. 
Hair, Heads and Facial Features come from hero visual sets. while colors and armors in CC come from stats. 
To change the color selection available in character creation you need to change Race Presets files: 
[[File:racepresetsFile.jpeg|none]] 
To change or add color of the hair/skin you will need to change the value of the colors. 
Example of the value of the color: 
[[File:ExampleColorValue.jpeg|none]] 
Color value is "0xff" + it's Hex Color Code. So completely while color will be 0xffffffff; completely black - 0xff000000 

 
To change armor equipment and colors you will need to modify "ItemProgression", "Equipmet" and "Item Colors" stat files. Those will require more advanced knowledge. Guide on stats is still WIP here.

== Armor and Equipment ==
There is a difference in code between playable and NPC characters. NPC characters, as mentioned above, use visual sets for armor, while player characters use equipment. NPC visuals is just a rig in it's root template with all the armor and body parts stored in visual sets, while player characters have their naked body parts in them, which can't be unequiped, and are hidden when player equips armor from eq root templates. 
So when you make armor you need to ask yourself a question: 

''Do you want players to be able to equip your armor piece or is it going to be just a unique npc/creature armor? ''
'''If not:''' 
You just need to create a mesh, import it to editor and add it it your NPC visual set. 
'''If yes''' you will also need:
* Create meshes for each race and gender. So you need to have 8 meshes + 8 skeleton version variation.
* Your armor pieces needs to be made and cut the same way as already existing equipment, so they could fit with each other.
* Meshes need to be textured and masked the same way (read about MSK system below)
* Create separate eq root template and add your meshes to eq data.
* Create foldable mesh of your armor piece (Mesh that you see when you drop an armor piece on the ground)
* Crete an icon for your eq root template
* Give stats to your new equipment and make sure it can be generated for loot.

 
As an example you can check how Lizards female platemail armor is set up : 
[[:File:LizardFemalePlatemailExample.zip|Lizard Female files]] 
You will need to work in Lizards_Female_Armor_ABC, use other files as references. 
Note: if you export armor only include bones that you need, don't include entire skeleton. 
But! The character root should be always included. 
If you're making a helmet or any other piece of armor that only skinned to 1 bone, make it rigid. 
Go to "Extra Attributes" tab in maya and put "Rigid = true", otherwise it won't work in the editor. 
 

'''Cloth Simulation''' 
Cloth meshes shouldn't have any thickness. 
To add cloth simulation you need add "Cloth=1" in "Extra Attributes" tab in maya and add vertex paint on your mesh. 
Black for fixed vertices (0, 0, 0) Red for simulated vertices (255, 0 ,0) 
You can preview how it looks in the example file: 
[[File:ExampleFileCloth.jpeg|none]] 
In Maya, select your mesh -> go to Polygons tab -> Color -> Paint Vertex Color 
Make sure there are no elements with only red vertices. With no black vertices to fix the cloth in place it will fall apart to pieces. These pieces will fall through the level without being connected to anything. 
Make sure your cloth simulated mesh has only 1 smoothing group. To be sure in Maya, select your mesh -> go to Polygons tab -> Normals -> Soften Edge 
Try not to go too high poly with your cloth simulated meshes, as it will affect performance. Keep it <400 vertices per cloth mesh. 
Don't put cloth simulated meshes in the areas where they will bend (elbows, shoulders, knees) it won't look good. 
If you added cloth to a mesh when you double click on it in content browser you will be able to edit some cloth parameters: 
[[File:ClothParameters.jpeg|none]] 
Pose matching is one of the most important parameter you'll find there. Don't put it on 0 cause it will fly around too much. If you put it to high your cloth mesh will be too stiff or wouldn't simulate at all. Best results could be achieved when it's between 0.01 - 0.2 
 
'''Equipment root templates''' 
If you want to change existing equipment or add new one you'll have to work with eq roots. Each eq root has it's Equipment Data:
[[File:EqDataExample.jpeg|none]] 
You need to assign meshes to each race gender and tick the box if you want to deactivate any visual of any body part (usually you should). 
We have "Deactivate Equipment Slot Visuals" there as well, but it is used in very rare cases when we want to hide certain equipment slot whenever something is equipped. For example we have a very long robe that hides any trousers your character equips. 
 
'''Skeleton/Undead equipment''' 
Undeads are using the same rigs as alive characters versions so you can avoid remodeling entire mesh by just duplicating the existing mesh from the alive version and assigning Helper_Invisible_A material to the naked bodyparts in it. If the naked skin was baked in the texture you can use a different character material (replace the source file of the material to Characters_PRB_Skeletons from the CHaracters_PBR folder and reassign the textures) 
 
'''Hair and Helmets''' 
If you're are making an equip-able helmet you need to add a separate mesh with hair to it. It needs to be in the same granny but separate mesh with "_Hair_" in its name. In this case if a player is bald and equips your hair mesh from the helmet won't be rendered. 
[[File:HelmetHair.jpeg|none]] 
The hair and helmet is in one layer "Humans_Female_Armor_Mage_B_Helmet_A" hair is called Humans_Female_Armor_Mage_B_Hair_E_Mesh. If the player is bald and equips this helmet he'll only equip the hat.
 
== Downloadable files ==
Example files of the creatures Animals: 
[[:File:Animals_Bear_ABC.zip|Bear example]] 
[[:File:Animals_Boar_ABC.zip|Boar example]] 
[[:File:Animals_Cattle_ABC.zip|Cattle example]] 
[[:File:Animals_Crocodile_ABC.zip|Crocodile example]] 
[[:File:Animals_Deer_ABC.zip|Deer example]] 
[[:File:Animals_Dog_ABC.zip|Dog example]] 
[[:File:Animals_Frog_ABC.zip|Frog example]] 
[[:File:Animals_Pig_ABC.zip|Pig example]] 
[[:File:Animals_Rat_ABC.zip|Rat example]] 
[[:File:Animals_Salamander_ABC.zip|Salamander example]] 
[[:File:Animals_Squirrel_ABC.zip|Squirrel example]] 
[[:File:Animals_Tiger_ABC.zip|Tiger example]] 
[[:File:Animals_Turtle_ABC.zip|Turtle example]] 
[[:File:Animals_Wolf_ABC.zip|Wolf example]] 

Example files of the creatures Creatures: 
[[:File:Creatures_ElementalDevil_ABC.zip|ElementalDevil example]] 
[[:File:Creatures_Gheist_A.zip|Gheist example]] 
[[:File:Creatures_Giant_Insect_ABC.zip|Insect example]] 
[[:File:Creatures_Merman_ABC.zip|Merman example]] 
[[:File:Creatures_Nightmare_Werewolf_ABC.zip|Werewolf example]] 
[[:File:Creatures_Raanaar_Automaton_ABC.zip|Automaton example]] 
[[:File:Creatures_SourcePuppet_ABC.zip|SourcePuppet example]] 
[[:File:Creatures_Troll_ABC.zip|Troll example]] 

Playable Races Armor: 

[[:File:Humans_Male_ABC.zip|Human Male files]] 
[[:File:Humans_Female_ABC.zip|Human Female files]] 
[[:File:Dwarves_Female_ABC.zip|Dwarves Female files]] 
[[:File:LizardFemalePlatemailExample.zip|Lizard Female files]]

File:Humans Male ABC.zip

2017-10-11T15:24:59Z

Alena:

My first: Character

2017-10-11T15:24:50Z

Alena:

Creating a character can be roughly divided into three parts: 
* Creating a creature (monster or animal)
* Creating body parts and hairstyles (heads, hairstyles, beards)
* Creating Armor
 
Creating custom characters is a very technical and complicated process. It will require artistic skills and profound knowledge of 3d modelling, texturing, rigging, skinning, animation and Larian editor. 
''If you do not possess all the skills mentioned above and still want to make custom characters we strongly recommend reusing existing rigs and animations. ''

To make a creature you can either: 
* Make your own custom creature, rig, animations
* Make your own custom creature that will use already existing rig and animations (recommended)

Larian pipeline of creature creation in a nutshell:
# Concept
# Creation a high poly asset in zbrush
# Retopo, unwrap
# Texturing
# Testing your mesh in the editor
# Rigging
# Skinning
# Animating
''Note: if you're reusing existing rig you can skip #6 and #8'' 
 
== File formats ==

In the editor 3d models are saved as granny files (.GR2). 
The textures are saved as DirectDraw Surface (.dds). 
{| class="wikitable"
|-
| More info on Granny 3D can be found [http://www.radgametools.com/granny.html here]
|-
| More info on DirectDraw Surface can be found [https://en.wikipedia.org/wiki/DirectDraw_Surface here]
|-
|}

== Creature editor set-up ==
Lets take an example of the troll creature. 
To be able to implement a troll creature in the game you need: 
Resources: 
* 3d model
* Textures: Base Map(BM) Normal map (NM) and Physical map(PM)
* Material
* Physics mesh
* Ragdoll mesh
* Animation files (won't be covered in this guide)
Special editor files (more on them later): 
* Visual Set
* Root Template
 
Example file of the troll creature: [[:File:Creatures_Troll_ABC.zip|Troll example]] 
Example of all the resource files in content browser: 
[[File:Troll ContentBrowserResourses.jpeg|none]]

== Modelling ==
'''General modelling tips: '''
* All the joints areas should have the proper cuts (bending cuts- see below), aligned accordingly along with the respective naked model of the race you’re modeling.
* The armors are using the same rig as the naked model, joints need to be placed correctly, with as similar cuts as possible.
* No Scaling applied to the meshes: reset X-form.
* No N-gons. Only 3 (triangles) and 4-gons (quads) are allowed.
* Delete any unused vertices and floating triangles.
 

[[File:Joints1.jpeg|none]]
Reasons for the Cuts: 
The cuts that are made will be used to squash and stretch at joint areas. 
[[File:Joints2.jpeg|none]]
The green and red meshes are skinned to the same rig and posed in the same way. 
The green mesh has the correct shapes to create a nice rolling bend of the knee.
whilst the red mesh is missing the shapes and cannot be bend in the same way. 
[[File:Joints3.jpeg|none]]
When creating the shapes there must be enhough space to straigten the leg
the red mesh has a shape to small to straighten the leg without it collapsing on itself 
[[File:Joints4.jpeg|none]]
In this example the shapes do not match the location of the kneejoint
and there for are not used in the skinning. 
Make sure when creating the mesh to look at the '''size''' of the shape and '''location''' of the joints. 

[[File:Fingers.jpeg|none]]
When making the Fingers make sure they all rotate the same way in their base position 
* Bottom of feet should be as flat as possible.
* Use smoothing groups sparingly AND intelligently: don’t use 32 smoothing groups when 4 is enough.
* Make sure the armor/clothing pieces are not clipping through one another.
* The vertices along the center world line (symmetry line) should be obviously aligned correctly in the center.
* Close your armor pieces: the player starts with a naked model then can individually dress up his character with any armor piece you’re going to make. It is therefore important there are no holes. Also, make sure your Lowerbody and Upperbody pieces hide the cut at the waistline level.
* About objects that can bend (e.g. tails), don't put concave (=bending inwards) curves in it. They should be as straight as possible in neutral pose.
* Final character should be centered on origin (x0,y0,z0) and fit the naked model provided.
 
Don't forget to make a physics mesh for your character, it needs it to collide with environment and so the player can click and select your character on the screen.

== Textures ==
 
In DOS2 we use f Physically-Based Rendering (PBR). 
To learn more about PBR you can read [https://www.allegorithmic.com/pbr-guide PBR Guide by Allegorithmic here]. 
 
A creature, like troll, usually needs basemap (BM), normal map(NM) and physical map(PM) textures. 
Larian editor uses .dds textures. 
Texture examples: 
[[File:TextureExamplesTroll.jpeg|none]] 
We pack Metallness in the Red channel, Roughness in the Green channel and Ambient Occlusion in the Blue channel of Physical map. 
''Why our NM and PM textures look different from the ones used in other game engines ?'' 
-In image files (including dds) the red channel gets the least bytes assigned to it this causes some detail loss which you don't want. 
To circumvent it/improve quality, we swivel our red channel into the alpha channel to instead of outputting RGB with output xGBR maps. 
Larian primarily uses Substance Painter for texturing our characters and assets. [https://www.allegorithmic.com/buy You can get/try it here]. 
 
== Materials ==
 
After you imported your mesh and textures in the editor you need to create a material. 
We have a couple of Larian materials(shaders) you can use: 
[[File:Materials.jpeg|none]] character folder: [[File:CharacterMaterials.jpeg|none]] 
Character materials have fresnel effect on them so you can see your character in various environment and it also has MSK system, that helps you change colors on certan things like skin and cloths (more on MSK later). 
If you don't need this functionality you can use any material from the "Base_PBR" folder. 
After you created your material assign your textures in it and assign material to your mesh. (double click on material in content browser; double click on the mesh in content browser) 
If your are not using MSK but still want to use character material, just leave it empty (don't enable it in the box) or assign a black texture to it. 
You can edit the functionality of the material by right clicking it in content browser and selecting "Open in editor". 
[[File:MaterialEditor2.jpeg|none]] 
Beware if you make changes and save the material all the assets that are using the material will change accordingly. 
You can always make edits and "save as" a separate copy for testing purposes. 
Material source file can be easily changed if you select your material in the content browser and go to the side bar. 
[[File:MaterialSourceFile.jpeg|none]] 
If you change the sourcefile of the material you need to reassign textures. 
You can also see a "Material Type" parameter in the side bar of the material. the parameter will trigger different sound effects in the game depending in the type of your material, so don't leave it unassigned. 
== Visual Sets ==
Visual sets are special editor files, which help us organizing characters, their armor, body parts and colors. 
It also possible to a create without the visual set, in case you don't need any functionality mentioned above. 
Visual Set consists of 9 visual lists, where you can put meshes and 3 color lists where you can store colors. 
Visual set example: 
[[File:VisualSetExample.jpeg|none]] 
If you're working on a unique creature that doesn't need as many equipment pieces as our regular characters, you can put armor meshes in any visual list. (the names in brackets are for your convenience and consistency). 
Although it is recommended to keep something in either list #3(Torso) or #2(Head) because of material sounds functionality. 
Our troll example visual set:
[[File:TrollVisualSetExample2.jpeg|none]] 
Troll creature doesn't need to equip armor so it has some unique meshes in visual 3 (torso) list. 
!Important! You can also leave the meshes unassigned meshes by pressing "X" button. 
Space in the visual set is very limited, cause each visual set is stored in unit64. So you might have to create multiple visual sets for different armors. 
 

'''Colors in the visual set''' 
There are 3 color tabs in the Visual lists: Skin, Hair and Cloth colors. And 5 color rows you can change on the bottom. 
In the lists you can select and store colors. And in the rows on the bottom you can select colors from the list. 
[[File:VisualSetColors.jpeg|none]] 
To be able to edit colors from the visual set you need your mesh to use character pbr material and have MSKskin and/or MSKcloth. 
''Our MSK pipeline will be described below. ''

== Root Template ==
To be able to spawn a character in the editor you will need to create a root template for it. 
More advanced [[My_first:_Root_template|guide about root templates here]]
[[File:RootTemplateTroll.jpeg|none]] 
You will need to edit following parameters for your creature: 
* Ai Bounds - preferably a cylinder for the creature.
* DisplayName
* Physical Resource (physical mesh of your character)
* VisualResourseID - your actual mesh with the rig (could also be just a file with the rig)
* VisualSetResourseID (if any)
Make sure it has: 
* ExplodedResourseID
* ExplosionFX
* HitFX
* Icon
* RagdollResourseID
* Stats
Do not scale creatures unless you really need to. If scale a creature some animations, like climbing will not work properly. 
Small scale like 1.1 -1.3 is generally ok. 
Only use "IsPlayer" property for testing. 
Beware if you make your character "IsPlayer" the equipment system will not work properly. (More about equipment below) 

'''Root templates and Visual sets.'''
There are 3 ways of using visual sets for creatures in root templates: 
# Not using visual set for creatures - you put character mesh with all boned in VisualResourseID
# Using visual set only for armor/equipment for your character - character mesh with all boned in VisualResourseID + visual set with armor meshes, skinned to the character.
# Using visual set for both body parts and armor - just the rig with all bones in VisualResourseID +visual set with naked body parts and armor.
Most of the animals use #1, most of the creatures with equipment use #2 and ALL of NPC of our playable races use #3 approach. 

== Character creation visuals==
 
If you want to change Character Creation(CC) visuals you need to change "hero" root templates of our playable races: 
[[File:HeroRootTemplates.jpeg|none]] 
Hero root templates also have their own "hero" visual sets: 
[[File:HeroVisualSets.jpeg|none]] 
If you add/delete meshes from hero visual sets it will appear/disappear in Character Creation(CC). So to add/modify meshes in CC you just need to add them in those visual sets. 
Hair, Heads and Facial Features come from hero visual sets. while colors and armors in CC come from stats. 
To change the color selection available in character creation you need to change Race Presets files: 
[[File:racepresetsFile.jpeg|none]] 
To change or add color of the hair/skin you will need to change the value of the colors. 
Example of the value of the color: 
[[File:ExampleColorValue.jpeg|none]] 
Color value is "0xff" + it's Hex Color Code. So completely while color will be 0xffffffff; completely black - 0xff000000 

 
To change armor equipment and colors you will need to modify "ItemProgression", "Equipmet" and "Item Colors" stat files. Those will require more advanced knowledge. Guide on stats is still WIP here.

== Armor and Equipment ==
There is a difference in code between playable and NPC characters. NPC characters, as mentioned above, use visual sets for armor, while player characters use equipment. NPC visuals is just a rig in it's root template with all the armor and body parts stored in visual sets, while player characters have their naked body parts in them, which can't be unequiped, and are hidden when player equips armor from eq root templates. 
So when you make armor you need to ask yourself a question: 

''Do you want players to be able to equip your armor piece or is it going to be just a unique npc/creature armor? ''
'''If not:''' 
You just need to create a mesh, import it to editor and add it it your NPC visual set. 
'''If yes''' you will also need:
* Create meshes for each race and gender. So you need to have 8 meshes + 8 skeleton version variation.
* Your armor pieces needs to be made and cut the same way as already existing equipment, so they could fit with each other.
* Meshes need to be textured and masked the same way (read about MSK system below)
* Create separate eq root template and add your meshes to eq data.
* Create foldable mesh of your armor piece (Mesh that you see when you drop an armor piece on the ground)
* Crete an icon for your eq root template
* Give stats to your new equipment and make sure it can be generated for loot.

 
As an example you can check how Lizards female platemail armor is set up : 
[[:File:LizardFemalePlatemailExample.zip|Lizard Female files]] 
You will need to work in Lizards_Female_Armor_ABC, use other files as references. 
Note: if you export armor only include bones that you need, don't include entire skeleton. 
But! The character root should be always included. 
If you're making a helmet or any other piece of armor that only skinned to 1 bone, make it rigid. 
Go to "Extra Attributes" tab in maya and put "Rigid = true", otherwise it won't work in the editor. 
 

'''Cloth Simulation''' 
Cloth meshes shouldn't have any thickness. 
To add cloth simulation you need add "Cloth=1" in "Extra Attributes" tab in maya and add vertex paint on your mesh. 
Black for fixed vertices (0, 0, 0) Red for simulated vertices (255, 0 ,0) 
You can preview how it looks in the example file: 
[[File:ExampleFileCloth.jpeg|none]] 
In Maya, select your mesh -> go to Polygons tab -> Color -> Paint Vertex Color 
Make sure there are no elements with only red vertices. With no black vertices to fix the cloth in place it will fall apart to pieces. These pieces will fall through the level without being connected to anything. 
Make sure your cloth simulated mesh has only 1 smoothing group. To be sure in Maya, select your mesh -> go to Polygons tab -> Normals -> Soften Edge 
Try not to go too high poly with your cloth simulated meshes, as it will affect performance. Keep it <400 vertices per cloth mesh. 
Don't put cloth simulated meshes in the areas where they will bend (elbows, shoulders, knees) it won't look good. 
If you added cloth to a mesh when you double click on it in content browser you will be able to edit some cloth parameters: 
[[File:ClothParameters.jpeg|none]] 
Pose matching is one of the most important parameter you'll find there. Don't put it on 0 cause it will fly around too much. If you put it to high your cloth mesh will be too stiff or wouldn't simulate at all. Best results could be achieved when it's between 0.01 - 0.2 
 
'''Equipment root templates''' 
If you want to change existing equipment or add new one you'll have to work with eq roots. Each eq root has it's Equipment Data:
[[File:EqDataExample.jpeg|none]] 
You need to assign meshes to each race gender and tick the box if you want to deactivate any visual of any body part (usually you should). 
We have "Deactivate Equipment Slot Visuals" there as well, but it is used in very rare cases when we want to hide certain equipment slot whenever something is equipped. For example we have a very long robe that hides any trousers your character equips. 
 
'''Skeleton/Undead equipment''' 
Undeads are using the same rigs as alive characters versions so you can avoid remodeling entire mesh by just duplicating the existing mesh from the alive version and assigning Helper_Invisible_A material to the naked bodyparts in it. If the naked skin was baked in the texture you can use a different character material (replace the source file of the material to Characters_PRB_Skeletons from the CHaracters_PBR folder and reassign the textures) 
 
'''Hair and Helmets''' 
If you're are making an equip-able helmet you need to add a separate mesh with hair to it. It needs to be in the same granny but separate mesh with "_Hair_" in its name. In this case if a player is bald and equips your hair mesh from the helmet won't be rendered. 
[[File:HelmetHair.jpeg|none]] 
The hair and helmet is in one layer "Humans_Female_Armor_Mage_B_Helmet_A" hair is called Humans_Female_Armor_Mage_B_Hair_E_Mesh. If the player is bald and equips this helmet he'll only equip the hat.
 
== Downloadable files ==
Example files of the creatures Animals: 
[[:File:Animals_Bear_ABC.zip|Bear example]] 
[[:File:Animals_Boar_ABC.zip|Boar example]] 
[[:File:Animals_Cattle_ABC.zip|Cattle example]] 
[[:File:Animals_Crocodile_ABC.zip|Crocodile example]] 
[[:File:Animals_Deer_ABC.zip|Deer example]] 
[[:File:Animals_Dog_ABC.zip|Dog example]] 
[[:File:Animals_Frog_ABC.zip|Frog example]] 
[[:File:Animals_Pig_ABC.zip|Pig example]] 
[[:File:Animals_Rat_ABC.zip|Rat example]] 
[[:File:Animals_Salamander_ABC.zip|Salamander example]] 
[[:File:Animals_Squirrel_ABC.zip|Squirrel example]] 
[[:File:Animals_Tiger_ABC.zip|Tiger example]] 
[[:File:Animals_Turtle_ABC.zip|Turtle example]] 
[[:File:Animals_Wolf_ABC.zip|Wolf example]] 

Example files of the creatures Creatures: 
[[:File:Creatures_ElementalDevil_ABC.zip|ElementalDevil example]] 
[[:File:Creatures_Gheist_A.zip|Gheist example]] 
[[:File:Creatures_Giant_Insect_ABC.zip|Insect example]] 
[[:File:Creatures_Merman_ABC.zip|Merman example]] 
[[:File:Creatures_Nightmare_Werewolf_ABC.zip|Werewolf example]] 
[[:File:Creatures_Raanaar_Automaton_ABC.zip|Automaton example]] 
[[:File:Creatures_SourcePuppet_ABC.zip|SourcePuppet example]] 
[[:File:Creatures_Troll_ABC.zip|Troll example]] 

Playable Races Armor: 

[[:File:Humans_Male_ABC.zip|Human Male files]] 
[[:File:Humans_Female_ABC.zip|Human Female files]] 
[[:File:LizardFemalePlatemailExample.zip|Lizard Female files]]

My first: Character

2017-10-11T15:21:43Z

Alena:

Creating a character can be roughly divided into three parts: 
* Creating a creature (monster or animal)
* Creating body parts and hairstyles (heads, hairstyles, beards)
* Creating Armor
 
Creating custom characters is a very technical and complicated process. It will require artistic skills and profound knowledge of 3d modelling, texturing, rigging, skinning, animation and Larian editor. 
''If you do not possess all the skills mentioned above and still want to make custom characters we strongly recommend reusing existing rigs and animations. ''

To make a creature you can either: 
* Make your own custom creature, rig, animations
* Make your own custom creature that will use already existing rig and animations (recommended)

Larian pipeline of creature creation in a nutshell:
# Concept
# Creation a high poly asset in zbrush
# Retopo, unwrap
# Texturing
# Testing your mesh in the editor
# Rigging
# Skinning
# Animating
''Note: if you're reusing existing rig you can skip #6 and #8'' 
 
== File formats ==

In the editor 3d models are saved as granny files (.GR2). 
The textures are saved as DirectDraw Surface (.dds). 
{| class="wikitable"
|-
| More info on Granny 3D can be found [http://www.radgametools.com/granny.html here]
|-
| More info on DirectDraw Surface can be found [https://en.wikipedia.org/wiki/DirectDraw_Surface here]
|-
|}

== Creature editor set-up ==
Lets take an example of the troll creature. 
To be able to implement a troll creature in the game you need: 
Resources: 
* 3d model
* Textures: Base Map(BM) Normal map (NM) and Physical map(PM)
* Material
* Physics mesh
* Ragdoll mesh
* Animation files (won't be covered in this guide)
Special editor files (more on them later): 
* Visual Set
* Root Template
 
Example file of the troll creature: [[:File:Creatures_Troll_ABC.zip|Troll example]] 
Example of all the resource files in content browser: 
[[File:Troll ContentBrowserResourses.jpeg|none]]

== Modelling ==
'''General modelling tips: '''
* All the joints areas should have the proper cuts (bending cuts- see below), aligned accordingly along with the respective naked model of the race you’re modeling.
* The armors are using the same rig as the naked model, joints need to be placed correctly, with as similar cuts as possible.
* No Scaling applied to the meshes: reset X-form.
* No N-gons. Only 3 (triangles) and 4-gons (quads) are allowed.
* Delete any unused vertices and floating triangles.
 

[[File:Joints1.jpeg|none]]
Reasons for the Cuts: 
The cuts that are made will be used to squash and stretch at joint areas. 
[[File:Joints2.jpeg|none]]
The green and red meshes are skinned to the same rig and posed in the same way. 
The green mesh has the correct shapes to create a nice rolling bend of the knee.
whilst the red mesh is missing the shapes and cannot be bend in the same way. 
[[File:Joints3.jpeg|none]]
When creating the shapes there must be enhough space to straigten the leg
the red mesh has a shape to small to straighten the leg without it collapsing on itself 
[[File:Joints4.jpeg|none]]
In this example the shapes do not match the location of the kneejoint
and there for are not used in the skinning. 
Make sure when creating the mesh to look at the '''size''' of the shape and '''location''' of the joints. 

[[File:Fingers.jpeg|none]]
When making the Fingers make sure they all rotate the same way in their base position 
* Bottom of feet should be as flat as possible.
* Use smoothing groups sparingly AND intelligently: don’t use 32 smoothing groups when 4 is enough.
* Make sure the armor/clothing pieces are not clipping through one another.
* The vertices along the center world line (symmetry line) should be obviously aligned correctly in the center.
* Close your armor pieces: the player starts with a naked model then can individually dress up his character with any armor piece you’re going to make. It is therefore important there are no holes. Also, make sure your Lowerbody and Upperbody pieces hide the cut at the waistline level.
* About objects that can bend (e.g. tails), don't put concave (=bending inwards) curves in it. They should be as straight as possible in neutral pose.
* Final character should be centered on origin (x0,y0,z0) and fit the naked model provided.
 
Don't forget to make a physics mesh for your character, it needs it to collide with environment and so the player can click and select your character on the screen.

== Textures ==
 
In DOS2 we use f Physically-Based Rendering (PBR). 
To learn more about PBR you can read [https://www.allegorithmic.com/pbr-guide PBR Guide by Allegorithmic here]. 
 
A creature, like troll, usually needs basemap (BM), normal map(NM) and physical map(PM) textures. 
Larian editor uses .dds textures. 
Texture examples: 
[[File:TextureExamplesTroll.jpeg|none]] 
We pack Metallness in the Red channel, Roughness in the Green channel and Ambient Occlusion in the Blue channel of Physical map. 
''Why our NM and PM textures look different from the ones used in other game engines ?'' 
-In image files (including dds) the red channel gets the least bytes assigned to it this causes some detail loss which you don't want. 
To circumvent it/improve quality, we swivel our red channel into the alpha channel to instead of outputting RGB with output xGBR maps. 
Larian primarily uses Substance Painter for texturing our characters and assets. [https://www.allegorithmic.com/buy You can get/try it here]. 
 
== Materials ==
 
After you imported your mesh and textures in the editor you need to create a material. 
We have a couple of Larian materials(shaders) you can use: 
[[File:Materials.jpeg|none]] character folder: [[File:CharacterMaterials.jpeg|none]] 
Character materials have fresnel effect on them so you can see your character in various environment and it also has MSK system, that helps you change colors on certan things like skin and cloths (more on MSK later). 
If you don't need this functionality you can use any material from the "Base_PBR" folder. 
After you created your material assign your textures in it and assign material to your mesh. (double click on material in content browser; double click on the mesh in content browser) 
If your are not using MSK but still want to use character material, just leave it empty (don't enable it in the box) or assign a black texture to it. 
You can edit the functionality of the material by right clicking it in content browser and selecting "Open in editor". 
[[File:MaterialEditor2.jpeg|none]] 
Beware if you make changes and save the material all the assets that are using the material will change accordingly. 
You can always make edits and "save as" a separate copy for testing purposes. 
Material source file can be easily changed if you select your material in the content browser and go to the side bar. 
[[File:MaterialSourceFile.jpeg|none]] 
If you change the sourcefile of the material you need to reassign textures. 
You can also see a "Material Type" parameter in the side bar of the material. the parameter will trigger different sound effects in the game depending in the type of your material, so don't leave it unassigned. 
== Visual Sets ==
Visual sets are special editor files, which help us organizing characters, their armor, body parts and colors. 
It also possible to a create without the visual set, in case you don't need any functionality mentioned above. 
Visual Set consists of 9 visual lists, where you can put meshes and 3 color lists where you can store colors. 
Visual set example: 
[[File:VisualSetExample.jpeg|none]] 
If you're working on a unique creature that doesn't need as many equipment pieces as our regular characters, you can put armor meshes in any visual list. (the names in brackets are for your convenience and consistency). 
Although it is recommended to keep something in either list #3(Torso) or #2(Head) because of material sounds functionality. 
Our troll example visual set:
[[File:TrollVisualSetExample2.jpeg|none]] 
Troll creature doesn't need to equip armor so it has some unique meshes in visual 3 (torso) list. 
!Important! You can also leave the meshes unassigned meshes by pressing "X" button. 
Space in the visual set is very limited, cause each visual set is stored in unit64. So you might have to create multiple visual sets for different armors. 
 

'''Colors in the visual set''' 
There are 3 color tabs in the Visual lists: Skin, Hair and Cloth colors. And 5 color rows you can change on the bottom. 
In the lists you can select and store colors. And in the rows on the bottom you can select colors from the list. 
[[File:VisualSetColors.jpeg|none]] 
To be able to edit colors from the visual set you need your mesh to use character pbr material and have MSKskin and/or MSKcloth. 
''Our MSK pipeline will be described below. ''

== Root Template ==
To be able to spawn a character in the editor you will need to create a root template for it. 
More advanced [[My_first:_Root_template|guide about root templates here]]
[[File:RootTemplateTroll.jpeg|none]] 
You will need to edit following parameters for your creature: 
* Ai Bounds - preferably a cylinder for the creature.
* DisplayName
* Physical Resource (physical mesh of your character)
* VisualResourseID - your actual mesh with the rig (could also be just a file with the rig)
* VisualSetResourseID (if any)
Make sure it has: 
* ExplodedResourseID
* ExplosionFX
* HitFX
* Icon
* RagdollResourseID
* Stats
Do not scale creatures unless you really need to. If scale a creature some animations, like climbing will not work properly. 
Small scale like 1.1 -1.3 is generally ok. 
Only use "IsPlayer" property for testing. 
Beware if you make your character "IsPlayer" the equipment system will not work properly. (More about equipment below) 

'''Root templates and Visual sets.'''
There are 3 ways of using visual sets for creatures in root templates: 
# Not using visual set for creatures - you put character mesh with all boned in VisualResourseID
# Using visual set only for armor/equipment for your character - character mesh with all boned in VisualResourseID + visual set with armor meshes, skinned to the character.
# Using visual set for both body parts and armor - just the rig with all bones in VisualResourseID +visual set with naked body parts and armor.
Most of the animals use #1, most of the creatures with equipment use #2 and ALL of NPC of our playable races use #3 approach. 

== Character creation visuals==
 
If you want to change Character Creation(CC) visuals you need to change "hero" root templates of our playable races: 
[[File:HeroRootTemplates.jpeg|none]] 
Hero root templates also have their own "hero" visual sets: 
[[File:HeroVisualSets.jpeg|none]] 
If you add/delete meshes from hero visual sets it will appear/disappear in Character Creation(CC). So to add/modify meshes in CC you just need to add them in those visual sets. 
Hair, Heads and Facial Features come from hero visual sets. while colors and armors in CC come from stats. 
To change the color selection available in character creation you need to change Race Presets files: 
[[File:racepresetsFile.jpeg|none]] 
To change or add color of the hair/skin you will need to change the value of the colors. 
Example of the value of the color: 
[[File:ExampleColorValue.jpeg|none]] 
Color value is "0xff" + it's Hex Color Code. So completely while color will be 0xffffffff; completely black - 0xff000000 

 
To change armor equipment and colors you will need to modify "ItemProgression", "Equipmet" and "Item Colors" stat files. Those will require more advanced knowledge. Guide on stats is still WIP here.

== Armor and Equipment ==
There is a difference in code between playable and NPC characters. NPC characters, as mentioned above, use visual sets for armor, while player characters use equipment. NPC visuals is just a rig in it's root template with all the armor and body parts stored in visual sets, while player characters have their naked body parts in them, which can't be unequiped, and are hidden when player equips armor from eq root templates. 
So when you make armor you need to ask yourself a question: 

''Do you want players to be able to equip your armor piece or is it going to be just a unique npc/creature armor? ''
'''If not:''' 
You just need to create a mesh, import it to editor and add it it your NPC visual set. 
'''If yes''' you will also need:
* Create meshes for each race and gender. So you need to have 8 meshes + 8 skeleton version variation.
* Your armor pieces needs to be made and cut the same way as already existing equipment, so they could fit with each other.
* Meshes need to be textured and masked the same way (read about MSK system below)
* Create separate eq root template and add your meshes to eq data.
* Create foldable mesh of your armor piece (Mesh that you see when you drop an armor piece on the ground)
* Crete an icon for your eq root template
* Give stats to your new equipment and make sure it can be generated for loot.

 
As an example you can check how Lizards female platemail armor is set up : 
[[:File:LizardFemalePlatemailExample.zip|Lizard Female files]] 
You will need to work in Lizards_Female_Armor_ABC, use other files as references. 
Note: if you export armor only include bones that you need, don't include entire skeleton. 
But! The character root should be always included. 
If you're making a helmet or any other piece of armor that only skinned to 1 bone, make it rigid. 
Go to "Extra Attributes" tab in maya and put "Rigid = true", otherwise it won't work in the editor. 
 

'''Cloth Simulation''' 
Cloth meshes shouldn't have any thickness. 
To add cloth simulation you need add "Cloth=1" in "Extra Attributes" tab in maya and add vertex paint on your mesh. 
Black for fixed vertices (0, 0, 0) Red for simulated vertices (255, 0 ,0) 
You can preview how it looks in the example file: 
[[File:ExampleFileCloth.jpeg|none]] 
In Maya, select your mesh -> go to Polygons tab -> Color -> Paint Vertex Color 
Make sure there are no elements with only red vertices. With no black vertices to fix the cloth in place it will fall apart to pieces. These pieces will fall through the level without being connected to anything. 
Make sure your cloth simulated mesh has only 1 smoothing group. To be sure in Maya, select your mesh -> go to Polygons tab -> Normals -> Soften Edge 
Try not to go too high poly with your cloth simulated meshes, as it will affect performance. Keep it <400 vertices per cloth mesh. 
Don't put cloth simulated meshes in the areas where they will bend (elbows, shoulders, knees) it won't look good. 
If you added cloth to a mesh when you double click on it in content browser you will be able to edit some cloth parameters: 
[[File:ClothParameters.jpeg|none]] 
Pose matching is one of the most important parameter you'll find there. Don't put it on 0 cause it will fly around too much. If you put it to high your cloth mesh will be too stiff or wouldn't simulate at all. Best results could be achieved when it's between 0.01 - 0.2 
 
'''Equipment root templates''' 
If you want to change existing equipment or add new one you'll have to work with eq roots. Each eq root has it's Equipment Data:
[[File:EqDataExample.jpeg|none]] 
You need to assign meshes to each race gender and tick the box if you want to deactivate any visual of any body part (usually you should). 
We have "Deactivate Equipment Slot Visuals" there as well, but it is used in very rare cases when we want to hide certain equipment slot whenever something is equipped. For example we have a very long robe that hides any trousers your character equips. 
 
'''Skeleton/Undead equipment''' 
Undeads are using the same rigs as alive characters versions so you can avoid remodeling entire mesh by just duplicating the existing mesh from the alive version and assigning Helper_Invisible_A material to the naked bodyparts in it. If the naked skin was baked in the texture you can use a different character material (replace the source file of the material to Characters_PRB_Skeletons from the CHaracters_PBR folder and reassign the textures) 
 
'''Hair and Helmets''' 
If you're are making an equip-able helmet you need to add a separate mesh with hair to it. It needs to be in the same granny but separate mesh with "_Hair_" in its name. In this case if a player is bald and equips your hair mesh from the helmet won't be rendered. 
[[File:HelmetHair.jpeg|none]] 
The hair and helmet is in one layer "Humans_Female_Armor_Mage_B_Helmet_A" hair is called Humans_Female_Armor_Mage_B_Hair_E_Mesh. If the player is bald and equips this helmet he'll only equip the hat.
 
== Downloadable files ==
Example files of the creatures Animals: 
[[:File:Animals_Bear_ABC.zip|Bear example]] 
[[:File:Animals_Boar_ABC.zip|Boar example]] 
[[:File:Animals_Cattle_ABC.zip|Cattle example]] 
[[:File:Animals_Crocodile_ABC.zip|Crocodile example]] 
[[:File:Animals_Deer_ABC.zip|Deer example]] 
[[:File:Animals_Dog_ABC.zip|Dog example]] 
[[:File:Animals_Frog_ABC.zip|Frog example]] 
[[:File:Animals_Pig_ABC.zip|Pig example]] 
[[:File:Animals_Rat_ABC.zip|Rat example]] 
[[:File:Animals_Salamander_ABC.zip|Salamander example]] 
[[:File:Animals_Squirrel_ABC.zip|Squirrel example]] 
[[:File:Animals_Tiger_ABC.zip|Tiger example]] 
[[:File:Animals_Turtle_ABC.zip|Turtle example]] 
[[:File:Animals_Wolf_ABC.zip|Wolf example]] 

Example files of the creatures Creatures: 
[[:File:Creatures_ElementalDevil_ABC.zip|ElementalDevil example]] 
[[:File:Creatures_Gheist_A.zip|Gheist example]] 
[[:File:Creatures_Giant_Insect_ABC.zip|Insect example]] 
[[:File:Creatures_Merman_ABC.zip|Merman example]] 
[[:File:Creatures_Nightmare_Werewolf_ABC.zip|Werewolf example]] 
[[:File:Creatures_Raanaar_Automaton_ABC.zip|Automaton example]] 
[[:File:Creatures_SourcePuppet_ABC.zip|SourcePuppet example]] 
[[:File:Creatures_Troll_ABC.zip|Troll example]] 

Playable Races Armor: 

[[:File:Humans_Female_ABC.zip|Human Female files]] 
[[:File:LizardFemalePlatemailExample.zip|Lizard Female files]]

My first: Character

2017-10-11T15:13:55Z

Alena: /* Downloadable files */

Creating a character can be roughly divided into three parts: 
* Creating a creature (monster or animal)
* Creating body parts and hairstyles (heads, hairstyles, beards)
* Creating Armor
 
Creating custom characters is a very technical and complicated process. It will require artistic skills and profound knowledge of 3d modelling, texturing, rigging, skinning, animation and Larian editor. 
''If you do not possess all the skills mentioned above and still want to make custom characters we strongly recommend reusing existing rigs and animations. ''

To make a creature you can either: 
* Make your own custom creature, rig, animations
* Make your own custom creature that will use already existing rig and animations (recommended)

Larian pipeline of creature creation in a nutshell:
# Concept
# Creation a high poly asset in zbrush
# Retopo, unwrap
# Texturing
# Testing your mesh in the editor
# Rigging
# Skinning
# Animating
''Note: if you're reusing existing rig you can skip #6 and #8'' 
 
== File formats ==

In the editor 3d models are saved as granny files (.GR2). 
The textures are saved as DirectDraw Surface (.dds). 
{| class="wikitable"
|-
| More info on Granny 3D can be found [http://www.radgametools.com/granny.html here]
|-
| More info on DirectDraw Surface can be found [https://en.wikipedia.org/wiki/DirectDraw_Surface here]
|-
|}

== Creature editor set-up ==
Lets take an example of the troll creature. 
To be able to implement a troll creature in the game you need: 
Resources: 
* 3d model
* Textures: Base Map(BM) Normal map (NM) and Physical map(PM)
* Material
* Physics mesh
* Ragdoll mesh
* Animation files (won't be covered in this guide)
Special editor files (more on them later): 
* Visual Set
* Root Template
 
Example file of the troll creature: [[:File:Creatures_Troll_ABC.zip|Troll example]] 
Example of all the resource files in content browser: 
[[File:Troll ContentBrowserResourses.jpeg|none]]

== Modelling ==
'''General modelling tips: '''
* All the joints areas should have the proper cuts (bending cuts- see below), aligned accordingly along with the respective naked model of the race you’re modeling.
* The armors are using the same rig as the naked model, evidently joints need to be placed correctly, with as similar cuts as possible.
* No Scaling applied to the meshes: reset X-form.
* No N-gonsю Only 3 (triangles) and 4-gons (quads) are allowed.
* Delete any unused vertices and floating triangles.
* Meshes that are supposed to be cloth simulated (capes, hanging piece of cloth, flags, etc) should be built as follow: NO thickness. Try to keep their polycount optimal (500 triangles max per mesh). 
 

[[File:Joints1.jpeg|none]]
Reasons for the Cuts: 
The cuts that are made will be used to squash and stretch at joint areas. 
[[File:Joints2.jpeg|none]]
The green and red meshes are skinned to the same rig and posed in the same way. 
The green mesh has the correct shapes to create a nice rolling bend of the knee.
whilst the red mesh is missing the shapes and cannot be bend in the same way. 
[[File:Joints3.jpeg|none]]
When creating the shapes there must be enhough space to straigten the leg
the red mesh has a shape to small to straighten the leg without it collapsing on itself 
[[File:Joints4.jpeg|none]]
In this example the shapes do not match the location of the kneejoint
and there for are not used in the skinning. 
Make sure when creating the mesh to look at the '''size''' of the shape and '''location''' of the joints. 

[[File:Fingers.jpeg|none]]
When making the Fingers make sure they all rotate the same way in their base position 
* Bottom of feet should be as flat as possible.
* Use smoothing groups sparingly AND intelligently: don’t use 32 smoothing groups when 4 is enough.
* Make sure the armor/clothing pieces are not clipping through one another.
* The vertices along the center world line (symmetry line) should be obviously aligned correctly in the center.
* Close your armor pieces: the player starts with a naked model then can individually dress up his character with any armor piece you’re going to make. It is therefore important there are no holes. Also, make sure your Lowerbody and Upperbody pieces hide the cut at the waistline level.
* About objects that can bend (e.g. tails), don't put concave (=bending inwards) curves in it. They should be as straight as possible in neutral pose.
* Final character should be centered on origin (x0,y0,z0) and fit the naked model provided.
 
Don't forget to make a physics mesh for your character, it needs it to collide with environment and so the player can click and select your character on the screen.

== Textures ==
 
In DOS2 we use f Physically-Based Rendering (PBR). 
To learn more about PBR you can read [https://www.allegorithmic.com/pbr-guide PBR Guide by Allegorithmic here]. 
 
A creature, like troll, usually needs basemap (BM), normal map(NM) and physical map(PM) textures. 
Larian editor uses .dds textures. 
Texture examples: 
[[File:TextureExamplesTroll.jpeg|none]] 
We pack Metallness in the Red channel, Roughness in the Green channel and Ambient Occlusion in the Blue channel of Physical map. 
''Why our NM and PM textures look different from the ones used in other game engines ?'' 
-In image files (including dds) the red channel gets the least bytes assigned to it this causes some detail loss which you don't want. 
To circumvent it/improve quality, we swivel our red channel into the alpha channel to instead of outputting RGB with output xGBR maps. 
Larian primarily uses Substance Painter for texturing our characters and assets. [https://www.allegorithmic.com/buy You can get/try it here]. 
 
== Materials ==
 
After you imported your mesh and textures in the editor you need to create a material. 
We have a couple of Larian materials(shaders) you can use: 
[[File:Materials.jpeg|none]] character folder: [[File:CharacterMaterials.jpeg|none]] 
Character materials have fresnel effect on them so you can see your character in various environment and it also has MSK system, that helps you change colors on certan things like skin and cloths (more on MSK later). 
If you don't need this functionality you can use any material from the "Base_PBR" folder. 
After you created your material assign your textures in it and assign material to your mesh. (double click on material in content browser; double click on the mesh in content browser) 
If your are not using MSK but still want to use character material, just leave it empty (don't enable it in the box) or assign a black texture to it. 
You can edit the functionality of the material by right clicking it in content browser and selecting "Open in editor". 
[[File:MaterialEditor2.jpeg|none]] 
Beware if you make changes and save the material all the assets that are using the material will change accordingly. 
You can always make edits and "save as" a separate copy for testing purposes. 
Material source file can be easily changed if you select your material in the content browser and go to the side bar. 
[[File:MaterialSourceFile.jpeg|none]] 
If you change the sourcefile of the material you need to reassign textures. 
You can also see a "Material Type" parameter in the side bar of the material. the parameter will trigger different sound effects in the game depending in the type of your material, so don't leave it unassigned. 
== Visual Sets ==
Visual sets are special editor files, which help us organizing characters, their armor, body parts and colors. 
It also possible to a create without the visual set, in case you don't need any functionality mentioned above. 
Visual Set consists of 9 visual lists, where you can put meshes and 3 color lists where you can store colors. 
Visual set example: 
[[File:VisualSetExample.jpeg|none]] 
If you're working on a unique creature that doesn't need as many equipment pieces as our regular characters, you can put armor meshes in any visual list. (the names in brackets are for your convenience and consistency). 
Although it is recommended to keep something in either list #3(Torso) or #2(Head) because of material sounds functionality. 
Our troll example visual set:
[[File:TrollVisualSetExample2.jpeg|none]] 
Troll creature doesn't need to equip armor so it has some unique meshes in visual 3 (torso) list. 
!Important! You can also leave the meshes unassigned meshes by pressing "X" button. 
Space in the visual set is very limited, cause each visual set is stored in unit64. So you might have to create multiple visual sets for different armors. 
 

'''Colors in the visual set''' 
There are 3 color tabs in the Visual lists: Skin, Hair and Cloth colors. And 5 color rows you can change on the bottom. 
In the lists you can select and store colors. And in the rows on the bottom you can select colors from the list. 
[[File:VisualSetColors.jpeg|none]] 
To be able to edit colors from the visual set you need your mesh to use character pbr material and have MSKskin and/or MSKcloth. 
''Our MSK pipeline will be described below. ''

== Root Template ==
To be able to spawn a character in the editor you will need to create a root template for it. 
More advanced [[My_first:_Root_template|guide about root templates here]]
[[File:RootTemplateTroll.jpeg|none]] 
You will need to edit following parameters for your creature: 
* Ai Bounds - preferably a cylinder for the creature.
* DisplayName
* Physical Resource (physical mesh of your character)
* VisualResourseID - your actual mesh with the rig (could also be just a file with the rig)
* VisualSetResourseID (if any)
Make sure it has: 
* ExplodedResourseID
* ExplosionFX
* HitFX
* Icon
* RagdollResourseID
* Stats
Do not scale creatures unless you really need to. If scale a creature some animations, like climbing will not work properly. 
Small scale like 1.1 -1.3 is generally ok. 
Only use "IsPlayer" property for testing. 
Beware if you make your character "IsPlayer" the equipment system will not work properly. (More about equipment below) 

'''Root templates and Visual sets.'''
There are 3 ways of using visual sets for creatures in root templates: 
# Not using visual set for creatures - you put character mesh with all boned in VisualResourseID
# Using visual set only for armor/equipment for your character - character mesh with all boned in VisualResourseID + visual set with armor meshes, skinned to the character.
# Using visual set for both body parts and armor - just the rig with all bones in VisualResourseID +visual set with naked body parts and armor.
Most of the animals use #1, most of the creatures with equipment use #2 and ALL of NPC of our playable races use #3 approach. 

== Character creation visuals==
 
If you want to change Character Creation(CC) visuals you need to change "hero" root templates of our playable races: 
[[File:HeroRootTemplates.jpeg|none]] 
Hero root templates also have their own "hero" visual sets: 
[[File:HeroVisualSets.jpeg|none]] 
If you add/delete meshes from hero visual sets it will appear/disappear in Character Creation(CC). So to add/modify meshes in CC you just need to add them in those visual sets. 
Hair, Heads and Facial Features come from hero visual sets. while colors and armors in CC come from stats. 
To change the color selection available in character creation you need to change Race Presets files: 
[[File:racepresetsFile.jpeg|none]] 
To change or add color of the hair/skin you will need to change the value of the colors. 
Example of the value of the color: 
[[File:ExampleColorValue.jpeg|none]] 
Color value is "0xff" + it's Hex Color Code. So completely while color will be 0xffffffff; completely black - 0xff000000 

 
To change armor equipment and colors you will need to modify "ItemProgression", "Equipmet" and "Item Colors" stat files. Those will require more advanced knowledge. Guide on stats is still WIP here.

== Armor and Equipment ==
There is a difference in code between playable and NPC characters. NPC characters, as mentioned above, use visual sets for armor, while player characters use equipment. NPC visuals is just a rig in it's root template with all the armor and body parts stored in visual sets, while player characters have their naked body parts in them, which can't be unequiped, and are hidden when player equips armor from eq root templates. 
So when you make armor you need to ask yourself a question: 

''Do you want players to be able to equip your armor piece or is it going to be just a unique npc/creature armor? ''
'''If not:''' 
You just need to create a mesh, import it to editor and add it it your NPC visual set. 
'''If yes''' you will also need:
* Create meshes for each race and gender. So you need to have 8 meshes + 8 skeleton version variation.
* Your armor pieces needs to be made and cut the same way as already existing equipment, so they could fit with each other.
* Meshes need to be textured and masked the same way (read about MSK system below)
* Create separate eq root template and add your meshes to eq data.
* Create foldable mesh of your armor piece (Mesh that you see when you drop an armor piece on the ground)
* Crete an icon for your eq root template
* Give stats to your new equipment and make sure it can be generated for loot.

 
As an example you can check how Lizards female platemail armor is set up : 
[[:File:LizardFemalePlatemailExample.zip|Lizard Female files]] 
You will need to work in Lizards_Female_Armor_ABC, use other files as references. 
Note: if you export armor only include bones that you need, don't include entire skeleton. 
But! The character root should be always included. 
If you're making a helmet or any other piece of armor that only skinned to 1 bone, make it rigid. 
Go to "Extra Attributes" tab in maya and put "Rigid = true", otherwise it won't work in the editor. 
 
To add cloth simulation you need add "Cloth=1" in "Extra Attributes" tab in maya and add vertex paint on your mesh. 
Black for fixed vertices (0, 0, 0) Red for simulated vertices (255, 0 ,0) 
You can preview how it looks in the example file: 
[[File:ExampleFileCloth.jpeg|none]] 
In Maya, select your mesh -> go to Polygons tab -> Color -> Paint Vertex Color 
Make sure there are no elements with only red vertices. With no black vertices to fix the cloth in place it will fall apart to pieces. These pieces will fall through the level without being connected to anything. 
Make sure your cloth simulated mesh has only 1 smoothing group. To be sure in Maya, select your mesh -> go to Polygons tab -> Normals -> Soften Edge 
Try not to go too high poly with your cloth simulated meshes, as it will affect performance. Keep it <400 vertices per cloth mesh. 
Don't put cloth simulated meshes in the areas where they will bend (elbows, shoulders, knees) it won't look good. 
If you added cloth to a mesh when you double click on it in content browser you will be able to edit some cloth parameters: 
[[File:ClothParameters.jpeg|none]] 
Pose matching is one of the most important parameter you'll find there. Don't put it on 0 cause it will fly around too much. If you put it to high your cloth mesh will be too stiff or wouldn't simulate at all. Best results could be achieved when it's between 0.01 - 0.2 
 
'''Equipment root templates''' 
If you want to change existing equipment or add new one you'll have to work with eq roots. Each eq root has it's Equipment Data:
[[File:EqDataExample.jpeg|none]] 
You need to assign meshes to each race gender and tick the box if you want to deactivate any visual of any body part (usually you should). 
We have "Deactivate Equipment Slot Visuals" there as well, but it is used in very rare cases when we want to hide certain equipment slot whenever something is equipped. For example we have a very long robe that hides any trousers your character equips. 
 
'''Skeleton/Undead equipment''' 
Undeads are using the same rigs as alive characters versions so you can avoid remodeling entire mesh by just duplicating the existing mesh from the alive version and assigning Helper_Invisible_A material to the naked bodyparts in it. If the naked skin was baked in the texture you can use a different character material (replace the source file of the material to Characters_PRB_Skeletons from the CHaracters_PBR folder and reassign the textures) 
 
'''Hair and Helmets''' 
If you're are making an equip-able helmet you need to add a separate mesh with hair to it. It needs to be in the same granny but separate mesh with "_Hair_" in its name. In this case if a player is bald and equips your hair mesh from the helmet won't be rendered. 
[[File:HelmetHair.jpeg|none]] 
The hair and helmet is in one layer "Humans_Female_Armor_Mage_B_Helmet_A" hair is called Humans_Female_Armor_Mage_B_Hair_E_Mesh. If the player is bald and equips this helmet he'll only equip the hat.
 
== Downloadable files ==
Example files of the creatures Animals: 
[[:File:Animals_Bear_ABC.zip|Bear example]] 
[[:File:Animals_Boar_ABC.zip|Boar example]] 
[[:File:Animals_Cattle_ABC.zip|Cattle example]] 
[[:File:Animals_Crocodile_ABC.zip|Crocodile example]] 
[[:File:Animals_Deer_ABC.zip|Deer example]] 
[[:File:Animals_Dog_ABC.zip|Dog example]] 
[[:File:Animals_Frog_ABC.zip|Frog example]] 
[[:File:Animals_Pig_ABC.zip|Pig example]] 
[[:File:Animals_Rat_ABC.zip|Rat example]] 
[[:File:Animals_Salamander_ABC.zip|Salamander example]] 
[[:File:Animals_Squirrel_ABC.zip|Squirrel example]] 
[[:File:Animals_Tiger_ABC.zip|Tiger example]] 
[[:File:Animals_Turtle_ABC.zip|Turtle example]] 
[[:File:Animals_Wolf_ABC.zip|Wolf example]] 

Example files of the creatures Creatures: 
[[:File:Creatures_ElementalDevil_ABC.zip|ElementalDevil example]] 
[[:File:Creatures_Gheist_A.zip|Gheist example]] 
[[:File:Creatures_Giant_Insect_ABC.zip|Insect example]] 
[[:File:Creatures_Merman_ABC.zip|Merman example]] 
[[:File:Creatures_Nightmare_Werewolf_ABC.zip|Werewolf example]] 
[[:File:Creatures_Raanaar_Automaton_ABC.zip|Automaton example]] 
[[:File:Creatures_SourcePuppet_ABC.zip|SourcePuppet example]] 
[[:File:Creatures_Troll_ABC.zip|Troll example]] 

Playable Races Armor: 

[[:File:Humans_Female_ABC.zip|Human Female files]] 
[[:File:LizardFemalePlatemailExample.zip|Lizard Female files]]

My first...

2017-10-11T15:11:57Z

Alena: /* Full elements */

== Mods ==

[[File:Adventure_Icon.png|48px]] <big>[[My first: Adventure| Adventure]]</big>
 
[[File:Add-on_Icon.png|48px]] <big>[[My first: Add-on| Add-on]]</big>
 

== Base elements ==
Everything in the divinity engine needs one or more base elements. See these elements as building blocks for the final object. 
There are generally two big building blocks: resources and root templates. 
Resources are base elements that represent a specific type of data, such as a texture, or a model. 
Root templates are built up of resources. They represent a base template of a certain object you can place, such as a character or a chair. 

Take for example a chair. A chair needs:
* A visual model resource
* Texture resource
* A physics model resource
* A root template grouping all the resources into the specific chair you want.

{| class="wikitable"
|-
|More info on how resources work can be found here: [[Resources explanation]]
|-
|}

{| class="wikitable"
|-
|More info on how templates work can be found here: [[Templates explanation]]
|-
|}

[[File:CreateResource_C.png|32px]] <big>[[My first: Resource | Resource]] (Coming Soon)</big>
 
[[File:CreateRootTemplate_C.png|32px]] <big>[[My first: Root template | Root template]]</big>
 

== Full elements ==
[[File:LarianLogo_Icon.png|32px]] <big>[[My first: Item | Item]] (Work in Progress) </big>
 
[[File:LarianLogo_Icon.png|32px]] <big>[[My first: Character | Character]] </big>
 
[[File:LarianLogo_Icon.png|32px]] <big>[[Part 1: creating a terrain object|Terrain]]</big>
 
[[File:LarianLogo_Icon.png|32px]] <big>[[Part 1: creating a new skill|Skill]]</big>
 
[[File:LarianLogo_Icon.png|32px]] <big>[[My first: Recipe|Recipe]]</big>
 
[[File:LarianLogo_Icon.png|32px]] <big>[[My first: Character creation class | Character creation class]]</big>
 
[[File:LarianLogo_Icon.png|32px]] <big>[[My first: Character creation origin | Character creation origin]]</big>
 
[[File:LarianLogo_Icon.png|32px]] <big>[[My first: Character creation race | Character creation race]]</big>
 
[[File:LarianLogo_Icon.png|32px]] <big>[[My first: Custom portrait | Custom portrait]]</big>

File:Humans Female ABC.zip

2017-10-11T15:11:38Z

Alena:

My first: Character

2017-10-11T15:10:18Z

Alena:

Creating a character can be roughly divided into three parts: 
* Creating a creature (monster or animal)
* Creating body parts and hairstyles (heads, hairstyles, beards)
* Creating Armor
 
Creating custom characters is a very technical and complicated process. It will require artistic skills and profound knowledge of 3d modelling, texturing, rigging, skinning, animation and Larian editor. 
''If you do not possess all the skills mentioned above and still want to make custom characters we strongly recommend reusing existing rigs and animations. ''

To make a creature you can either: 
* Make your own custom creature, rig, animations
* Make your own custom creature that will use already existing rig and animations (recommended)

Larian pipeline of creature creation in a nutshell:
# Concept
# Creation a high poly asset in zbrush
# Retopo, unwrap
# Texturing
# Testing your mesh in the editor
# Rigging
# Skinning
# Animating
''Note: if you're reusing existing rig you can skip #6 and #8'' 
 
== File formats ==

In the editor 3d models are saved as granny files (.GR2). 
The textures are saved as DirectDraw Surface (.dds). 
{| class="wikitable"
|-
| More info on Granny 3D can be found [http://www.radgametools.com/granny.html here]
|-
| More info on DirectDraw Surface can be found [https://en.wikipedia.org/wiki/DirectDraw_Surface here]
|-
|}

== Creature editor set-up ==
Lets take an example of the troll creature. 
To be able to implement a troll creature in the game you need: 
Resources: 
* 3d model
* Textures: Base Map(BM) Normal map (NM) and Physical map(PM)
* Material
* Physics mesh
* Ragdoll mesh
* Animation files (won't be covered in this guide)
Special editor files (more on them later): 
* Visual Set
* Root Template
 
Example file of the troll creature: [[:File:Creatures_Troll_ABC.zip|Troll example]] 
Example of all the resource files in content browser: 
[[File:Troll ContentBrowserResourses.jpeg|none]]

== Modelling ==
'''General modelling tips: '''
* All the joints areas should have the proper cuts (bending cuts- see below), aligned accordingly along with the respective naked model of the race you’re modeling.
* The armors are using the same rig as the naked model, evidently joints need to be placed correctly, with as similar cuts as possible.
* No Scaling applied to the meshes: reset X-form.
* No N-gonsю Only 3 (triangles) and 4-gons (quads) are allowed.
* Delete any unused vertices and floating triangles.
* Meshes that are supposed to be cloth simulated (capes, hanging piece of cloth, flags, etc) should be built as follow: NO thickness. Try to keep their polycount optimal (500 triangles max per mesh). 
 

[[File:Joints1.jpeg|none]]
Reasons for the Cuts: 
The cuts that are made will be used to squash and stretch at joint areas. 
[[File:Joints2.jpeg|none]]
The green and red meshes are skinned to the same rig and posed in the same way. 
The green mesh has the correct shapes to create a nice rolling bend of the knee.
whilst the red mesh is missing the shapes and cannot be bend in the same way. 
[[File:Joints3.jpeg|none]]
When creating the shapes there must be enhough space to straigten the leg
the red mesh has a shape to small to straighten the leg without it collapsing on itself 
[[File:Joints4.jpeg|none]]
In this example the shapes do not match the location of the kneejoint
and there for are not used in the skinning. 
Make sure when creating the mesh to look at the '''size''' of the shape and '''location''' of the joints. 

[[File:Fingers.jpeg|none]]
When making the Fingers make sure they all rotate the same way in their base position 
* Bottom of feet should be as flat as possible.
* Use smoothing groups sparingly AND intelligently: don’t use 32 smoothing groups when 4 is enough.
* Make sure the armor/clothing pieces are not clipping through one another.
* The vertices along the center world line (symmetry line) should be obviously aligned correctly in the center.
* Close your armor pieces: the player starts with a naked model then can individually dress up his character with any armor piece you’re going to make. It is therefore important there are no holes. Also, make sure your Lowerbody and Upperbody pieces hide the cut at the waistline level.
* About objects that can bend (e.g. tails), don't put concave (=bending inwards) curves in it. They should be as straight as possible in neutral pose.
* Final character should be centered on origin (x0,y0,z0) and fit the naked model provided.
 
Don't forget to make a physics mesh for your character, it needs it to collide with environment and so the player can click and select your character on the screen.

== Textures ==
 
In DOS2 we use f Physically-Based Rendering (PBR). 
To learn more about PBR you can read [https://www.allegorithmic.com/pbr-guide PBR Guide by Allegorithmic here]. 
 
A creature, like troll, usually needs basemap (BM), normal map(NM) and physical map(PM) textures. 
Larian editor uses .dds textures. 
Texture examples: 
[[File:TextureExamplesTroll.jpeg|none]] 
We pack Metallness in the Red channel, Roughness in the Green channel and Ambient Occlusion in the Blue channel of Physical map. 
''Why our NM and PM textures look different from the ones used in other game engines ?'' 
-In image files (including dds) the red channel gets the least bytes assigned to it this causes some detail loss which you don't want. 
To circumvent it/improve quality, we swivel our red channel into the alpha channel to instead of outputting RGB with output xGBR maps. 
Larian primarily uses Substance Painter for texturing our characters and assets. [https://www.allegorithmic.com/buy You can get/try it here]. 
 
== Materials ==
 
After you imported your mesh and textures in the editor you need to create a material. 
We have a couple of Larian materials(shaders) you can use: 
[[File:Materials.jpeg|none]] character folder: [[File:CharacterMaterials.jpeg|none]] 
Character materials have fresnel effect on them so you can see your character in various environment and it also has MSK system, that helps you change colors on certan things like skin and cloths (more on MSK later). 
If you don't need this functionality you can use any material from the "Base_PBR" folder. 
After you created your material assign your textures in it and assign material to your mesh. (double click on material in content browser; double click on the mesh in content browser) 
If your are not using MSK but still want to use character material, just leave it empty (don't enable it in the box) or assign a black texture to it. 
You can edit the functionality of the material by right clicking it in content browser and selecting "Open in editor". 
[[File:MaterialEditor2.jpeg|none]] 
Beware if you make changes and save the material all the assets that are using the material will change accordingly. 
You can always make edits and "save as" a separate copy for testing purposes. 
Material source file can be easily changed if you select your material in the content browser and go to the side bar. 
[[File:MaterialSourceFile.jpeg|none]] 
If you change the sourcefile of the material you need to reassign textures. 
You can also see a "Material Type" parameter in the side bar of the material. the parameter will trigger different sound effects in the game depending in the type of your material, so don't leave it unassigned. 
== Visual Sets ==
Visual sets are special editor files, which help us organizing characters, their armor, body parts and colors. 
It also possible to a create without the visual set, in case you don't need any functionality mentioned above. 
Visual Set consists of 9 visual lists, where you can put meshes and 3 color lists where you can store colors. 
Visual set example: 
[[File:VisualSetExample.jpeg|none]] 
If you're working on a unique creature that doesn't need as many equipment pieces as our regular characters, you can put armor meshes in any visual list. (the names in brackets are for your convenience and consistency). 
Although it is recommended to keep something in either list #3(Torso) or #2(Head) because of material sounds functionality. 
Our troll example visual set:
[[File:TrollVisualSetExample2.jpeg|none]] 
Troll creature doesn't need to equip armor so it has some unique meshes in visual 3 (torso) list. 
!Important! You can also leave the meshes unassigned meshes by pressing "X" button. 
Space in the visual set is very limited, cause each visual set is stored in unit64. So you might have to create multiple visual sets for different armors. 
 

'''Colors in the visual set''' 
There are 3 color tabs in the Visual lists: Skin, Hair and Cloth colors. And 5 color rows you can change on the bottom. 
In the lists you can select and store colors. And in the rows on the bottom you can select colors from the list. 
[[File:VisualSetColors.jpeg|none]] 
To be able to edit colors from the visual set you need your mesh to use character pbr material and have MSKskin and/or MSKcloth. 
''Our MSK pipeline will be described below. ''

== Root Template ==
To be able to spawn a character in the editor you will need to create a root template for it. 
More advanced [[My_first:_Root_template|guide about root templates here]]
[[File:RootTemplateTroll.jpeg|none]] 
You will need to edit following parameters for your creature: 
* Ai Bounds - preferably a cylinder for the creature.
* DisplayName
* Physical Resource (physical mesh of your character)
* VisualResourseID - your actual mesh with the rig (could also be just a file with the rig)
* VisualSetResourseID (if any)
Make sure it has: 
* ExplodedResourseID
* ExplosionFX
* HitFX
* Icon
* RagdollResourseID
* Stats
Do not scale creatures unless you really need to. If scale a creature some animations, like climbing will not work properly. 
Small scale like 1.1 -1.3 is generally ok. 
Only use "IsPlayer" property for testing. 
Beware if you make your character "IsPlayer" the equipment system will not work properly. (More about equipment below) 

'''Root templates and Visual sets.'''
There are 3 ways of using visual sets for creatures in root templates: 
# Not using visual set for creatures - you put character mesh with all boned in VisualResourseID
# Using visual set only for armor/equipment for your character - character mesh with all boned in VisualResourseID + visual set with armor meshes, skinned to the character.
# Using visual set for both body parts and armor - just the rig with all bones in VisualResourseID +visual set with naked body parts and armor.
Most of the animals use #1, most of the creatures with equipment use #2 and ALL of NPC of our playable races use #3 approach. 

== Character creation visuals==
 
If you want to change Character Creation(CC) visuals you need to change "hero" root templates of our playable races: 
[[File:HeroRootTemplates.jpeg|none]] 
Hero root templates also have their own "hero" visual sets: 
[[File:HeroVisualSets.jpeg|none]] 
If you add/delete meshes from hero visual sets it will appear/disappear in Character Creation(CC). So to add/modify meshes in CC you just need to add them in those visual sets. 
Hair, Heads and Facial Features come from hero visual sets. while colors and armors in CC come from stats. 
To change the color selection available in character creation you need to change Race Presets files: 
[[File:racepresetsFile.jpeg|none]] 
To change or add color of the hair/skin you will need to change the value of the colors. 
Example of the value of the color: 
[[File:ExampleColorValue.jpeg|none]] 
Color value is "0xff" + it's Hex Color Code. So completely while color will be 0xffffffff; completely black - 0xff000000 

 
To change armor equipment and colors you will need to modify "ItemProgression", "Equipmet" and "Item Colors" stat files. Those will require more advanced knowledge. Guide on stats is still WIP here.

== Armor and Equipment ==
There is a difference in code between playable and NPC characters. NPC characters, as mentioned above, use visual sets for armor, while player characters use equipment. NPC visuals is just a rig in it's root template with all the armor and body parts stored in visual sets, while player characters have their naked body parts in them, which can't be unequiped, and are hidden when player equips armor from eq root templates. 
So when you make armor you need to ask yourself a question: 

''Do you want players to be able to equip your armor piece or is it going to be just a unique npc/creature armor? ''
'''If not:''' 
You just need to create a mesh, import it to editor and add it it your NPC visual set. 
'''If yes''' you will also need:
* Create meshes for each race and gender. So you need to have 8 meshes + 8 skeleton version variation.
* Your armor pieces needs to be made and cut the same way as already existing equipment, so they could fit with each other.
* Meshes need to be textured and masked the same way (read about MSK system below)
* Create separate eq root template and add your meshes to eq data.
* Create foldable mesh of your armor piece (Mesh that you see when you drop an armor piece on the ground)
* Crete an icon for your eq root template
* Give stats to your new equipment and make sure it can be generated for loot.

 
As an example you can check how Lizards female platemail armor is set up : 
[[:File:LizardFemalePlatemailExample.zip|Lizard Female files]] 
You will need to work in Lizards_Female_Armor_ABC, use other files as references. 
Note: if you export armor only include bones that you need, don't include entire skeleton. 
But! The character root should be always included. 
If you're making a helmet or any other piece of armor that only skinned to 1 bone, make it rigid. 
Go to "Extra Attributes" tab in maya and put "Rigid = true", otherwise it won't work in the editor. 
 
To add cloth simulation you need add "Cloth=1" in "Extra Attributes" tab in maya and add vertex paint on your mesh. 
Black for fixed vertices (0, 0, 0) Red for simulated vertices (255, 0 ,0) 
You can preview how it looks in the example file: 
[[File:ExampleFileCloth.jpeg|none]] 
In Maya, select your mesh -> go to Polygons tab -> Color -> Paint Vertex Color 
Make sure there are no elements with only red vertices. With no black vertices to fix the cloth in place it will fall apart to pieces. These pieces will fall through the level without being connected to anything. 
Make sure your cloth simulated mesh has only 1 smoothing group. To be sure in Maya, select your mesh -> go to Polygons tab -> Normals -> Soften Edge 
Try not to go too high poly with your cloth simulated meshes, as it will affect performance. Keep it <400 vertices per cloth mesh. 
Don't put cloth simulated meshes in the areas where they will bend (elbows, shoulders, knees) it won't look good. 
If you added cloth to a mesh when you double click on it in content browser you will be able to edit some cloth parameters: 
[[File:ClothParameters.jpeg|none]] 
Pose matching is one of the most important parameter you'll find there. Don't put it on 0 cause it will fly around too much. If you put it to high your cloth mesh will be too stiff or wouldn't simulate at all. Best results could be achieved when it's between 0.01 - 0.2 
 
'''Equipment root templates''' 
If you want to change existing equipment or add new one you'll have to work with eq roots. Each eq root has it's Equipment Data:
[[File:EqDataExample.jpeg|none]] 
You need to assign meshes to each race gender and tick the box if you want to deactivate any visual of any body part (usually you should). 
We have "Deactivate Equipment Slot Visuals" there as well, but it is used in very rare cases when we want to hide certain equipment slot whenever something is equipped. For example we have a very long robe that hides any trousers your character equips. 
 
'''Skeleton/Undead equipment''' 
Undeads are using the same rigs as alive characters versions so you can avoid remodeling entire mesh by just duplicating the existing mesh from the alive version and assigning Helper_Invisible_A material to the naked bodyparts in it. If the naked skin was baked in the texture you can use a different character material (replace the source file of the material to Characters_PRB_Skeletons from the CHaracters_PBR folder and reassign the textures) 
 
'''Hair and Helmets''' 
If you're are making an equip-able helmet you need to add a separate mesh with hair to it. It needs to be in the same granny but separate mesh with "_Hair_" in its name. In this case if a player is bald and equips your hair mesh from the helmet won't be rendered. 
[[File:HelmetHair.jpeg|none]] 
The hair and helmet is in one layer "Humans_Female_Armor_Mage_B_Helmet_A" hair is called Humans_Female_Armor_Mage_B_Hair_E_Mesh. If the player is bald and equips this helmet he'll only equip the hat.
 
== Downloadable files ==
Example files of the creatures Animals: 
[[:File:Animals_Bear_ABC.zip|Bear example]] 
[[:File:Animals_Boar_ABC.zip|Boar example]] 
[[:File:Animals_Cattle_ABC.zip|Cattle example]] 
[[:File:Animals_Crocodile_ABC.zip|Crocodile example]] 
[[:File:Animals_Deer_ABC.zip|Deer example]] 
[[:File:Animals_Dog_ABC.zip|Dog example]] 
[[:File:Animals_Frog_ABC.zip|Frog example]] 
[[:File:Animals_Pig_ABC.zip|Pig example]] 
[[:File:Animals_Rat_ABC.zip|Rat example]] 
[[:File:Animals_Salamander_ABC.zip|Salamander example]] 
[[:File:Animals_Squirrel_ABC.zip|Squirrel example]] 
[[:File:Animals_Tiger_ABC.zip|Tiger example]] 
[[:File:Animals_Turtle_ABC.zip|Turtle example]] 
[[:File:Animals_Wolf_ABC.zip|Wolf example]] 

Example files of the creatures Creatures: 
[[:File:Creatures_ElementalDevil_ABC.zip|ElementalDevil example]] 
[[:File:Creatures_Gheist_A.zip|Gheist example]] 
[[:File:Creatures_Giant_Insect_ABC.zip|Insect example]] 
[[:File:Creatures_Merman_ABC.zip|Merman example]] 
[[:File:Creatures_Nightmare_Werewolf_ABC.zip|Werewolf example]] 
[[:File:Creatures_Raanaar_Automaton_ABC.zip|Automaton example]] 
[[:File:Creatures_SourcePuppet_ABC.zip|SourcePuppet example]] 
[[:File:Creatures_Troll_ABC.zip|Troll example]] 

Playable Races Armor: 

[[:File:Humans_Female_ABC.zip|Lizard Female files]] 
[[:File:LizardFemalePlatemailExample.zip|Lizard Female files]]

File:HelmetHair.jpeg

2017-10-11T14:57:24Z

Alena:

File:EqDataExample.jpeg

2017-10-11T14:57:12Z

Alena:

My first: Character

2017-10-11T14:56:10Z

Alena:

Creating a character can be roughly divided into three parts: 
* Creating a creature (monster or animal)
* Creating body parts and hairstyles (heads, hairstyles, beards)
* Creating Armor
 
Creating custom characters is a very technical and complicated process. It will require artistic skills and profound knowledge of 3d modelling, texturing, rigging, skinning, animation and Larian editor. 
''If you do not possess all the skills mentioned above and still want to make custom characters we strongly recommend reusing existing rigs and animations. ''

To make a creature you can either: 
* Make your own custom creature, rig, animations
* Make your own custom creature that will use already existing rig and animations (recommended)

Larian pipeline of creature creation in a nutshell:
# Concept
# Creation a high poly asset in zbrush
# Retopo, unwrap
# Texturing
# Testing your mesh in the editor
# Rigging
# Skinning
# Animating
''Note: if you're reusing existing rig you can skip #6 and #8'' 
 
== File formats ==

In the editor 3d models are saved as granny files (.GR2). 
The textures are saved as DirectDraw Surface (.dds). 
{| class="wikitable"
|-
| More info on Granny 3D can be found [http://www.radgametools.com/granny.html here]
|-
| More info on DirectDraw Surface can be found [https://en.wikipedia.org/wiki/DirectDraw_Surface here]
|-
|}

== Creature editor set-up ==
Lets take an example of the troll creature. 
To be able to implement a troll creature in the game you need: 
Resources: 
* 3d model
* Textures: Base Map(BM) Normal map (NM) and Physical map(PM)
* Material
* Physics mesh
* Ragdoll mesh
* Animation files (won't be covered in this guide)
Special editor files (more on them later): 
* Visual Set
* Root Template
 
Example file of the troll creature: [[:File:Creatures_Troll_ABC.zip|Troll example]] 
Example of all the resource files in content browser: 
[[File:Troll ContentBrowserResourses.jpeg|none]]

== Modelling ==
'''General modelling tips: '''
* All the joints areas should have the proper cuts (bending cuts- see below), aligned accordingly along with the respective naked model of the race you’re modeling.
* The armors are using the same rig as the naked model, evidently joints need to be placed correctly, with as similar cuts as possible.
* No Scaling applied to the meshes: reset X-form.
* No N-gonsю Only 3 (triangles) and 4-gons (quads) are allowed.
* Delete any unused vertices and floating triangles.
* Meshes that are supposed to be cloth simulated (capes, hanging piece of cloth, flags, etc) should be built as follow: NO thickness. Try to keep their polycount optimal (500 triangles max per mesh). 
 

[[File:Joints1.jpeg|none]]
Reasons for the Cuts: 
The cuts that are made will be used to squash and stretch at joint areas. 
[[File:Joints2.jpeg|none]]
The green and red meshes are skinned to the same rig and posed in the same way. 
The green mesh has the correct shapes to create a nice rolling bend of the knee.
whilst the red mesh is missing the shapes and cannot be bend in the same way. 
[[File:Joints3.jpeg|none]]
When creating the shapes there must be enhough space to straigten the leg
the red mesh has a shape to small to straighten the leg without it collapsing on itself 
[[File:Joints4.jpeg|none]]
In this example the shapes do not match the location of the kneejoint
and there for are not used in the skinning. 
Make sure when creating the mesh to look at the '''size''' of the shape and '''location''' of the joints. 

[[File:Fingers.jpeg|none]]
When making the Fingers make sure they all rotate the same way in their base position 
* Bottom of feet should be as flat as possible.
* Use smoothing groups sparingly AND intelligently: don’t use 32 smoothing groups when 4 is enough.
* Make sure the armor/clothing pieces are not clipping through one another.
* The vertices along the center world line (symmetry line) should be obviously aligned correctly in the center.
* Close your armor pieces: the player starts with a naked model then can individually dress up his character with any armor piece you’re going to make. It is therefore important there are no holes. Also, make sure your Lowerbody and Upperbody pieces hide the cut at the waistline level.
* About objects that can bend (e.g. tails), don't put concave (=bending inwards) curves in it. They should be as straight as possible in neutral pose.
* Final character should be centered on origin (x0,y0,z0) and fit the naked model provided.
 
Don't forget to make a physics mesh for your character, it needs it to collide with environment and so the player can click and select your character on the screen.

== Textures ==
 
In DOS2 we use f Physically-Based Rendering (PBR). 
To learn more about PBR you can read [https://www.allegorithmic.com/pbr-guide PBR Guide by Allegorithmic here]. 
 
A creature, like troll, usually needs basemap (BM), normal map(NM) and physical map(PM) textures. 
Larian editor uses .dds textures. 
Texture examples: 
[[File:TextureExamplesTroll.jpeg|none]] 
We pack Metallness in the Red channel, Roughness in the Green channel and Ambient Occlusion in the Blue channel of Physical map. 
''Why our NM and PM textures look different from the ones used in other game engines ?'' 
-In image files (including dds) the red channel gets the least bytes assigned to it this causes some detail loss which you don't want. 
To circumvent it/improve quality, we swivel our red channel into the alpha channel to instead of outputting RGB with output xGBR maps. 
Larian primarily uses Substance Painter for texturing our characters and assets. [https://www.allegorithmic.com/buy You can get/try it here]. 
 
== Materials ==
 
After you imported your mesh and textures in the editor you need to create a material. 
We have a couple of Larian materials(shaders) you can use: 
[[File:Materials.jpeg|none]] character folder: [[File:CharacterMaterials.jpeg|none]] 
Character materials have fresnel effect on them so you can see your character in various environment and it also has MSK system, that helps you change colors on certan things like skin and cloths (more on MSK later). 
If you don't need this functionality you can use any material from the "Base_PBR" folder. 
After you created your material assign your textures in it and assign material to your mesh. (double click on material in content browser; double click on the mesh in content browser) 
If your are not using MSK but still want to use character material, just leave it empty (don't enable it in the box) or assign a black texture to it. 
You can edit the functionality of the material by right clicking it in content browser and selecting "Open in editor". 
[[File:MaterialEditor2.jpeg|none]] 
Beware if you make changes and save the material all the assets that are using the material will change accordingly. 
You can always make edits and "save as" a separate copy for testing purposes. 
Material source file can be easily changed if you select your material in the content browser and go to the side bar. 
[[File:MaterialSourceFile.jpeg|none]] 
If you change the sourcefile of the material you need to reassign textures. 
You can also see a "Material Type" parameter in the side bar of the material. the parameter will trigger different sound effects in the game depending in the type of your material, so don't leave it unassigned. 
== Visual Sets ==
Visual sets are special editor files, which help us organizing characters, their armor, body parts and colors. 
It also possible to a create without the visual set, in case you don't need any functionality mentioned above. 
Visual Set consists of 9 visual lists, where you can put meshes and 3 color lists where you can store colors. 
Visual set example: 
[[File:VisualSetExample.jpeg|none]] 
If you're working on a unique creature that doesn't need as many equipment pieces as our regular characters, you can put armor meshes in any visual list. (the names in brackets are for your convenience and consistency). 
Although it is recommended to keep something in either list #3(Torso) or #2(Head) because of material sounds functionality. 
Our troll example visual set:
[[File:TrollVisualSetExample2.jpeg|none]] 
Troll creature doesn't need to equip armor so it has some unique meshes in visual 3 (torso) list. 
!Important! You can also leave the meshes unassigned meshes by pressing "X" button. 
Space in the visual set is very limited, cause each visual set is stored in unit64. So you might have to create multiple visual sets for different armors. 
 

'''Colors in the visual set''' 
There are 3 color tabs in the Visual lists: Skin, Hair and Cloth colors. And 5 color rows you can change on the bottom. 
In the lists you can select and store colors. And in the rows on the bottom you can select colors from the list. 
[[File:VisualSetColors.jpeg|none]] 
To be able to edit colors from the visual set you need your mesh to use character pbr material and have MSKskin and/or MSKcloth. 
''Our MSK pipeline will be described below. ''

== Root Template ==
To be able to spawn a character in the editor you will need to create a root template for it. 
More advanced [[My_first:_Root_template|guide about root templates here]]
[[File:RootTemplateTroll.jpeg|none]] 
You will need to edit following parameters for your creature: 
* Ai Bounds - preferably a cylinder for the creature.
* DisplayName
* Physical Resource (physical mesh of your character)
* VisualResourseID - your actual mesh with the rig (could also be just a file with the rig)
* VisualSetResourseID (if any)
Make sure it has: 
* ExplodedResourseID
* ExplosionFX
* HitFX
* Icon
* RagdollResourseID
* Stats
Do not scale creatures unless you really need to. If scale a creature some animations, like climbing will not work properly. 
Small scale like 1.1 -1.3 is generally ok. 
Only use "IsPlayer" property for testing. 
Beware if you make your character "IsPlayer" the equipment system will not work properly. (More about equipment below) 

'''Root templates and Visual sets.'''
There are 3 ways of using visual sets for creatures in root templates: 
# Not using visual set for creatures - you put character mesh with all boned in VisualResourseID
# Using visual set only for armor/equipment for your character - character mesh with all boned in VisualResourseID + visual set with armor meshes, skinned to the character.
# Using visual set for both body parts and armor - just the rig with all bones in VisualResourseID +visual set with naked body parts and armor.
Most of the animals use #1, most of the creatures with equipment use #2 and ALL of NPC of our playable races use #3 approach. 

== Character creation visuals==
 
If you want to change Character Creation(CC) visuals you need to change "hero" root templates of our playable races: 
[[File:HeroRootTemplates.jpeg|none]] 
Hero root templates also have their own "hero" visual sets: 
[[File:HeroVisualSets.jpeg|none]] 
If you add/delete meshes from hero visual sets it will appear/disappear in Character Creation(CC). So to add/modify meshes in CC you just need to add them in those visual sets. 
Hair, Heads and Facial Features come from hero visual sets. while colors and armors in CC come from stats. 
To change the color selection available in character creation you need to change Race Presets files: 
[[File:racepresetsFile.jpeg|none]] 
To change or add color of the hair/skin you will need to change the value of the colors. 
Example of the value of the color: 
[[File:ExampleColorValue.jpeg|none]] 
Color value is "0xff" + it's Hex Color Code. So completely while color will be 0xffffffff; completely black - 0xff000000 

 
To change armor equipment and colors you will need to modify "ItemProgression", "Equipmet" and "Item Colors" stat files. Those will require more advanced knowledge. Guide on stats is still WIP here.

== Armor and Equipment ==
There is a difference in code between playable and NPC characters. NPC characters, as mentioned above, use visual sets for armor, while player characters use equipment. NPC visuals is just a rig in it's root template with all the armor and body parts stored in visual sets, while player characters have their naked body parts in them, which can't be unequiped, and are hidden when player equips armor from eq root templates. 
So when you make armor you need to ask yourself a question: 

''Do you want players to be able to equip your armor piece or is it going to be just a unique npc/creature armor? ''
'''If not:''' 
You just need to create a mesh, import it to editor and add it it your NPC visual set. 
'''If yes''' you will also need:
* Create meshes for each race and gender. So you need to have 8 meshes + 8 skeleton version variation.
* Your armor pieces needs to be made and cut the same way as already existing equipment, so they could fit with each other.
* Meshes need to be textured and masked the same way (read about MSK system below)
* Create separate eq root template and add your meshes to eq data.
* Create foldable mesh of your armor piece (Mesh that you see when you drop an armor piece on the ground)
* Crete an icon for your eq root template
* Give stats to your new equipment and make sure it can be generated for loot.

 
As an example you can check how Lizards female platemail armor is set up : 
[[:File:LizardFemalePlatemailExample.zip|Lizard Female files]] 
You will need to work in Lizards_Female_Armor_ABC, use other files as references. 
Note: if you export armor only include bones that you need, don't include entire skeleton. 
But! The character root should be always included. 
If you're making a helmet or any other piece of armor that only skinned to 1 bone, make it rigid. 
Go to "Extra Attributes" tab in maya and put "Rigid = true", otherwise it won't work in the editor. 
 
To add cloth simulation you need add "Cloth=1" in "Extra Attributes" tab in maya and add vertex paint on your mesh. 
Black for fixed vertices (0, 0, 0) Red for simulated vertices (255, 0 ,0) 
You can preview how it looks in the example file: 
[[File:ExampleFileCloth.jpeg|none]] 
In Maya, select your mesh -> go to Polygons tab -> Color -> Paint Vertex Color 
Make sure there are no elements with only red vertices. With no black vertices to fix the cloth in place it will fall apart to pieces. These pieces will fall through the level without being connected to anything. 
Make sure your cloth simulated mesh has only 1 smoothing group. To be sure in Maya, select your mesh -> go to Polygons tab -> Normals -> Soften Edge 
Try not to go too high poly with your cloth simulated meshes, as it will affect performance. Keep it <400 vertices per cloth mesh. 
Don't put cloth simulated meshes in the areas where they will bend (elbows, shoulders, knees) it won't look good. 
If you added cloth to a mesh when you double click on it in content browser you will be able to edit some cloth parameters: 
[[File:ClothParameters.jpeg|none]] 
Pose matching is one of the most important parameter you'll find there. Don't put it on 0 cause it will fly around too much. If you put it to high your cloth mesh will be too stiff or wouldn't simulate at all. Best results could be achieved when it's between 0.01 - 0.2 
 
'''Equipment root templates''' 
If you want to change existing equipment or add new one you'll have to work with eq roots. Each eq root has it's Equipment Data:
[[File:EqDataExample.jpeg|none]] 
You need to assign meshes to each race gender and tick the box if you want to deactivate any visual of any body part (usually you should). 
We have "Deactivate Equipment Slot Visuals" there as well, but it is used in very rare cases when we want to hide certain equipment slot whenever something is equipped. For example we have a very long robe that hides any trousers your character equips. 
 
'''Skeleton/Undead equipment''' 
Undeads are using the same rigs as alive characters versions so you can avoid remodeling entire mesh by just duplicating the existing mesh from the alive version and assigning Helper_Invisible_A material to the naked bodyparts in it. If the naked skin was baked in the texture you can use a different character material (replace the source file of the material to Characters_PRB_Skeletons from the CHaracters_PBR folder and reassign the textures) 
 
'''Hair and Helmets''' 
If you're are making an equip-able helmet you need to add a separate mesh with hair to it. It needs to be in the same granny but separate mesh with "_Hair_" in its name. In this case if a player is bald and equips your hair mesh from the helmet won't be rendered. 
[[File:HelmetHair.jpeg|none]] 
The hair and helmet is in one layer "Humans_Female_Armor_Mage_B_Helmet_A" hair is called Humans_Female_Armor_Mage_B_Hair_E_Mesh. If the player is bald and equips this helmet he'll only equip the hat.
 
== Downloadable files ==
Example files of the creatures Animals: 
[[:File:Animals_Bear_ABC.zip|Bear example]] 
[[:File:Animals_Boar_ABC.zip|Boar example]] 
[[:File:Animals_Cattle_ABC.zip|Cattle example]] 
[[:File:Animals_Crocodile_ABC.zip|Crocodile example]] 
[[:File:Animals_Deer_ABC.zip|Deer example]] 
[[:File:Animals_Dog_ABC.zip|Dog example]] 
[[:File:Animals_Frog_ABC.zip|Frog example]] 
[[:File:Animals_Pig_ABC.zip|Pig example]] 
[[:File:Animals_Rat_ABC.zip|Rat example]] 
[[:File:Animals_Salamander_ABC.zip|Salamander example]] 
[[:File:Animals_Squirrel_ABC.zip|Squirrel example]] 
[[:File:Animals_Tiger_ABC.zip|Tiger example]] 
[[:File:Animals_Turtle_ABC.zip|Turtle example]] 
[[:File:Animals_Wolf_ABC.zip|Wolf example]] 

Example files of the creatures Creatures: 
[[:File:Creatures_ElementalDevil_ABC.zip|ElementalDevil example]] 
[[:File:Creatures_Gheist_A.zip|Gheist example]] 
[[:File:Creatures_Giant_Insect_ABC.zip|Insect example]] 
[[:File:Creatures_Merman_ABC.zip|Merman example]] 
[[:File:Creatures_Nightmare_Werewolf_ABC.zip|Werewolf example]] 
[[:File:Creatures_Raanaar_Automaton_ABC.zip|Automaton example]] 
[[:File:Creatures_SourcePuppet_ABC.zip|SourcePuppet example]] 
[[:File:Creatures_Troll_ABC.zip|Troll example]]

File:LizardFemalePlatemailExample.zip

2017-10-11T14:29:46Z

Alena:

File:ClothParameters.jpeg

2017-10-11T14:29:31Z

Alena:

File:ExampleFileCloth.jpeg

2017-10-11T14:29:22Z

Alena:

My first: Character

2017-10-11T14:29:11Z

Alena:

Creating a character can be roughly divided into three parts: 
* Creating a creature (monster or animal)
* Creating body parts and hairstyles (heads, hairstyles, beards)
* Creating Armor
 
Creating custom characters is a very technical and complicated process. It will require artistic skills and profound knowledge of 3d modelling, texturing, rigging, skinning, animation and Larian editor. 
''If you do not possess all the skills mentioned above and still want to make custom characters we strongly recommend reusing existing rigs and animations. ''

To make a creature you can either: 
* Make your own custom creature, rig, animations
* Make your own custom creature that will use already existing rig and animations (recommended)

Larian pipeline of creature creation in a nutshell:
# Concept
# Creation a high poly asset in zbrush
# Retopo, unwrap
# Texturing
# Testing your mesh in the editor
# Rigging
# Skinning
# Animating
''Note: if you're reusing existing rig you can skip #6 and #8'' 
 
== File formats ==

In the editor 3d models are saved as granny files (.GR2). 
The textures are saved as DirectDraw Surface (.dds). 
{| class="wikitable"
|-
| More info on Granny 3D can be found [http://www.radgametools.com/granny.html here]
|-
| More info on DirectDraw Surface can be found [https://en.wikipedia.org/wiki/DirectDraw_Surface here]
|-
|}

== Creature editor set-up ==
Lets take an example of the troll creature. 
To be able to implement a troll creature in the game you need: 
Resources: 
* 3d model
* Textures: Base Map(BM) Normal map (NM) and Physical map(PM)
* Material
* Physics mesh
* Ragdoll mesh
* Animation files (won't be covered in this guide)
Special editor files (more on them later): 
* Visual Set
* Root Template
 
Example file of the troll creature: [[:File:Creatures_Troll_ABC.zip|Troll example]] 
Example of all the resource files in content browser: 
[[File:Troll ContentBrowserResourses.jpeg|none]]

== Modelling ==
'''General modelling tips: '''
* All the joints areas should have the proper cuts (bending cuts- see below), aligned accordingly along with the respective naked model of the race you’re modeling.
* The armors are using the same rig as the naked model, evidently joints need to be placed correctly, with as similar cuts as possible.
* No Scaling applied to the meshes: reset X-form.
* No N-gonsю Only 3 (triangles) and 4-gons (quads) are allowed.
* Delete any unused vertices and floating triangles.
* Meshes that are supposed to be cloth simulated (capes, hanging piece of cloth, flags, etc) should be built as follow: NO thickness. Try to keep their polycount optimal (500 triangles max per mesh). 
 

[[File:Joints1.jpeg|none]]
Reasons for the Cuts: 
The cuts that are made will be used to squash and stretch at joint areas. 
[[File:Joints2.jpeg|none]]
The green and red meshes are skinned to the same rig and posed in the same way. 
The green mesh has the correct shapes to create a nice rolling bend of the knee.
whilst the red mesh is missing the shapes and cannot be bend in the same way. 
[[File:Joints3.jpeg|none]]
When creating the shapes there must be enhough space to straigten the leg
the red mesh has a shape to small to straighten the leg without it collapsing on itself 
[[File:Joints4.jpeg|none]]
In this example the shapes do not match the location of the kneejoint
and there for are not used in the skinning. 
Make sure when creating the mesh to look at the '''size''' of the shape and '''location''' of the joints. 

[[File:Fingers.jpeg|none]]
When making the Fingers make sure they all rotate the same way in their base position 
* Bottom of feet should be as flat as possible.
* Use smoothing groups sparingly AND intelligently: don’t use 32 smoothing groups when 4 is enough.
* Make sure the armor/clothing pieces are not clipping through one another.
* The vertices along the center world line (symmetry line) should be obviously aligned correctly in the center.
* Close your armor pieces: the player starts with a naked model then can individually dress up his character with any armor piece you’re going to make. It is therefore important there are no holes. Also, make sure your Lowerbody and Upperbody pieces hide the cut at the waistline level.
* About objects that can bend (e.g. tails), don't put concave (=bending inwards) curves in it. They should be as straight as possible in neutral pose.
* Final character should be centered on origin (x0,y0,z0) and fit the naked model provided.
 
Don't forget to make a physics mesh for your character, it needs it to collide with environment and so the player can click and select your character on the screen.

== Textures ==
 
In DOS2 we use f Physically-Based Rendering (PBR). 
To learn more about PBR you can read [https://www.allegorithmic.com/pbr-guide PBR Guide by Allegorithmic here]. 
 
A creature, like troll, usually needs basemap (BM), normal map(NM) and physical map(PM) textures. 
Larian editor uses .dds textures. 
Texture examples: 
[[File:TextureExamplesTroll.jpeg|none]] 
We pack Metallness in the Red channel, Roughness in the Green channel and Ambient Occlusion in the Blue channel of Physical map. 
''Why our NM and PM textures look different from the ones used in other game engines ?'' 
-In image files (including dds) the red channel gets the least bytes assigned to it this causes some detail loss which you don't want. 
To circumvent it/improve quality, we swivel our red channel into the alpha channel to instead of outputting RGB with output xGBR maps. 
Larian primarily uses Substance Painter for texturing our characters and assets. [https://www.allegorithmic.com/buy You can get/try it here]. 
 
== Materials ==
 
After you imported your mesh and textures in the editor you need to create a material. 
We have a couple of Larian materials(shaders) you can use: 
[[File:Materials.jpeg|none]] character folder: [[File:CharacterMaterials.jpeg|none]] 
Character materials have fresnel effect on them so you can see your character in various environment and it also has MSK system, that helps you change colors on certan things like skin and cloths (more on MSK later). 
If you don't need this functionality you can use any material from the "Base_PBR" folder. 
After you created your material assign your textures in it and assign material to your mesh. (double click on material in content browser; double click on the mesh in content browser) 
If your are not using MSK but still want to use character material, just leave it empty (don't enable it in the box) or assign a black texture to it. 
You can edit the functionality of the material by right clicking it in content browser and selecting "Open in editor". 
[[File:MaterialEditor2.jpeg|none]] 
Beware if you make changes and save the material all the assets that are using the material will change accordingly. 
You can always make edits and "save as" a separate copy for testing purposes. 
Material source file can be easily changed if you select your material in the content browser and go to the side bar. 
[[File:MaterialSourceFile.jpeg|none]] 
If you change the sourcefile of the material you need to reassign textures. 
You can also see a "Material Type" parameter in the side bar of the material. the parameter will trigger different sound effects in the game depending in the type of your material, so don't leave it unassigned. 
== Visual Sets ==
Visual sets are special editor files, which help us organizing characters, their armor, body parts and colors. 
It also possible to a create without the visual set, in case you don't need any functionality mentioned above. 
Visual Set consists of 9 visual lists, where you can put meshes and 3 color lists where you can store colors. 
Visual set example: 
[[File:VisualSetExample.jpeg|none]] 
If you're working on a unique creature that doesn't need as many equipment pieces as our regular characters, you can put armor meshes in any visual list. (the names in brackets are for your convenience and consistency). 
Although it is recommended to keep something in either list #3(Torso) or #2(Head) because of material sounds functionality. 
Our troll example visual set:
[[File:TrollVisualSetExample2.jpeg|none]] 
Troll creature doesn't need to equip armor so it has some unique meshes in visual 3 (torso) list. 
!Important! You can also leave the meshes unassigned meshes by pressing "X" button. 
Space in the visual set is very limited, cause each visual set is stored in unit64. So you might have to create multiple visual sets for different armors. 
 

'''Colors in the visual set''' 
There are 3 color tabs in the Visual lists: Skin, Hair and Cloth colors. And 5 color rows you can change on the bottom. 
In the lists you can select and store colors. And in the rows on the bottom you can select colors from the list. 
[[File:VisualSetColors.jpeg|none]] 
To be able to edit colors from the visual set you need your mesh to use character pbr material and have MSKskin and/or MSKcloth. 
''Our MSK pipeline will be described below. ''

== Root Template ==
To be able to spawn a character in the editor you will need to create a root template for it. 
More advanced [[My_first:_Root_template|guide about root templates here]]
[[File:RootTemplateTroll.jpeg|none]] 
You will need to edit following parameters for your creature: 
* Ai Bounds - preferably a cylinder for the creature.
* DisplayName
* Physical Resource (physical mesh of your character)
* VisualResourseID - your actual mesh with the rig (could also be just a file with the rig)
* VisualSetResourseID (if any)
Make sure it has: 
* ExplodedResourseID
* ExplosionFX
* HitFX
* Icon
* RagdollResourseID
* Stats
Do not scale creatures unless you really need to. If scale a creature some animations, like climbing will not work properly. 
Small scale like 1.1 -1.3 is generally ok. 
Only use "IsPlayer" property for testing. 
Beware if you make your character "IsPlayer" the equipment system will not work properly. (More about equipment below) 

'''Root templates and Visual sets.'''
There are 3 ways of using visual sets for creatures in root templates: 
# Not using visual set for creatures - you put character mesh with all boned in VisualResourseID
# Using visual set only for armor/equipment for your character - character mesh with all boned in VisualResourseID + visual set with armor meshes, skinned to the character.
# Using visual set for both body parts and armor - just the rig with all bones in VisualResourseID +visual set with naked body parts and armor.
Most of the animals use #1, most of the creatures with equipment use #2 and ALL of NPC of our playable races use #3 approach. 

== Character creation visuals==
 
If you want to change Character Creation(CC) visuals you need to change "hero" root templates of our playable races: 
[[File:HeroRootTemplates.jpeg|none]] 
Hero root templates also have their own "hero" visual sets: 
[[File:HeroVisualSets.jpeg|none]] 
If you add/delete meshes from hero visual sets it will appear/disappear in Character Creation(CC). So to add/modify meshes in CC you just need to add them in those visual sets. 
Hair, Heads and Facial Features come from hero visual sets. while colors and armors in CC come from stats. 
To change the color selection available in character creation you need to change Race Presets files: 
[[File:racepresetsFile.jpeg|none]] 
To change or add color of the hair/skin you will need to change the value of the colors. 
Example of the value of the color: 
[[File:ExampleColorValue.jpeg|none]] 
Color value is "0xff" + it's Hex Color Code. So completely while color will be 0xffffffff; completely black - 0xff000000 

 
To change armor equipment and colors you will need to modify "ItemProgression", "Equipmet" and "Item Colors" stat files. Those will require more advanced knowledge. Guide on stats is still WIP here.

== Armor and Equipment ==
There is a difference in code between playable and NPC characters. NPC characters, as mentioned above, use visual sets for armor, while player characters use equipment. NPC visuals is just a rig in it's root template with all the armor and body parts stored in visual sets, while player characters have their naked body parts in them, which can't be unequiped, and are hidden when player equips armor from eq root templates. 
So when you make armor you need to ask yourself a question: 

''Do you want players to be able to equip your armor piece or is it going to be just a unique npc/creature armor? ''
'''If not:''' 
You just need to create a mesh, import it to editor and add it it your NPC visual set. 
'''If yes''' you will also need:
* Create meshes for each race and gender. So you need to have 8 meshes + 8 skeleton version variation.
* Your armor pieces needs to be made and cut the same way as already existing equipment, so they could fit with each other.
* Meshes need to be textured and masked the same way (read about MSK system below)
* Create separate eq root template and add your meshes to eq data.
* Create foldable mesh of your armor piece (Mesh that you see when you drop an armor piece on the ground)
* Crete an icon for your eq root template
* Give stats to your new equipment and make sure it can be generated for loot.

 
As an example you can check how Lizards female platemail armor is set up : 
[[:File:LizardFemalePlatemailExample.zip|Lizard Female files]] 
You will need to work in Lizards_Female_Armor_ABC, use other files as references. 
Note: if you export armor only include bones that you need, don't include entire skeleton. 
But! The character root should be always included. 
If you're making a helmet or any other piece of armor that only skinned to 1 bone, make it rigid. 
Go to "Extra Attributes" tab in maya and put "Rigid = true", otherwise it won't work in the editor. 
 
To add cloth simulation you need add "Cloth=1" in "Extra Attributes" tab in maya and add vertex paint on your mesh. 
Black for fixed vertices (0, 0, 0) Red for simulated vertices (255, 0 ,0) 
You can preview how it looks in the example file: 
[[File:ExampleFileCloth.jpeg|none]] 
In Maya, select your mesh -> go to Polygons tab -> Color -> Paint Vertex Color 
Make sure there are no elements with only red vertices. With no black vertices to fix the cloth in place it will fall apart to pieces. These pieces will fall through the level without being connected to anything. 
Make sure your cloth simulated mesh has only 1 smoothing group. To be sure in Maya, select your mesh -> go to Polygons tab -> Normals -> Soften Edge 
Try not to go too high poly with your cloth simulated meshes, as it will affect performance. Keep it <400 vertices per cloth mesh. 
Don't put cloth simulated meshes in the areas where they will bend (elbows, shoulders, knees) it won't look good. 
If you added cloth to a mesh when you double click on it in content browser you will be able to edit some cloth parameters: 
[[File:ClothParameters.jpeg|none]] 
Pose matching is one of the most important parameter you'll find there. Don't put it on 0 cause it will fly around too much. If you put it to high your cloth mesh will be too stiff or would not simulate at all. Best results could be achieved when it's between 0.01 - 0.2 

== Downloadable files ==
Example files of the creatures Animals: 
[[:File:Animals_Bear_ABC.zip|Bear example]] 
[[:File:Animals_Boar_ABC.zip|Boar example]] 
[[:File:Animals_Cattle_ABC.zip|Cattle example]] 
[[:File:Animals_Crocodile_ABC.zip|Crocodile example]] 
[[:File:Animals_Deer_ABC.zip|Deer example]] 
[[:File:Animals_Dog_ABC.zip|Dog example]] 
[[:File:Animals_Frog_ABC.zip|Frog example]] 
[[:File:Animals_Pig_ABC.zip|Pig example]] 
[[:File:Animals_Rat_ABC.zip|Rat example]] 
[[:File:Animals_Salamander_ABC.zip|Salamander example]] 
[[:File:Animals_Squirrel_ABC.zip|Squirrel example]] 
[[:File:Animals_Tiger_ABC.zip|Tiger example]] 
[[:File:Animals_Turtle_ABC.zip|Turtle example]] 
[[:File:Animals_Wolf_ABC.zip|Wolf example]] 

Example files of the creatures Creatures: 
[[:File:Creatures_ElementalDevil_ABC.zip|ElementalDevil example]] 
[[:File:Creatures_Gheist_A.zip|Gheist example]] 
[[:File:Creatures_Giant_Insect_ABC.zip|Insect example]] 
[[:File:Creatures_Merman_ABC.zip|Merman example]] 
[[:File:Creatures_Nightmare_Werewolf_ABC.zip|Werewolf example]] 
[[:File:Creatures_Raanaar_Automaton_ABC.zip|Automaton example]] 
[[:File:Creatures_SourcePuppet_ABC.zip|SourcePuppet example]] 
[[:File:Creatures_Troll_ABC.zip|Troll example]]

My first: Character

2017-10-11T13:42:17Z

Alena:

Creating a character can be roughly divided into three parts: 
* Creating a creature (monster or animal)
* Creating body parts and hairstyles (heads, hairstyles, beards)
* Creating Armor
 
Creating custom characters is a very technical and complicated process. It will require artistic skills and profound knowledge of 3d modelling, texturing, rigging, skinning, animation and Larian editor. 
''If you do not possess all the skills mentioned above and still want to make custom characters we strongly recommend reusing existing rigs and animations. ''

To make a creature you can either: 
* Make your own custom creature, rig, animations
* Make your own custom creature that will use already existing rig and animations (recommended)

Larian pipeline of creature creation in a nutshell:
# Concept
# Creation a high poly asset in zbrush
# Retopo, unwrap
# Texturing
# Testing your mesh in the editor
# Rigging
# Skinning
# Animating
''Note: if you're reusing existing rig you can skip #6 and #8'' 
 
== File formats ==

In the editor 3d models are saved as granny files (.GR2). 
The textures are saved as DirectDraw Surface (.dds). 
{| class="wikitable"
|-
| More info on Granny 3D can be found [http://www.radgametools.com/granny.html here]
|-
| More info on DirectDraw Surface can be found [https://en.wikipedia.org/wiki/DirectDraw_Surface here]
|-
|}

== Creature editor set-up ==
Lets take an example of the troll creature. 
To be able to implement a troll creature in the game you need: 
Resources: 
* 3d model
* Textures: Base Map(BM) Normal map (NM) and Physical map(PM)
* Material
* Physics mesh
* Ragdoll mesh
* Animation files (won't be covered in this guide)
Special editor files (more on them later): 
* Visual Set
* Root Template
 
Example file of the troll creature: [[:File:Creatures_Troll_ABC.zip|Troll example]] 
Example of all the resource files in content browser: 
[[File:Troll ContentBrowserResourses.jpeg|none]]

== Modelling ==
'''General modelling tips: '''
* All the joints areas should have the proper cuts (bending cuts- see below), aligned accordingly along with the respective naked model of the race you’re modeling.
* The armors are using the same rig as the naked model, evidently joints need to be placed correctly, with as similar cuts as possible.
* No Scaling applied to the meshes: reset X-form.
* No N-gonsю Only 3 (triangles) and 4-gons (quads) are allowed.
* Delete any unused vertices and floating triangles.
* Meshes that are supposed to be cloth simulated (capes, hanging piece of cloth, flags, etc) should be built as follow: NO thickness. Try to keep their polycount optimal (500 triangles max per mesh). 
 

[[File:Joints1.jpeg|none]]
Reasons for the Cuts: 
The cuts that are made will be used to squash and stretch at joint areas. 
[[File:Joints2.jpeg|none]]
The green and red meshes are skinned to the same rig and posed in the same way. 
The green mesh has the correct shapes to create a nice rolling bend of the knee.
whilst the red mesh is missing the shapes and cannot be bend in the same way. 
[[File:Joints3.jpeg|none]]
When creating the shapes there must be enhough space to straigten the leg
the red mesh has a shape to small to straighten the leg without it collapsing on itself 
[[File:Joints4.jpeg|none]]
In this example the shapes do not match the location of the kneejoint
and there for are not used in the skinning. 
Make sure when creating the mesh to look at the '''size''' of the shape and '''location''' of the joints. 

[[File:Fingers.jpeg|none]]
When making the Fingers make sure they all rotate the same way in their base position 
* Bottom of feet should be as flat as possible.
* Use smoothing groups sparingly AND intelligently: don’t use 32 smoothing groups when 4 is enough.
* Make sure the armor/clothing pieces are not clipping through one another.
* The vertices along the center world line (symmetry line) should be obviously aligned correctly in the center.
* Close your armor pieces: the player starts with a naked model then can individually dress up his character with any armor piece you’re going to make. It is therefore important there are no holes. Also, make sure your Lowerbody and Upperbody pieces hide the cut at the waistline level.
* About objects that can bend (e.g. tails), don't put concave (=bending inwards) curves in it. They should be as straight as possible in neutral pose.
* Final character should be centered on origin (x0,y0,z0) and fit the naked model provided.
 
Don't forget to make a physics mesh for your character, it needs it to collide with environment and so the player can click and select your character on the screen.

== Textures ==
 
In DOS2 we use f Physically-Based Rendering (PBR). 
To learn more about PBR you can read [https://www.allegorithmic.com/pbr-guide PBR Guide by Allegorithmic here]. 
 
A creature, like troll, usually needs basemap (BM), normal map(NM) and physical map(PM) textures. 
Larian editor uses .dds textures. 
Texture examples: 
[[File:TextureExamplesTroll.jpeg|none]] 
We pack Metallness in the Red channel, Roughness in the Green channel and Ambient Occlusion in the Blue channel of Physical map. 
''Why our NM and PM textures look different from the ones used in other game engines ?'' 
-In image files (including dds) the red channel gets the least bytes assigned to it this causes some detail loss which you don't want. 
To circumvent it/improve quality, we swivel our red channel into the alpha channel to instead of outputting RGB with output xGBR maps. 
Larian primarily uses Substance Painter for texturing our characters and assets. [https://www.allegorithmic.com/buy You can get/try it here]. 
 
== Materials ==
 
After you imported your mesh and textures in the editor you need to create a material. 
We have a couple of Larian materials(shaders) you can use: 
[[File:Materials.jpeg|none]] character folder: [[File:CharacterMaterials.jpeg|none]] 
Character materials have fresnel effect on them so you can see your character in various environment and it also has MSK system, that helps you change colors on certan things like skin and cloths (more on MSK later). 
If you don't need this functionality you can use any material from the "Base_PBR" folder. 
After you created your material assign your textures in it and assign material to your mesh. (double click on material in content browser; double click on the mesh in content browser) 
If your are not using MSK but still want to use character material, just leave it empty (don't enable it in the box) or assign a black texture to it. 
You can edit the functionality of the material by right clicking it in content browser and selecting "Open in editor". 
[[File:MaterialEditor2.jpeg|none]] 
Beware if you make changes and save the material all the assets that are using the material will change accordingly. 
You can always make edits and "save as" a separate copy for testing purposes. 
Material source file can be easily changed if you select your material in the content browser and go to the side bar. 
[[File:MaterialSourceFile.jpeg|none]] 
If you change the sourcefile of the material you need to reassign textures. 
You can also see a "Material Type" parameter in the side bar of the material. the parameter will trigger different sound effects in the game depending in the type of your material, so don't leave it unassigned. 
== Visual Sets ==
Visual sets are special editor files, which help us organizing characters, their armor, body parts and colors. 
It also possible to a create without the visual set, in case you don't need any functionality mentioned above. 
Visual Set consists of 9 visual lists, where you can put meshes and 3 color lists where you can store colors. 
Visual set example: 
[[File:VisualSetExample.jpeg|none]] 
If you're working on a unique creature that doesn't need as many equipment pieces as our regular characters, you can put armor meshes in any visual list. (the names in brackets are for your convenience and consistency). 
Although it is recommended to keep something in either list #3(Torso) or #2(Head) because of material sounds functionality. 
Our troll example visual set:
[[File:TrollVisualSetExample2.jpeg|none]] 
Troll creature doesn't need to equip armor so it has some unique meshes in visual 3 (torso) list. 
!Important! You can also leave the meshes unassigned meshes by pressing "X" button. 
Space in the visual set is very limited, cause each visual set is stored in unit64. So you might have to create multiple visual sets for different armors. 
 

'''Colors in the visual set''' 
There are 3 color tabs in the Visual lists: Skin, Hair and Cloth colors. And 5 color rows you can change on the bottom. 
In the lists you can select and store colors. And in the rows on the bottom you can select colors from the list. 
[[File:VisualSetColors.jpeg|none]] 
To be able to edit colors from the visual set you need your mesh to use character pbr material and have MSKskin and/or MSKcloth. 
''Our MSK pipeline will be described below. ''

== Root Template ==
To be able to spawn a character in the editor you will need to create a root template for it. 
More advanced [[My_first:_Root_template|guide about root templates here]]
[[File:RootTemplateTroll.jpeg|none]] 
You will need to edit following parameters for your creature: 
* Ai Bounds - preferably a cylinder for the creature.
* DisplayName
* Physical Resource (physical mesh of your character)
* VisualResourseID - your actual mesh with the rig (could also be just a file with the rig)
* VisualSetResourseID (if any)
Make sure it has: 
* ExplodedResourseID
* ExplosionFX
* HitFX
* Icon
* RagdollResourseID
* Stats
Do not scale creatures unless you really need to. If scale a creature some animations, like climbing will not work properly. 
Small scale like 1.1 -1.3 is generally ok. 
Only use "IsPlayer" property for testing. 
Beware if you make your character "IsPlayer" the equipment system will not work properly. (More about equipment below) 

'''Root templates and Visual sets.'''
There are 3 ways of using visual sets for creatures in root templates: 
# Not using visual set for creatures - you put character mesh with all boned in VisualResourseID
# Using visual set only for armor/equipment for your character - character mesh with all boned in VisualResourseID + visual set with armor meshes, skinned to the character.
# Using visual set for both body parts and armor - just the rig with all bones in VisualResourseID +visual set with naked body parts and armor.
Most of the animals use #1, most of the creatures with equipment use #2 and ALL of NPC of our playable races use #3 approach. 

== Character creation visuals==
 
If you want to change Character Creation(CC) visuals you need to change "hero" root templates of our playable races: 
[[File:HeroRootTemplates.jpeg|none]] 
Hero root templates also have their own "hero" visual sets: 
[[File:HeroVisualSets.jpeg|none]] 
If you add/delete meshes from hero visual sets it will appear/disappear in Character Creation(CC). So to add/modify meshes in CC you just need to add them in those visual sets. 
Hair, Heads and Facial Features come from hero visual sets. while colors and armors in CC come from stats. 
To change the color selection available in character creation you need to change Race Presets files: 
[[File:racepresetsFile.jpeg|none]] 
To change or add color of the hair/skin you will need to change the value of the colors. 
Example of the value of the color: 
[[File:ExampleColorValue.jpeg|none]] 
Color value is "0xff" + it's Hex Color Code. So completely while color will be 0xffffffff; completely black - 0xff000000 

 
To change armor equipment and colors you will need to modify "ItemProgression", "Equipmet" and "Item Colors" stat files. Those will require more advanced knowledge. Guide on stats is still WIP here.

== Armor and Equipment ==
There is a difference in code between playable and NPC characters. NPC characters, as mentioned above, use visual sets for armor, while player characters use equipment. NPC visuals is just a rig in it's root template with all the armor and body parts stored in visual sets, while player characters have their naked body parts in them, which can't be unequiped, and are hidden when player equips armor from eq root templates. 
So when you make armor you need to ask yourself a question: 
Do you want players to be able to equip your armor piece or is it going to be just a unique npc/creature armor? 
If not: 
You just need to create a mesh, import it to editor and add it it your NPC visual set. 
* If yes you need to make sure you do the following: 
* Create meshes for each race and gender. So you need to have 8 meshes + 8 skeleton version variation.
* Your armor pieces needs to be made and cut the same way as already existing equipment, so they could fit with each other.
* Meshes need to be textured and masked the same way (read about MSK system below)
* Create separate eq root template and add your meshes to eq data.
* Create foldable mesh of your armor piece (Mesh that you see when you drop an armor piece on the ground)
* Crete an icon for your eq root template
* Give stats to your new equipment and make sure it can be generated for loot.

 

== Downloadable files ==
Example files of the creatures Animals: 
[[:File:Animals_Bear_ABC.zip|Bear example]] 
[[:File:Animals_Boar_ABC.zip|Boar example]] 
[[:File:Animals_Cattle_ABC.zip|Cattle example]] 
[[:File:Animals_Crocodile_ABC.zip|Crocodile example]] 
[[:File:Animals_Deer_ABC.zip|Deer example]] 
[[:File:Animals_Dog_ABC.zip|Dog example]] 
[[:File:Animals_Frog_ABC.zip|Frog example]] 
[[:File:Animals_Pig_ABC.zip|Pig example]] 
[[:File:Animals_Rat_ABC.zip|Rat example]] 
[[:File:Animals_Salamander_ABC.zip|Salamander example]] 
[[:File:Animals_Squirrel_ABC.zip|Squirrel example]] 
[[:File:Animals_Tiger_ABC.zip|Tiger example]] 
[[:File:Animals_Turtle_ABC.zip|Turtle example]] 
[[:File:Animals_Wolf_ABC.zip|Wolf example]] 

Example files of the creatures Creatures: 
[[:File:Creatures_ElementalDevil_ABC.zip|ElementalDevil example]] 
[[:File:Creatures_Gheist_A.zip|Gheist example]] 
[[:File:Creatures_Giant_Insect_ABC.zip|Insect example]] 
[[:File:Creatures_Merman_ABC.zip|Merman example]] 
[[:File:Creatures_Nightmare_Werewolf_ABC.zip|Werewolf example]] 
[[:File:Creatures_Raanaar_Automaton_ABC.zip|Automaton example]] 
[[:File:Creatures_SourcePuppet_ABC.zip|SourcePuppet example]] 
[[:File:Creatures_Troll_ABC.zip|Troll example]]