Difference between revisions of "Part 1: creating a new skill"

From Divinity Engine Wiki
Jump to: navigation, search
m (Protected "Part 1: creating a new skill" ([Edit=⧼protect-level-larianeditonly⧽] (indefinite) [Move=⧼protect-level-larianeditonly⧽] (indefinite)))
 
(28 intermediate revisions by one other user not shown)
Line 1: Line 1:
 +
This article is part of a 4-part series on how to create, edit and use a new skill.
 +
 +
{| class="wikitable"
 +
|-
 +
| [[Part 1: creating a new skill]]
 +
|-
 +
| [[Part 2: creating a skill from existing]]
 +
|-
 +
| [[Part 3: creating and using a skillbook]]
 +
|-
 +
| [[Part 4: adding the skillbook to a vendor]]
 +
|-
 +
|}
 +
 +
This article describes how to create a blank skill entry.
 +
 +
<br />
 
== Introduction ==
 
== Introduction ==
 
Creating skills in your mod is easier than ever with our newly introduced tool, the [[Stats editor]].
 
Creating skills in your mod is easier than ever with our newly introduced tool, the [[Stats editor]].
 
To create a new, useable skill you need 3 things:
 
* A new skill entry in the stats editor
 
* A new skillbook entry in the stats editor
 
* A skillbook template
 
  
 
<br />
 
<br />
== Creating our skill ==
+
== Creating a skill ==
 
=== Step 1: Opening the Stats Editor ===
 
=== Step 1: Opening the Stats Editor ===
 
[[File:Step1_OpenStatsEditor.png|none]]
 
[[File:Step1_OpenStatsEditor.png|none]]
Line 24: Line 36:
  
 
<br />
 
<br />
[[File:Step2_CreateObjectStats.png|none]]
+
=== Step 2: Adding a projectile skill entry ===
<sub>Creating the Object document</sub>
+
[[File:Step2_BlankProjectileSkillEntry.png|none]]
 
+
<sub>Creating a blank projectile skill entry</sub>
 
 
Finally, we need to create the Object stats document. Create and open the document the same way as we did for the skill_projectile document.
 
 
 
<br />
 
=== Step 2: Creating a new Skill ===
 
[[File:Step3_CopySkill.png|none]]
 
<sub>Copying an existing skill</sub>
 
 
 
  
After creating the necessary documents in our project, we copy the "LightningBolt" skill from the Shared project. Copying an existing skill makes creating new skills much easier.
 
  
To copy the LightningBolt skill, first open the Skill_Projectile document in the Shared project <span style="color:#FCFF27">(1)</span>. In the image, I docked the Shared Skill_Projectile document under the Skill_Projectile document in my own project. You can do this by clicking and dragging the tab.
+
Finally, we create an entry in the Skill_Projectile document. You can add a new entry either by editing the empty row at the bottom or by clicking the [+] button at the top of the document.
  
Then, select the LightningBolt stats entry, copy it (Ctrl+C), select the empty row in your project's Skill_Projectile document, and paste (Ctrl+V) <span style="color:#FCFF27">(2)</span>.
+
The only two required fields are the "Name" which serves as a (unique) identifier for the skill, and the SkillType. The SkillType can simply be set to the name of the document (Projectile in our case).
  
 
<br />
 
<br />
[[File:Step5_EditSkill.png|none]]
+
== See Also ==
<sub>Editing the new skill</sub>
+
Although adding a row to the stats document is all we need to create a new skill, our skill is far from ready to be used.
  
 
+
To create a complete and useable skill from scratch would require a lot of work. The skill itself needs an icon, casting animations, effects, and a projectile. It is therefor recommended that you create a skill based on an existing skill.
Once we copied an existing skill, we can begin editing it. I:
+
{| class="wikitable"
* Renamed the skill (LightningBolt to WaterBolt)
+
|-
* Changed the action point cost (2 to 1)
+
| [[Part 1: creating a new skill]]
* Changed the cooldown (3 turns to 0)
+
|-
* Changed whether the skill can target terrain
+
| [[Part 2: creating a skill from existing]]
* Changed the projectile template (see next step)
+
|-
* Changed the DisplayName, the name the skill will get in-game
+
| [[Part 3: creating and using a skillbook]]
* Changed the Description, which will be visible in game
+
|-
* Removed the MemorizationRequirements, from 1 Aerotheurge to nothing
+
| [[Part 4: adding the skillbook to a vendor]]
 
+
|-
 
+
|}
Note that all these modifications except for renaming the skill are optional.
 
 
 
<br />
 
[[File:Step4_CopyProjectileId.png|none]]
 
<sub>Copying a projectile Id</sub>
 
 
 
 
 
I also changed the projectile template, which is the object a projectile skill spawns as it is flying from the caster to the target.
 
 
 
The value that needs to be assigned is a projectile template ''GUID''. I:
 
* Opened up the [[Root template panel]]
 
* Opened up the [[Sidebar]]
 
* Filtered the root template panel by projectiles <span style="color:#FCFF27">(1)</span>
 
* Filtered the projectile templates by those containing "water" <span style="color:#FCFF27">(2)</span> (you can also create a custom projectile template, which is explained further down)
 
* Selected the "RS3_Projectile_Wand_Water" projectile <span style="color:#FCFF27">(3)</span>
 
* Right clicked the "GUID" property and clicked "Copy Value" <span style="color:#FCFF27">(4)</span>
 
 
 
 
 
Once the GUID of the projectile template is copied to your clipboard, simply go back to the Stats Editor, double click the "Template" field on your new projectile and paste the GUID.
 
 
 
<br />
 
=== Step 4: Creating a Skillbook ===
 
[[File:Step6_EditObject.png|none]]
 
<sub>Copying a skillbook stats entry, like we did for the skill</sub>
 
 
 
 
 
Our skill has now been created, and is ready to be used in the game. However, we do not have a way for characters to learn the skill yet. Next, we will be creating a skillbook.
 
 
 
First, we need to create a new skillbook stats entry. We do this the same way we did it for the skill:
 
* Open the Object stats document in your project
 
* Open the Object stats document in the Shared project
 
* Find and copy the SKILLBOOK_Air_LightningBolt entry
 
 
 
 
 
I modified the following fields:
 
* Name (required)
 
* RootTemplate (see further down for creating a new skillbook template, we assign this the same way we did the projectile template)
 
* Requirements, from 1 Aerotheurge to none
 
 
 
<br />
 
[[File:Step7_CopyTemplate1.png|none]]
 
<sub>Copying a root template</sub>
 
 
 
 
 
To create our new skillbook template we:
 
* Open the [[Root template panel]]
 
* Filter the root templates by item templates
 
* Filter the item templates by "lightningbolt"
 
* Select and right-click the "BOOK_Skill_Air_LightningBolt" template, which is the skillbook for the LightningBolt skill
 
* Click "Create new from selected..."
 
 
 
<br />
 
[[File:Step7_CopyTemplate2.png|none]]
 
<sub>The Create Object Wizard</sub>
 
 
 
<br />
 
[[File:Step8_CreateFolder.png|none]]
 
 
 
<br />
 
[[File:Step9_MoveTemplate.png|none]]
 
 
 
<br />
 
[[File:Step10_AssignRootTemplate.png|none]]
 
 
 
<br />
 
[[File:Step11_SetOnUseAction.png|none]]
 
 
 
<br />
 
=== Step 5: Using our Skill ===
 
[[File:Step12_PlaceTemplate.png|none]]
 
 
 
<br />
 
[[File:Step13_UseSkill.png|none]]
 
  
 
<br />
 
<br />

Latest revision as of 12:09, 2 October 2017

This article is part of a 4-part series on how to create, edit and use a new skill.

Part 1: creating a new skill
Part 2: creating a skill from existing
Part 3: creating and using a skillbook
Part 4: adding the skillbook to a vendor

This article describes how to create a blank skill entry.


Introduction

Creating skills in your mod is easier than ever with our newly introduced tool, the Stats editor.


Creating a skill

Step 1: Opening the Stats Editor

Step1 OpenStatsEditor.png

The Stats Editor button


First, we need to open up the stats editor. To do this, locate the "Stats Editor" button on the menu bar (under "Editors").


Step3 CreateSkillDataStats.png

Creating the Skill_Projectile document


Next, we need to create the Skill_Projectile stats document in our project. If the document already exists, you can skip this step. To open the document, expand the "SkillData" item and double click the "Skill_Projectile" item.


Step 2: Adding a projectile skill entry

Step2 BlankProjectileSkillEntry.png

Creating a blank projectile skill entry


Finally, we create an entry in the Skill_Projectile document. You can add a new entry either by editing the empty row at the bottom or by clicking the [+] button at the top of the document.

The only two required fields are the "Name" which serves as a (unique) identifier for the skill, and the SkillType. The SkillType can simply be set to the name of the document (Projectile in our case).


See Also

Although adding a row to the stats document is all we need to create a new skill, our skill is far from ready to be used.

To create a complete and useable skill from scratch would require a lot of work. The skill itself needs an icon, casting animations, effects, and a projectile. It is therefor recommended that you create a skill based on an existing skill.

Part 1: creating a new skill
Part 2: creating a skill from existing
Part 3: creating and using a skillbook
Part 4: adding the skillbook to a vendor