Dragon Age Toolset Wiki - User contributions [en]

Talk:Main Page

2009-11-17T04:30:18Z

Talonius:

== Add a new topic by creating a new header like this one ==

And then write your comment below it. Sign your comment with four tildes, like so: <nowiki>~~~~</nowiki>. It is automatically substituted with your user name and a link to your user page.

:To respond to someone else's comment, use a colon at the beginning of your response to indent it.

::Two colons indent twice, and so forth.

== Can we add a link to the Level Editor tutorial to the list of tutorials on the main page? ==

I don't know how to do it myself, but it seems like the Level Editor tutorial belongs before the Area tutorial in that list on the main page.

== Tutorials ==
I moved the placeable tutorial to second on the list, because it doesn't work unless you already created a module in the area tutorial.
[[User:Proleric1|Proleric1]] 12:41, 25 October 2009 (UTC)

== Events ==
The list of events is actually here:
http://social.bioware.com/wiki/datoolset/index.php/Category:Event_types [[User:Proleric1|Proleric1]] 07:59, 15 October 2009 (UTC)

== NDA ==
I suspect that the NDA no longer applies to the Wiki, since the latter does not touch on the three topics that Chris Priestly asked us not to discuss in his e-mail of 13-Jul-2009.
[[User:Proleric1|Proleric1]] 09:42, 25 July 2009 (UTC)
:Surely no NDA applies now, as the wiki is in the public domain? [[User:Proleric1|Proleric1]] 07:47, 15 October 2009 (UTC)
::Probably not. I'll ask around to make sure, though. [[User:BryanDerksen|BryanDerksen]] 19:44, 15 October 2009 (UTC)
::I've been asked to ask you to hold off on talking about the wiki until next week, to help spread the "buzz" out a bit. Right now everyone's talking about character creator, we don't want to distract from that. The folks who busted their humps on CC need their due. [[User:BryanDerksen|BryanDerksen]] 15:07, 16 October 2009 (UTC)
::Heh. I see Sunjammer just posted about the wiki on the forum, directing people here. Oh well. :) [[User:BryanDerksen|BryanDerksen]] 15:41, 16 October 2009 (UTC)

== Toolset download location ==

Someone should probably post a link to the location of the toolset here and/or in the installation page, to go with the instructions. It's a bit slow on the various EA/Bioware servers right now to just search around for them, and there's no direct link on Google for the obvious searches yet.

Edit: That link would be:
[http://social.bioware.com/toolset.php#downloads]

According to a post by Scott Meadows,Senior Programmer in the forums, it is still not available for general download, as of 9:48pm PST. No ETA was given.

--[[User:RyanFenton|RyanFenton]] 20:45, 3 November 2009 (UTC)

:It is available now.
[[User:Rabidgerbal|Rabidgerbal]] 23:20, 6 November 2009 (UTC)

::Thanks, slipped my mind in the midst of all the troubleshooting. :) [[User:BryanDerksen|BryanDerksen]] 23:41, 6 November 2009 (UTC)

== Camp ==

How do I add stuff to the camp area? [[User:Apocalypsefu|Apocalypsefu]] 04:45, 11 November 2009 (UTC)

: [[How-tos#Insert_content_into_an_existing_area]] has a summary of how you can create an addin that adds new content to existing areas. [[User:BryanDerksen|BryanDerksen]] 01:42, 14 November 2009 (UTC)

==Ten Minute Tutorials==
I think we should create a category and or easily accessible launch page where people can contribute quick 10 minute tutorials on a variety of subjects [[User:Allan Smith|Allan Smith]] 01:54, 13 November 2009 (UTC)

==Help for the timid==
We should also put up something on the main page that helps timid editors know that it is okay to make new articles, and possibly give some guidance on naming conventions and how to get their articles included or linked from the main page (or really guidance on where they should be linked from [[User:Allan Smith|Allan Smith]] 01:54, 13 November 2009 (UTC)

:I'll come up with a page tomorrow, I should have some spare time then. :) [[User:BryanDerksen|BryanDerksen]] 01:43, 14 November 2009 (UTC)

==Added an Item Reskinning Tutorial==
See [[Tutorial: Reskinning an Item]]. Perhaps someone could add it to the list of tutorials on the main page, if appropriate?
[[User:Avantoreon|Avantoreon]] 00:38, 17 November 2009 (UTC)

== Google ==

The Wiki isn't accessible unless you have a Bioware social account; are there exceptions for Googlebot? I understand wanting to protect the contents but being searchable is a great way to be found. --[[User:Talonius|Talonius]] 04:30, 17 November 2009 (UTC)

Talk:Main Page

2009-11-17T04:29:30Z

Talonius: /* Google */ new section

User:Talonius/Sandbox

2009-11-17T04:21:09Z

Talonius:

== Creating a Small Adventure Step by Step ==

* Step #1: [[Step_by_Step:_Installing_the_Toolset|Install the Toolset]]
* Step #2: [[Step_by_Step:_Create_A_Module|Create a Module]]

 
=== Starting the Toolkit ===
[[Image:Talonius_Toolkit_Startup_Screen_001.png|thumb|left|middle|360px|The Windows 7 toolkit startup menu entry.]]

Find the Start Menu entry for the toolkit and click it. Give the toolkit some time to start up. As a benchmark, it takes approximately 12 seconds for the toolkit to start on my AMD Phenom 9850 with 4GB of RAM with a Windows Experience score 7.2.

 
=== Terminology ===
Learning something new is difficult. Concise terminology is required to give direction, but the terminology is usually somewhat recursive in definition. The following are some definitions that will help you navigate the remainder of this document.

; [[Module]]
: A module is the overarching container in which content is housed. It is the parent of all other content. The best comparison to the Dragon Age module are Dungeons and Dragons modules. Each module in D&D was a self contained adventure, complete with background, NPCs, maps, encounters, and any special rules which were to be in effect during the adventure.
; [[Area]]
: An area in a module is a self contained subset of the module, limited in size and/or scope. Areas are used to break the adventure into pieces, and are where the characters interact with the game. An area requires a level layout before it can be defined; see below. Items placed in an area are generally interactive, examinable, or dynamic in nature.
; [[Level]]
: A level defines the underlying static, immovable, non interactive portion of an area - structure and appearance. The level determines where PCs and NPCs can move (pathfinding) and lighting (ambient and otherwise). A level layout is required in order to define an area. A level can be created in one of two forms: terrain and room.
; [[Room Level]]
: TODO: Define
; [[Terrain Level]]
: TODO: Define

 
==== Create A Room Level ====
As mentioned above a level is the underlying structure to an area. For our first level we're going to start with a room level.

 
[[Image:Talonius_Toolkit_Level_Create_001.png|thumb|left|middle|360px|Creating a new level; click File, New, Level.]]

Click '''File''', then '''New''', then '''Level'''.

 
[[Image:Talonius_Toolkit_Level_Create_002.png|thumb|left|middle|360px|The Level Creation Wizard.]]

You'll find yourself in the Level Creation Wizard. The first screen prompts you to create a terrain, or exterior level, or a room (interior) level. We're going to walk through the creation of a room level first, so select '''Room Level''' and click '''Next'''.

 
[[Image:Talonius_Toolkit_Level_Create_003.png|thumb|left|middle|360px|The Level Creation Wizard.]]

If we were creating a terrain level there would be a number of options presented to us; the room level creation is much simpler.

Click '''Finish''' to create the room level.

 
==== A Tour of the Toolset Interface ====
The sheer number of icons and options on the toolset can be intimidating. We're going to highlight the important areas of the interface to help you familiarize yourself with the toolset.

 
[[Image:Talonius_Toolkit_UI_Walkthrough_002.png|thumb|left|middle|360px|The Palette Window.]]

The first section to learn about is the '''Palette Window'''. By default this is located in the upper right hand portion of the toolset screen. This window is used extensively during the creation of a module.

Two things to note: first, in the upper left corner of the Palette Window are two icons. The first is a push pin; the second is an X.

[[Image:Talonius_Toolkit_UI_Walkthrough_003.png|thumb|right|middle|360px|The Palette Window and Object Inspector windows collapsed.]]

The push pin collapses the window into the sidebar, providing a larger workspace for any remaining open windows. To reopen the window simply click on the window title in the sidebar. You can then keep the window open by hitting the push pin icon again.

The X closes the window. If you accidentally close either window they can be opened again from the '''View''', '''Palette''' selection and the '''View''', '''Other Windows''', '''Object Inspector''' for the Palette Window and Object Inspector windows respectively.

Both of these icons can be found with nearly every window within the toolset.

'''Palette Window'''

[[Category:StepByStep]]

Step by Step: Create A Module

2009-11-17T04:15:30Z

Talonius:

== Step by Step: Installing the Toolset ==
The Step by Step series of articles are meant to be a 100% walk through of an activity, complete with pertinent details and screenshots of every step of the process.

=== Modules ===
The toolset comes with two modules installed.

* The '''Single Player''' module is the campaign, and shouldn't be edited unless you want to modify the Dragon Age campaign itself. If you're creating an addin or mod for the official campaign, this is the module in which you'll want to work.
* The '''Demo''' module is installed for demonstration purposes by Bioware, and several other tutorials and forum posts refer to it.
 
[[Image:Talonius_Toolkit_Module_Current_001.png|frame|left|The currently selected module is highlighted in the red box.]]

You can easily determine which module you're editing by looking at the title bar of the toolbox. In the image the currently edited module is highlighted by the red rectangle; the example has the '''Single Player''' module loaded.

Until you're comfortable with the toolkit it's best to work in a module separate from either of the above modules.

 
=== Create A Module ===
[[Image:Talonius_Toolkit_Module_Create_001.png|thumb|left|middle|360px|The first step of creating a module.]]

To create a module click '''File''' then '''Manage Modules'''.

 
[[Image:Talonius_Toolkit_Module_Create_002.png|left|middle|frame|The manage modules window.]]

The Manage Modules window will appear. Click the '''New''' button to create a module.

 
[[Image:Talonius_Toolkit_Module_Create_003.png|thumb|left|middle|360px|The Object Inspector window showing the properties for our new module.]]

The Object Inspector window appears. All of these properties can be changed at a later date; our primary concern are the '''Name''' and '''UID''' properties.

; Name
: The name of the module is displayed to the player and is used if a '''Description String ID''' has not been set.
; UID
: The UID is not intended to be a GUID. It is used in some configuration files and is the name of the directory to which the module is exported.

You will return to the Module Properties often as there are several other important properties here.

'''Notes:'''
* Modules cannot be deleted from the toolset once they're created.
* The only valid module type is currently Addin. A module created as an Addin will appear under '''Other Campaigns''' in Dragon Age.

 
[[Image:Talonius_Toolkit_Module_Create_004.png|thumb|left|middle|360px|Sample module properties for the "Fall of Gargamel" module.]]

The image shows the module properties for the '''Fall of Gargamel''' module which we will be using for demonstration purposes.

Enter the values shown in the appropriate area, or create your own, and hit '''OK''' to continue with the module creation process.

 
[[Image:Talonius_Toolkit_Module_Create_005.png|thumb|left|middle|360px|How our module appears in the Other Campaigns menu.]]

This image gives you an idea as to where the values we're entering are being used. The menu shown is the '''Other Campaigns''' menu off the Dragon Age main menu. (The module will not show up until we export at least a portion of it; this is handled later.)

As you can see the name of our addin matches the '''Name''' property we entered in the Object Inspector window.

 
[[Image:Talonius_Toolkit_Module_Create_006.png|thumb|left|middle|360px|Shows where our files live when they are exported on Windows 7.]]

Here we can see that the directory in which our addin lives is named Gargamel, which corresponds to the '''UID''' value entered in the Object Inspector. We can also see the various DLC items that have been installed from the game.

'''Note:''' On a Windows XP computer you'll find this directory in your '''My Documents''' folder.

 
[[Image:Talonius_Toolkit_Module_Create_007.png|thumb|left|middle|360px|This is the Manage Modules window immediately after the creation of your module.]]

Once the Object Inspector closes you'll be returned to the Manage Modules window. Ensure the '''Fall of Gargamel''' module is selected and hit '''Open'''.

 
[[Image:Talonius_Toolkit_Module_Create_008.png|left|middle|frame|The toolset titlebar should now reflect Fall of Gargamel as the active module.]]

The toolset titlebar should now reflect the '''Fall of Gargamel''' as the active module. If you were to close and reopen the toolset it would default to last module you were working in.

[[Category:StepByStep]]

Step by Step: Create A Module

2009-11-17T04:13:28Z

Talonius: Separation from sandbox.

== Step by Step: Installing the Toolset ==
The Step by Step series of articles are meant to be a 100% walk through of an activity, complete with pertinent details and screenshots of every step of the process.

=== Create A Module ===
[[Image:Talonius_Toolkit_Module_Create_001.png|thumb|left|middle|360px|The first step of creating a module.]]

To create a module click '''File''' then '''Manage Modules'''.

 
[[Image:Talonius_Toolkit_Module_Create_002.png|left|middle|frame|The manage modules window.]]

The Manage Modules window will appear. Click the '''New''' button to create a module.

 
[[Image:Talonius_Toolkit_Module_Create_003.png|thumb|left|middle|360px|The Object Inspector window showing the properties for our new module.]]

The Object Inspector window appears. All of these properties can be changed at a later date; our primary concern are the '''Name''' and '''UID''' properties.

; Name
: The name of the module is displayed to the player and is used if a '''Description String ID''' has not been set.
; UID
: The UID is not intended to be a GUID. It is used in some configuration files and is the name of the directory to which the module is exported.

You will return to the Module Properties often as there are several other important properties here.

'''Notes:'''
* Modules cannot be deleted from the toolset once they're created.
* The only valid module type is currently Addin. A module created as an Addin will appear under '''Other Campaigns''' in Dragon Age.

 
[[Image:Talonius_Toolkit_Module_Create_004.png|thumb|left|middle|360px|Sample module properties for the "Fall of Gargamel" module.]]

The image shows the module properties for the '''Fall of Gargamel''' module which we will be using for demonstration purposes.

Enter the values shown in the appropriate area, or create your own, and hit '''OK''' to continue with the module creation process.

 
[[Image:Talonius_Toolkit_Module_Create_005.png|thumb|left|middle|360px|How our module appears in the Other Campaigns menu.]]

This image gives you an idea as to where the values we're entering are being used. The menu shown is the '''Other Campaigns''' menu off the Dragon Age main menu. (The module will not show up until we export at least a portion of it; this is handled later.)

As you can see the name of our addin matches the '''Name''' property we entered in the Object Inspector window.

 
[[Image:Talonius_Toolkit_Module_Create_006.png|thumb|left|middle|360px|Shows where our files live when they are exported on Windows 7.]]

Here we can see that the directory in which our addin lives is named Gargamel, which corresponds to the '''UID''' value entered in the Object Inspector. We can also see the various DLC items that have been installed from the game.

'''Note:''' On a Windows XP computer you'll find this directory in your '''My Documents''' folder.

 
[[Image:Talonius_Toolkit_Module_Create_007.png|thumb|left|middle|360px|This is the Manage Modules window immediately after the creation of your module.]]

Once the Object Inspector closes you'll be returned to the Manage Modules window. Ensure the '''Fall of Gargamel''' module is selected and hit '''Open'''.

 
[[Image:Talonius_Toolkit_Module_Create_008.png|left|middle|frame|The toolset titlebar should now reflect Fall of Gargamel as the active module.]]

The toolset titlebar should now reflect the '''Fall of Gargamel''' as the active module. If you were to close and reopen the toolset it would default to last module you were working in.

[[Category:StepByStep]]

Category:StepByStep

2009-11-17T04:07:22Z

Talonius: Created page with 'The Step by Step series of articles are meant to be a 100% walk through of an activity, complete with pertinent details and screenshots of every step of the process.'

The Step by Step series of articles are meant to be a 100% walk through of an activity, complete with pertinent details and screenshots of every step of the process.

Step by Step: Installing the Toolset

2009-11-17T04:06:47Z

Talonius: Page creation.

== Step by Step: Installing the Toolset ==
The Step by Step series of articles are meant to be a 100% walk through of an activity, complete with pertinent details and screenshots of every step of the process.

 
=== Check Prerequisites ===
Do not attempt to install the toolkit without ensuring you have at least Windows XP with Service Pack 3, Windows Vista, or Windows 7. The SP3 requirement can be overlooked if you're technically savvy but for the smoothest experience I'd recommend installing the whole shebang.

Want to know why not? Check the [http://social.bioware.com/forum/1/topic/8/index/113400 Forums].

 
=== Install Python 2.5 ===
Python 2.5 is required for the light mapping inside the toolkit to function, and it is preferred that it be installed first. ActiveState's ActivePython is the best choice, and is available for free. The latest version as of November 15, 2009 (2009/11/15) is 2.5.4.4 and it can be found [https://www.activestate.com/activepython/downloads/ here].

Caveats:
* There are some who have had issues with the 64 bit version; I personally haven't. You may want to pick up the 32 bit version just in case.
* Install to the default directory to avoid any issues with the toolkit. C:\Python25 is the normal default.

 
=== Toolkit Installation ===
These instructions and screenshots are for v1.0.982.0 of the toolkit. They may or may not apply to later versions.

The toolkit is available from [http://social.bioware.com/toolset.php#downloads Bioware's Community Site]. It's 472Mb.

Double click the executable to install the toolkit. If you have an antivirus scanner installed on your computer don't be surprised if it doesn't pop up right away; the antivirus scanner has to process all 472MB of the executable before it will be allowed to run.

If you have Windows Vista or Windows 7 you'll be prompted by UAC to allow the installer to run. Choose yes if you obtained the toolset from the Bioware site.

 
==== Welcome Screen ====
[[Image:Talonius_Toolkit_Install_Screen_001.png|thumb|left|middle|360px|This is the installer's welcome screen.]] Once the installer has started you'll be greeted with the welcome screen.
Click the '''Next''' button.

 
==== End User License Agreement ====
[[Image:Talonius_Toolkit_Install_Screen_002.png|thumb|left|middle|360px|This screenshot shows the installer's EULA agreement screen.]]

You'll be greeted with the end user license agreement. You're creating content for someone's software using this application; I highly recommend you actually read the license.

Accept the license agreement by selecting '''I accept the terms of the License Agreement''' and click '''Next'''.

 
==== Dragon Age Installation Directory Confirmation ====
[[Image:Talonius_Toolkit_Install_Screen_003.png|thumb|left|middle|360px|This shows the screen confirming the location of Dragon Age on the PC the toolset is being installed on.]]

The third screen is asking you to confirm the installation directory of Dragon Age. The toolset requires Dragon Age to be installed; if the directory shown here isn't correct I would recommend reinstalling the game, then restarting the installation of the toolkit.

If the location is correct click '''Next''' to continue.

 
==== SQL Server 2005 Express Installation ====
[[Image:Talonius_Toolkit_Install_Screen_004.png|thumb|left|middle|360px|This screen shows the configuration options for SQL Server 2005 Express.]]

SQL Server Express is a free version of SQL Server offered by Microsoft. It is a relational database that the toolset uses to store information about the currently installed modules and campaigns. Most of the problems around the installation of the toolkit revolve around the installation of SQL Server Express 2005.

If you have no idea what any of these things mean it is recommended that you leave the default settings as they are.

If you have an existing SQL Server 2005 installation you wish to use uncheck '''Install MS SQL Express 2005 SP3'''. You'll then need to check '''Custom settings:''' and enter in the information for the database you already have.

The installer will attempt to connect to the SQL Server you specify and it will run a series of scripts against the database you provided. You should ensure that SQL Server is running on the appropriate machine and that you have no data you wish to save in the database you selected to install to.

Once the configuration is to your liking click '''Install''' to continue.

 
'''Examples:'''
* My SQL Server 2005 machine is named VORTEX, and it does not have any instances installed on it. The '''database server''' for it would simply be VORTEX. The '''database name''' would remain bw_dragonage_content unless you have a reason to change it.
* My workstation also has a copy of SQL Server 2008 on it with no instances. I could reference this installation one of two ways. The first would be as BRIAN-PC; the other would be by using the period by itself.
* It should be noted that the . in the database server refers to the local machine; this should be replaced by the name of the machine on which your installation of SQL Server resides. The \BWDATOOLSET refers to the database instance on that machine.

 
'''Problems?'''
* Visit the official forums and search there before posting; the most common issues have solutions already posted.
* Check the [[Installation troubleshooting]] page.
* A log file will be created in your Documents folder during the installation. This is good to have handy if you have issues during installation. The file in question is named "Install Dragon Age Toolset.txt".

 
==== Toolkit Installation ====
[[Image:Talonius_Toolkit_Install_Screen_005.png|thumb|left|middle|360px|This screenshot shows the installer as it progresses.]]

The installation will take some time. Grab a drink, use the restroom, put together a playlist for your listening pleasure.

 
==== Toolkit Installation Finished Verification ====
[[Image:Talonius_Toolkit_Install_Screen_006.png|thumb|left|middle|360px|A screenshot of a successful installation.]]

The last item in the window above should be ''Completed''. If there's anything else scroll up in the window until you find the error and copy and paste that error somewhere for safe keeping. Seek help in the forums or on the Internet, and restart the installation process.

Click '''Next''' to continue.

 
==== Toolkit Installation Finished ====
[[Image:Talonius_Toolkit_Install_Screen_007.png|thumb|left|middle|360px|The last screen of the toolkit installation.]]

You're done. Assuming no unexpected errors appeared during the installation process you should be ready to start editing.

Click '''Finish''' to complete the installation.

[[Category:StepByStep]]

File:Talonius Toolkit UI Walkthrough 003.png

2009-11-17T03:44:53Z

Talonius: Demonstrating how the pushpin causes a window to collapse.

Demonstrating how the pushpin causes a window to collapse.

File:Talonius Toolkit UI Walkthrough 002.png

2009-11-17T03:39:29Z

Talonius: Palette Window sample.

Palette Window sample.

User:Talonius/Sandbox

2009-11-17T00:01:55Z

Talonius: Rework of images (again).

== Creating a Small Adventure Step by Step ==
This page is intended to provide step by step instructions for each portion of the module creation process, including by linkage the various other pieces of the Wiki but allowing someone to follow it and understand how all the pieces go together.

=== Check Prerequisites ===
Do not attempt to install the toolkit without ensuring you have at least Windows XP with Service Pack 3, Windows Vista, or Windows 7. The SP3 requirement can be overlooked if you're technically savvy but for the smoothest experience I'd recommend installing the whole shebang.

Want to know why not? Check the [[#http://social.bioware.com/forum/1/topic/8/index/113400|Forums]].

=== Install Python 2.5 ===
Python 2.5 is required for the light mapping inside the toolkit to function, and it is preferred that it be installed first. ActiveState's ActivePython is the best choice, and is available for free. The latest version as of November 15, 2009 (2009/11/15) is 2.5.4.4 and it can be found [[#https://www.activestate.com/activepython/downloads/|here]].

Caveats:
* There are some who have had issues with the 64 bit version; I personally haven't. You may want to pick up the 32 bit version just in case.
* Install to the default directory to avoid any issues with the toolkit. C:\Python25 is the normal default.

=== Toolkit Installation ===
These instructions and screenshots are for v1.0.982.0 of the toolkit. They may or may not apply to later versions.

The toolkit is available from [[#http://social.bioware.com/toolset.php#downloads|Bioware's Community Site]]. It's 472Mb.

Double click the executable to install the toolkit. If you have an antivirus scanner installed on your computer don't be surprised if it doesn't pop up right away; the antivirus scanner has to process all 472MB of the executable before it will be allowed to run.

If you have Windows Vista or Windows 7 you'll be prompted by UAC to allow the installer to run. Choose yes if you obtained the toolset from the Bioware site.

 
==== Welcome Screen ====
[[Image:Talonius_Toolkit_Install_Screen_001.png|thumb|left|middle|360px|This is the installer's welcome screen.]] Once the installer has started you'll be greeted with the welcome screen.
Click the '''Next''' button.

 
==== End User License Agreement ====
[[Image:Talonius_Toolkit_Install_Screen_002.png|thumb|left|middle|360px|This screenshot shows the installer's EULA agreement screen.]]

You'll be greeted with the end user license agreement. You're creating content for someone's software using this application; I highly recommend you actually read the license.

Accept the license agreement by selecting '''I accept the terms of the License Agreement''' and click '''Next'''.

 
==== Dragon Age Installation Directory Confirmation ====
[[Image:Talonius_Toolkit_Install_Screen_003.png|thumb|left|middle|360px|This shows the screen confirming the location of Dragon Age on the PC the toolset is being installed on.]]

The third screen is asking you to confirm the installation directory of Dragon Age. The toolset requires Dragon Age to be installed; if the directory shown here isn't correct I would recommend reinstalling the game, then restarting the installation of the toolkit.

If the location is correct click '''Next''' to continue.

 
==== SQL Server 2005 Express Installation ====
[[Image:Talonius_Toolkit_Install_Screen_004.png|thumb|left|middle|360px|This screen shows the configuration options for SQL Server 2005 Express.]]

SQL Server Express is a free version of SQL Server offered by Microsoft. It is a relational database that the toolset uses to store information about the currently installed modules and campaigns. Most of the problems around the installation of the toolkit revolve around the installation of SQL Server Express 2005.

If you have no idea what any of these things mean it is recommended that you leave the default settings as they are.

If you have an existing SQL Server 2005 installation you wish to use uncheck '''Install MS SQL Express 2005 SP3'''. You'll then need to check '''Custom settings:''' and enter in the information for the database you already have.

The installer will attempt to connect to the SQL Server you specify and it will run a series of scripts against the database you provided. You should ensure that SQL Server is running on the appropriate machine and that you have no data you wish to save in the database you selected to install to.

Once the configuration is to your liking click '''Install''' to continue.

 
'''Examples:'''
* My SQL Server 2005 machine is named VORTEX, and it does not have any instances installed on it. The '''database server''' for it would simply be VORTEX. The '''database name''' would remain bw_dragonage_content unless you have a reason to change it.
* My workstation also has a copy of SQL Server 2008 on it with no instances. I could reference this installation one of two ways. The first would be as BRIAN-PC; the other would be by using the period by itself.
* It should be noted that the . in the database server refers to the local machine; this should be replaced by the name of the machine on which your installation of SQL Server resides. The \BWDATOOLSET refers to the database instance on that machine.

 
'''Problems?'''
* Visit the official forums and search there before posting; the most common issues have solutions already posted.
* Check the [[Installation troubleshooting]] page.
* A log file will be created in your Documents folder during the installation. This is good to have handy if you have issues during installation. The file in question is named "Install Dragon Age Toolset.txt".

 
==== Toolkit Installation ====
[[Image:Talonius_Toolkit_Install_Screen_005.png|thumb|left|middle|360px|This screenshot shows the installer as it progresses.]]

The installation will take some time. Grab a drink, use the restroom, put together a playlist for your listening pleasure.

 
==== Toolkit Installation Finished Verification ====
[[Image:Talonius_Toolkit_Install_Screen_006.png|thumb|left|middle|360px|A screenshot of a successful installation.]]

The last item in the window above should be ''Completed''. If there's anything else scroll up in the window until you find the error and copy and paste that error somewhere for safe keeping. Seek help in the forums or on the Internet, and restart the installation process.

Click '''Next''' to continue.

 
==== Toolkit Installation Finished ====
[[Image:Talonius_Toolkit_Install_Screen_007.png|thumb|left|middle|360px|The last screen of the toolkit installation.]]

You're done. Assuming no unexpected errors appeared during the installation process you should be ready to start editing.

Click '''Finish''' to complete the installation.

 
=== Starting the Toolkit ===
[[Image:Talonius_Toolkit_Startup_Screen_001.png|thumb|left|middle|360px|The Windows 7 toolkit startup menu entry.]]

Find the Start Menu entry for the toolkit and click it. Give the toolkit some time to start up. As a benchmark, it takes approximately 12 seconds for the toolkit to start on my AMD Phenom 9850 with 4GB of RAM with a Windows Experience score 7.2.

 
=== Terminology ===
Learning something new is difficult. Concise terminology is required to give direction, but the terminology is usually somewhat recursive in definition. The following are some definitions that will help you navigate the remainder of this document.

; [[Module]]
: A module is the overarching container in which content is housed. It is the parent of all other content. The best comparison to the Dragon Age module are Dungeons and Dragons modules. Each module in D&D was a self contained adventure, complete with background, NPCs, maps, encounters, and any special rules which were to be in effect during the adventure.
; [[Area]]
: An area in a module is a self contained subset of the module, limited in size and/or scope. Areas are used to break the adventure into pieces, and are where the characters interact with the game. An area requires a level layout before it can be defined; see below. Items placed in an area are generally interactive, examinable, or dynamic in nature.
; [[Level]]
: A level defines the underlying static, immovable, non interactive portion of an area - structure and appearance. The level determines where PCs and NPCs can move (pathfinding) and lighting (ambient and otherwise). A level layout is required in order to define an area. A level can be created in one of two forms: terrain and room.
; [[Room Level]]
: TODO: Define
; [[Terrain Level]]
: TODO: Define

 
=== Modules ===
The toolset comes with two modules installed.

* The '''Single Player''' module is the campaign, and shouldn't be edited unless you want to modify the Dragon Age campaign itself. If you're creating an addin or mod for the official campaign, this is the module in which you'll want to work.
* The '''Demo''' module is installed for demonstration purposes by Bioware, and several other tutorials and forum posts refer to it.
 
[[Image:Talonius_Toolkit_Module_Current_001.png|frame|left|The currently selected module is highlighted in the red box.]]

You can easily determine which module you're editing by looking at the title bar of the toolbox. In the image the currently edited module is highlighted by the red rectangle; the example has the '''Single Player''' module loaded.

Until you're comfortable with the toolkit it's best to work in a module separate from either of the above modules.

 
==== Create A Module ====
[[Image:Talonius_Toolkit_Module_Create_001.png|thumb|left|middle|360px|The first step of creating a module.]]

To create a module click '''File''' then '''Manage Modules'''.

 
[[Image:Talonius_Toolkit_Module_Create_002.png|left|middle|frame|The manage modules window.]]

The Manage Modules window will appear. Click the '''New''' button to create a module.

 
[[Image:Talonius_Toolkit_Module_Create_003.png|thumb|left|middle|360px|The Object Inspector window showing the properties for our new module.]]

The Object Inspector window appears. All of these properties can be changed at a later date; our primary concern are the '''Name''' and '''UID''' properties.

; Name
: The name of the module is displayed to the player and is used if a '''Description String ID''' has not been set.
; UID
: The UID is not intended to be a GUID. It is used in some configuration files and is the name of the directory to which the module is exported.

We will return to the Module's Object Properties later as there are several important settings here.

'''Notes:'''
* Modules cannot be deleted from the toolset once they're created.
* The only valid module type is currently Addin. A module created as an Addin will appear under '''Other Campaigns''' in Dragon Age.

 
[[Image:Talonius_Toolkit_Module_Create_004.png|thumb|left|middle|360px|Sample module properties for the "Fall of Gargamel" module.]]

The image shows the module properties for the '''Fall of Gargamel''' module which we will be using for demonstration purposes.

Enter the values shown in the appropriate area, or create your own, and hit '''OK''' to continue with the module creation process.

 
[[Image:Talonius_Toolkit_Module_Create_005.png|thumb|left|middle|360px|How our module appears in the Other Campaigns menu.]]

This image gives you an idea as to where the values we're entering are being used. The menu shown is the '''Other Campaigns''' menu off the Dragon Age main menu. (The module will not show up until we export at least a portion of it; this is handled later.)

As you can see the name of our addin matches the '''Name''' property we entered in the Object Inspector window.

 
[[Image:Talonius_Toolkit_Module_Create_006.png|thumb|left|middle|360px|Shows where our files live when they are exported on Windows 7.]]

Here we can see that the directory in which our addin lives is named Gargamel, which corresponds to the '''UID''' value entered in the Object Inspector. We can also see the various DLC items that have been installed from the game.

'''Note:''' On a Windows XP computer you'll find this directory in your '''My Documents''' folder.

 
[[Image:Talonius_Toolkit_Module_Create_007.png|thumb|left|middle|360px|This is the Manage Modules window immediately after the creation of your module.]]

Once the Object Inspector closes you'll be returned to the Manage Modules window. Ensure the '''Fall of Gargamel''' module is selected and hit '''Open'''.

 
[[Image:Talonius_Toolkit_Module_Create_008.png|left|middle|frame|The toolset titlebar should now reflect Fall of Gargamel as the active module.]]

The toolset titlebar should now reflect the '''Fall of Gargamel''' as the active module. If you were to close and reopen the toolset it would default to last module you were working in.

 
==== Create A Room Level ====
As mentioned above a level is the underlying structure to an area. For our first level we're going to start with a room level.

 
[[Image:Talonius_Toolkit_Level_Create_001.png|thumb|left|middle|360px|Creating a new level; click File, New, Level.]]

Click '''File''', then '''New''', then '''Level'''.

 
[[Image:Talonius_Toolkit_Level_Create_002.png|thumb|left|middle|360px|The Level Creation Wizard.]]

You'll find yourself in the Level Creation Wizard. The first screen prompts you to create a terrain, or exterior level, or a room (interior) level. We're going to walk through the creation of a room level first, so select '''Room Level''' and click '''Next'''.

 
[[Image:Talonius_Toolkit_Level_Create_003.png|thumb|left|middle|360px|The Level Creation Wizard.]]

If we were creating a terrain level there would be a number of options presented to us; the room level creation is much simpler.

Click '''Finish''' to create the room level.

 
==== A Tour of the Toolset Interface ====
[[Image:Talonius_Toolkit_UI_Walkthrough_001.png|thumb|left|middle|360px|The UI of the toolset with highlighted areas which are defined.]]

You can click on the image to the left to enlarge it. The highlighted areas in the image represent the following:
# Area #1 in the upper left hand corner of the image represents the current name of the item being edited. We can see our level is currently named "Untitled.lvl"; we can also see at a glance that the ''dirty indicator'' is set for this file. The ''dirty indicator'' is the asterisk next to the name of the item.
# Area #2 in the middle of the image represents the ''viewport''. This is where we manipulate the object being defined. Currently there's a 2D graph being displayed. This graph is used to represent the X and Y coordinates of the viewport's object space. The graph is not a part of the object being edited. It is there only for clarity's sake and to aid in the positioning of objects.
# Area #3 is the ''Palette Window''. This will be a very heavily used and explained part of the toolset.
# Area #4 is the ''Object Inspector''. Again, this will be a very heavily used and explained part of the toolset.

User:Talonius/Sandbox

2009-11-16T23:36:18Z

Talonius:

== Creating a Small Adventure Step by Step ==
This page is intended to provide step by step instructions for each portion of the module creation process, including by linkage the various other pieces of the Wiki but allowing someone to follow it and understand how all the pieces go together.

=== Check Prerequisites ===
Do not attempt to install the toolkit without ensuring you have at least Windows XP with Service Pack 3, Windows Vista, or Windows 7. The SP3 requirement can be overlooked if you're technically savvy but for the smoothest experience I'd recommend installing the whole shebang.

Want to know why not? Check the [[#http://social.bioware.com/forum/1/topic/8/index/113400|Forums]].

=== Install Python 2.5 ===
Python 2.5 is required for the light mapping inside the toolkit to function, and it is preferred that it be installed first. ActiveState's ActivePython is the best choice, and is available for free. The latest version as of November 15, 2009 (2009/11/15) is 2.5.4.4 and it can be found [[#https://www.activestate.com/activepython/downloads/|here]].

Caveats:
* There are some who have had issues with the 64 bit version; I personally haven't. You may want to pick up the 32 bit version just in case.
* Install to the default directory to avoid any issues with the toolkit. C:\Python25 is the normal default.

=== Toolkit Installation ===
These instructions and screenshots are for v1.0.982.0 of the toolkit. They may or may not apply to later versions.

The toolkit is available from [[#http://social.bioware.com/toolset.php#downloads|Bioware's Community Site]]. It's 472Mb.

Double click the executable to install the toolkit. If you have an antivirus scanner installed on your computer don't be surprised if it doesn't pop up right away; the antivirus scanner has to process all 472MB of the executable before it will be allowed to run.

If you have Windows Vista or Windows 7 you'll be prompted by UAC to allow the installer to run. Choose yes if you obtained the toolset from the Bioware site.

==== Welcome Screen ====
[[Image:Talonius_Toolkit_Install_Screen_001.png|left|middle|frame|This is the installer's welcome screen.]] Click the '''Next''' button.

 
==== End User License Agreement ====
[[File:Talonius_Toolkit_Install_Screen_002.png|left|middle|frame|This screenshot shows the installer's EULA agreement screen.]]

You'll be greeted with the end user license agreement. You're creating content for someone's software using this application; I highly recommend you actually read the license.

Accept the license agreement by selecting '''I accept the terms of the License Agreement''' and click '''Next'''.

 
==== Dragon Age Installation Directory Confirmation ====
[[File:Talonius_Toolkit_Install_Screen_003.png|left|middle|frame|This shows the screen confirming the location of Dragon Age on the PC the toolset is being installed on.]]

The third screen is asking you to confirm the installation directory of Dragon Age. The toolset requires Dragon Age to be installed; if the directory shown here isn't correct I would recommend reinstalling the game, then restarting the installation of the toolkit.

If the location is correct click '''Next''' to continue.

 
==== SQL Server 2005 Express Installation ====
[[File:Talonius_Toolkit_Install_Screen_004.png|left|middle|frame|This screen shows the configuration options for SQL Server 2005 Express.]]

SQL Server Express is a free version of SQL Server offered by Microsoft. It is a relational database that the toolset uses to store information about the currently installed modules and campaigns. Most of the problems around the installation of the toolkit revolve around the installation of SQL Server Express 2005.

If you have no idea what any of these things mean it is recommended that you leave the default settings as they are.

If you have an existing SQL Server 2005 installation you wish to use uncheck '''Install MS SQL Express 2005 SP3'''. You'll then need to check '''Custom settings:''' and enter in the information for the database you already have.

 
'''Examples:'''
* My SQL Server 2005 machine is named VORTEX, and it does not have any instances installed on it. The '''database server''' for it would simply be VORTEX. The '''database name''' would remain bw_dragonage_content unless you have a reason to change it.
* My workstation also has a copy of SQL Server 2008 on it with no instances. I could reference this installation one of two ways. The first would be as BRIAN-PC; the other would be by using the period by itself.
* It should be noted that the . in the database server refers to the local machine; this should be replaced by the name of the machine on which your installation of SQL Server resides. The \BWDATOOLSET refers to the database instance on that machine.

The installer will attempt to connect to the SQL Server you specify and it will run a series of scripts against the database you provided. You should ensure that SQL Server is running on the appropriate machine and that you have no data you wish to save in the database you selected to install to.

 
'''Problems?'''
* Visit the official forums and search there before posting; the most common issues have solutions already posted.
* Check the [[Installation troubleshooting]] page.
* A log file will be created in your Documents folder during the installation. This is good to have handy if you have issues during installation. The file in question is named "Install Dragon Age Toolset.txt".

Once the configuration is to your liking click '''Install''' to continue.

 

==== Toolkit Installation ====
[[File:Talonius_Toolkit_Install_Screen_005.png|left|middle|frame|This screenshot shows the installer as it progresses.]]

The installation will take some time. Grab a drink, use the restroom, put together a playlist for your listening pleasure.

 
==== Toolkit Installation Finished Verification ====
[[File:Talonius_Toolkit_Install_Screen_006.png|left|middle|frame|A screenshot of a successful installation.]]

The last item in the window above should be ''Completed''. If there's anything else scroll up in the window until you find the error and copy and paste that error somewhere for safe keeping. Seek help in the forums or on the Internet, and restart the installation process.

Click '''Next''' to continue.

 
==== Toolkit Installation Finished ====
[[File:Talonius_Toolkit_Install_Screen_007.png|left|middle|frame|The last screen of the toolkit installation.]]

You're done. Assuming no unexpected errors appeared during the installation process you should be ready to start editing.

Click '''Finish''' to complete the installation.

 
=== Starting the Toolkit ===
[[File:Talonius_Toolkit_Startup_Screen_001.png|left|middle|frame|The Windows 7 toolkit startup menu entry.]]

Find the Start Menu entry for the toolkit and click it. Give the toolkit some time to start up. As a benchmark, it takes approximately 12 seconds for the toolkit to start on my AMD Phenom 9850 with 4GB of RAM with a Windows Experience score 7.2.

 
=== Terminology ===
Learning something new is difficult. Concise terminology is required to give direction, but the terminology is usually somewhat recursive in definition. The following are some definitions that will help you navigate the remainder of this document.

; [[Module]]
: A module is the overarching container in which content is housed. It is the parent of all other content. The best comparison to the Dragon Age module are Dungeons and Dragons modules. Each module in D&D was a self contained adventure, complete with background, NPCs, maps, encounters, and any special rules which were to be in effect during the adventure.
; [[Area]]
: An area in a module is a self contained subset of the module, limited in size and/or scope. Areas are used to break the adventure into pieces, and are where the characters interact with the game. An area requires a level layout before it can be defined; see below. Items placed in an area are generally interactive, examinable, or dynamic in nature.
; [[Level]]
: A level defines the underlying static, immovable, non interactive portion of an area - structure and appearance. The level determines where PCs and NPCs can move (pathfinding) and lighting (ambient and otherwise). A level layout is required in order to define an area. A level can be created in one of two forms: terrain and room.
; [[Room Level]]
: TODO: Define
; [[Terrain Level]]
: TODO: Define

 
=== Modules ===
The toolset comes with two modules installed.

* The '''Single Player''' module is the campaign, and shouldn't be edited unless you want to modify the Dragon Age campaign itself. If you're creating an addin or mod for the official campaign, this is the module in which you'll want to work.
* The '''Demo''' module is installed for demonstration purposes by Bioware, and several other tutorials and forum posts refer to it.
 
[[File:Talonius_Toolkit_Module_Current_001.png|frame|left|The currently selected module is highlighted in the red box.]]

You can easily determine which module you're editing by looking at the title bar of the toolbox. In the image the currently edited module is highlighted by the red rectangle; the example has the '''Single Player''' module loaded.

Until you're comfortable with the toolkit it's best to work in a module separate from either of the above modules.

 
==== Create A Module ====
[[File:Talonius_Toolkit_Module_Create_001.png|left|middle|frame|The first step of creating a module.]]

To create a module click '''File''' then '''Manage Modules'''.

 
[[File:Talonius_Toolkit_Module_Create_002.png|left|middle|frame|The manage modules window.]]

The Manage Modules window will appear. Click the '''New''' button to create a module.

 
[[File:Talonius_Toolkit_Module_Create_003.png|left|middle|frame|The manage modules window.]]

The Object Inspector window appears. All of these properties can be changed at a later date; our primary concern are the '''Name''' and '''UID''' properties.

; Name
: The name of the module is displayed to the player and is used if a '''Description String ID''' has not been set.
; UID
: The UID is not intended to be a GUID. It is used in some configuration files and is the name of the directory to which the module is exported.

We will return to the Module's Object Properties later as there are several important settings here.

'''Notes:'''
* Modules cannot be deleted from the toolset once they're created.
* The only valid module type is currently Addin. A module created as an Addin will appear under '''Other Campaigns''' in Dragon Age.

 
[[File:Talonius_Toolkit_Module_Create_004.png|left|middle|frame|Sample module properties for the "Fall of Gargamel" module.]]

The image shows the module properties for the '''Fall of Gargamel''' module which we will be using for demonstration purposes.

Enter the values shown in the appropriate area, or create your own, and hit '''OK''' to continue with the module creation process.

 
[[File:Talonius_Toolkit_Module_Create_005.png|left|middle|frame|How our module appears in the Other Campaigns menu.]]

This image gives you an idea as to where the values we're entering are being used. The menu shown is the '''Other Campaigns''' menu off the Dragon Age main menu. (The module will not show up until we export at least a portion of it; this is handled later.)

As you can see the name of our addin matches the '''Name''' property we entered in the Object Inspector window.

 
[[File:Talonius_Toolkit_Module_Create_006.png|left|middle|frame|Shows where our files live when they are exported on Windows 7.]]

Here we can see that the directory in which our addin lives is named Gargamel, which corresponds to the '''UID''' value entered in the Object Inspector. We can also see the various DLC items that have been installed from the game.

'''Note:''' On a Windows XP computer you'll find this directory in your '''My Documents''' folder.

 
[[File:Talonius_Toolkit_Module_Create_007.png|left|middle|frame|This is the Manage Modules window immediately after the creation of your module.]]

Once the Object Inspector closes you'll be returned to the Manage Modules window. Ensure the '''Fall of Gargamel''' module is selected and hit '''Open'''.

 
[[File:Talonius_Toolkit_Module_Create_008.png|left|middle|frame|The toolset titlebar should now reflect Fall of Gargamel as the active module.]]

The toolset titlebar should now reflect the '''Fall of Gargamel''' as the active module. If you were to close and reopen the toolset it would default to last module you were working in.

 
==== Create A Room Level ====
As mentioned above a level is the underlying structure to an area. For our first level we're going to start with a room level.

 
[[File:Talonius_Toolkit_Level_Create_001.png|left|middle|frame|Creating a new level; click File, New, Level.]]

Click '''File''', then '''New''', then '''Level'''.

 
[[File:Talonius_Toolkit_Level_Create_002.png|left|middle|frame|The Level Creation Wizard.]]

You'll find yourself in the Level Creation Wizard. The first screen prompts you to create a terrain, or exterior level, or a room (interior) level. We're going to walk through the creation of a room level first, so select '''Room Level''' and click '''Next'''.

 
[[File:Talonius_Toolkit_Level_Create_003.png|left|middle|frame|The Level Creation Wizard.]]

If we were creating a terrain level there would be a number of options presented to us; the room level creation is much simpler.

Click '''Finish''' to create the room level.

 
==== A Tour of the Toolset Interface ====
[[File:Talonius_Toolkit_UI_Walkthrough_001.png|left|400px|frame|The UI of the toolset with highlighted areas which are defined.]]

The highlighted areas in the image represent the following:
# Area #1 in the upper left hand corner of the image represents the current name of the item being edited. We can see our level is currently named "Untitled.lvl"; we can also see at a glance that the ''dirty indicator'' is set for this file. The ''dirty indicator'' is the asterisk next to the name of the item.
# Area #2 in the middle of the image represents the ''viewport''. This is where we manipulate the object being defined. Currently there's a 2D graph being displayed. This graph is used to represent the X and Y coordinates of the viewport's object space. The graph is not a part of the object being edited. It is there only for clarity's sake and to aid in the positioning of objects.
# Area #3 is the ''Palette Window''. This will be a very heavily used and explained part of the toolset.
# Area #4 is the ''Object Inspector''. Again, this will be a very heavily used and explained part of the toolset.

File:Talonius Toolkit UI Walkthrough 001.png

2009-11-16T23:20:46Z

Talonius: A screen with areas of the UI highlighted; used to describe the purpose of the highlighted areas.

A screen with areas of the UI highlighted; used to describe the purpose of the highlighted areas.

File:Talonius Toolkit Level Create 003.png

2009-11-16T23:13:31Z

Talonius: Level Creation Wizard, Room Level.

Level Creation Wizard, Room Level.

File:Talonius Toolkit Level Create 002.png

2009-11-16T23:13:06Z

Talonius: Level Creation Wizard screenshot for room levels.

Level Creation Wizard screenshot for room levels.

User:Talonius/Sandbox

2009-11-16T21:31:42Z

Talonius:

== Creating a Small Adventure Step by Step ==
This page is intended to provide step by step instructions for each portion of the module creation process, including by linkage the various other pieces of the Wiki but allowing someone to follow it and understand how all the pieces go together.

=== Check Prerequisites ===
Do not attempt to install the toolkit without ensuring you have at least Windows XP with Service Pack 3, Windows Vista, or Windows 7. The SP3 requirement can be overlooked if you're technically savvy but for the smoothest experience I'd recommend installing the whole shebang.

Want to know why not? Check the [[#http://social.bioware.com/forum/1/topic/8/index/113400|Forums]].

=== Install Python 2.5 ===
Python 2.5 is required for the light mapping inside the toolkit to function, and it is preferred that it be installed first. ActiveState's ActivePython is the best choice, and is available for free. The latest version as of November 15, 2009 (2009/11/15) is 2.5.4.4 and it can be found [[#https://www.activestate.com/activepython/downloads/|here]].

Caveats:
* There are some who have had issues with the 64 bit version; I personally haven't. You may want to pick up the 32 bit version just in case.
* Install to the default directory to avoid any issues with the toolkit. C:\Python25 is the normal default.

=== Toolkit Installation ===
These instructions and screenshots are for v1.0.982.0 of the toolkit. They may or may not apply to later versions.

The toolkit is available from [[#http://social.bioware.com/toolset.php#downloads|Bioware's Community Site]]. It's 472Mb.

Double click the executable to install the toolkit. If you have an antivirus scanner installed on your computer don't be surprised if it doesn't pop up right away; the antivirus scanner has to process all 472MB of the executable before it will be allowed to run.

If you have Windows Vista or Windows 7 you'll be prompted by UAC to allow the installer to run. Choose yes if you obtained the toolset from the Bioware site.

==== Welcome Screen ====
[[Image:Talonius_Toolkit_Install_Screen_001.png|left|middle|frame|This is the installer's welcome screen.]] Click the '''Next''' button.

 
==== End User License Agreement ====
[[File:Talonius_Toolkit_Install_Screen_002.png|left|middle|frame|This screenshot shows the installer's EULA agreement screen.]]

You'll be greeted with the end user license agreement. You're creating content for someone's software using this application; I highly recommend you actually read the license.

Accept the license agreement by selecting '''I accept the terms of the License Agreement''' and click '''Next'''.

 
==== Dragon Age Installation Directory Confirmation ====
[[File:Talonius_Toolkit_Install_Screen_003.png|left|middle|frame|This shows the screen confirming the location of Dragon Age on the PC the toolset is being installed on.]]

The third screen is asking you to confirm the installation directory of Dragon Age. The toolset requires Dragon Age to be installed; if the directory shown here isn't correct I would recommend reinstalling the game, then restarting the installation of the toolkit.

If the location is correct click '''Next''' to continue.

 
==== SQL Server 2005 Express Installation ====
[[File:Talonius_Toolkit_Install_Screen_004.png|left|middle|frame|This screen shows the configuration options for SQL Server 2005 Express.]]

SQL Server Express is a free version of SQL Server offered by Microsoft. It is a relational database that the toolset uses to store information about the currently installed modules and campaigns. Most of the problems around the installation of the toolkit revolve around the installation of SQL Server Express 2005.

If you have no idea what any of these things mean it is recommended that you leave the default settings as they are.

If you have an existing SQL Server 2005 installation you wish to use uncheck '''Install MS SQL Express 2005 SP3'''. You'll then need to check '''Custom settings:''' and enter in the information for the database you already have.

 
'''Examples:'''
* My SQL Server 2005 machine is named VORTEX, and it does not have any instances installed on it. The '''database server''' for it would simply be VORTEX. The '''database name''' would remain bw_dragonage_content unless you have a reason to change it.
* My workstation also has a copy of SQL Server 2008 on it with no instances. I could reference this installation one of two ways. The first would be as BRIAN-PC; the other would be by using the period by itself.
* It should be noted that the . in the database server refers to the local machine; this should be replaced by the name of the machine on which your installation of SQL Server resides. The \BWDATOOLSET refers to the database instance on that machine.

The installer will attempt to connect to the SQL Server you specify and it will run a series of scripts against the database you provided. You should ensure that SQL Server is running on the appropriate machine and that you have no data you wish to save in the database you selected to install to.

 
'''Problems?'''
* Visit the official forums and search there before posting; the most common issues have solutions already posted.
* Check the [[Installation troubleshooting]] page.
* A log file will be created in your Documents folder during the installation. This is good to have handy if you have issues during installation. The file in question is named "Install Dragon Age Toolset.txt".

Once the configuration is to your liking click '''Install''' to continue.

 

==== Toolkit Installation ====
[[File:Talonius_Toolkit_Install_Screen_005.png|left|middle|frame|This screenshot shows the installer as it progresses.]]

The installation will take some time. Grab a drink, use the restroom, put together a playlist for your listening pleasure.

 
==== Toolkit Installation Finished Verification ====
[[File:Talonius_Toolkit_Install_Screen_006.png|left|middle|frame|A screenshot of a successful installation.]]

The last item in the window above should be ''Completed''. If there's anything else scroll up in the window until you find the error and copy and paste that error somewhere for safe keeping. Seek help in the forums or on the Internet, and restart the installation process.

Click '''Next''' to continue.

 
==== Toolkit Installation Finished ====
[[File:Talonius_Toolkit_Install_Screen_007.png|left|middle|frame|The last screen of the toolkit installation.]]

You're done. Assuming no unexpected errors appeared during the installation process you should be ready to start editing.

Click '''Finish''' to complete the installation.

 
=== Starting the Toolkit ===
[[File:Talonius_Toolkit_Startup_Screen_001.png|left|middle|frame|The Windows 7 toolkit startup menu entry.]]

Find the Start Menu entry for the toolkit and click it. Give the toolkit some time to start up. As a benchmark, it takes approximately 12 seconds for the toolkit to start on my AMD Phenom 9850 with 4GB of RAM with a Windows Experience score 7.2.

 
=== Terminology ===
Learning something new is difficult. Concise terminology is required to give direction, but the terminology is usually somewhat recursive in definition. The following are some definitions that will help you navigate the remainder of this document.

; [[Module]]
: A module is the overarching container in which content is housed. It is the parent of all other content. The best comparison to the Dragon Age module are Dungeons and Dragons modules. Each module in D&D was a self contained adventure, complete with background, NPCs, maps, encounters, and any special rules which were to be in effect during the adventure.
; [[Area]]
: An area in a module is a self contained subset of the module, limited in size and/or scope. Areas are used to break the adventure into pieces, and are where the characters interact with the game. An area requires a level layout before it can be defined; see below. Items placed in an area are generally interactive, examinable, or dynamic in nature.
; [[Level]]
: A level defines the underlying static, immovable, non interactive portion of an area - structure and appearance. The level determines where PCs and NPCs can move (pathfinding) and lighting (ambient and otherwise). A level layout is required in order to define an area. A level can be created in one of two forms: terrain and room.
; [[Room]]
: A room

 
=== Modules ===
The toolset comes with two modules installed.

* The '''Single Player''' module is the campaign, and shouldn't be edited unless you want to modify the Dragon Age campaign itself. If you're creating an addin or mod for the official campaign, this is the module in which you'll want to work.
* The '''Demo''' module is installed for demonstration purposes by Bioware, and several other tutorials and forum posts refer to it.
 
[[File:Talonius_Toolkit_Module_Current_001.png|frame|left|The currently selected module is highlighted in the red box.]]

You can easily determine which module you're editing by looking at the title bar of the toolbox. In the image the currently edited module is highlighted by the red rectangle; the example has the '''Single Player''' module loaded.

Until you're comfortable with the toolkit it's best to work in a module separate from either of the above modules.

 
==== Create A Module ====
[[File:Talonius_Toolkit_Module_Create_001.png|left|middle|frame|The first step of creating a module.]]

To create a module click '''File''' then '''Manage Modules'''.

 
[[File:Talonius_Toolkit_Module_Create_002.png|left|middle|frame|The manage modules window.]]

The Manage Modules window will appear. Click the '''New''' button to create a module.

 
[[File:Talonius_Toolkit_Module_Create_003.png|left|middle|frame|The manage modules window.]]

The Object Inspector window appears. All of these properties can be changed at a later date; our primary concern are the '''Name''' and '''UID''' properties.

; Name
: The name of the module is displayed to the player and is used if a '''Description String ID''' has not been set.
; UID
: The UID is not intended to be a GUID. It is used in some configuration files and is the name of the directory to which the module is exported.

We will return to the Module's Object Properties later as there are several important settings here.

'''Notes:'''
* Modules cannot be deleted from the toolset once they're created.
* The only valid module type is currently Addin. A module created as an Addin will appear under '''Other Campaigns''' in Dragon Age.

 
[[File:Talonius_Toolkit_Module_Create_004.png|left|middle|frame|Sample module properties for the "Fall of Gargamel" module.]]

The image shows the module properties for the '''Fall of Gargamel''' module which we will be using for demonstration purposes.

Enter the values shown in the appropriate area, or create your own, and hit '''OK''' to continue with the module creation process.

 
[[File:Talonius_Toolkit_Module_Create_005.png|left|middle|frame|How our module appears in the Other Campaigns menu.]]

This image gives you an idea as to where the values we're entering are being used. The menu shown is the '''Other Campaigns''' menu off the Dragon Age main menu. (The module will not show up until we export at least a portion of it; this is handled later.)

As you can see the name of our addin matches the '''Name''' property we entered in the Object Inspector window.

 
[[File:Talonius_Toolkit_Module_Create_006.png|left|middle|frame|Shows where our files live when they are exported on Windows 7.]]

Here we can see that the directory in which our addin lives is named Gargamel, which corresponds to the '''UID''' value entered in the Object Inspector. We can also see the various DLC items that have been installed from the game.

'''Note:''' On a Windows XP computer you'll find this directory in your '''My Documents''' folder.

 
[[File:Talonius_Toolkit_Module_Create_007.png|left|middle|frame|This is the Manage Modules window immediately after the creation of your module.]]

Once the Object Inspector closes you'll be returned to the Manage Modules window. Ensure the '''Fall of Gargamel''' module is selected and hit '''Open'''.

 
[[File:Talonius_Toolkit_Module_Create_008.png|left|middle|frame|The toolset titlebar should now reflect Fall of Gargamel as the active module.]]

The toolset titlebar should now reflect the '''Fall of Gargamel''' as the active module. If you were to close and reopen the toolset it would default to last module you were working in.

==== Create A Level ====
As mentioned above a level is the underlying structure to an area. For our first level we're going to start with a room level.

 
[[File:Talonius_Toolkit_Level_Create_001.png|left|middle|frame|Creating a new level; click File, New, Level.]]

Click '''File''', then '''New''', then '''Level'''.

File:Talonius Toolkit Level Create 001.png

2009-11-16T21:08:05Z

Talonius: Initial step for creating a new level.

Initial step for creating a new level.

File:Talonius Toolkit Module Create 008.png

2009-11-16T20:57:32Z

Talonius: New toolset title bar reflecting the newly created module.

New toolset title bar reflecting the newly created module.

File:Talonius Toolkit Module Create 007.png

2009-11-16T20:52:28Z

Talonius: Shows the Manage Modules window after the creation of a new module.

Shows the Manage Modules window after the creation of a new module.

User:Talonius/Sandbox

2009-11-16T20:48:20Z

Talonius:

== Creating a Small Adventure Step by Step ==
This page is intended to provide step by step instructions for each portion of the module creation process, including by linkage the various other pieces of the Wiki but allowing someone to follow it and understand how all the pieces go together.

=== Check Prerequisites ===
Do not attempt to install the toolkit without ensuring you have at least Windows XP with Service Pack 3, Windows Vista, or Windows 7. The SP3 requirement can be overlooked if you're technically savvy but for the smoothest experience I'd recommend installing the whole shebang.

Want to know why not? Check the [[#http://social.bioware.com/forum/1/topic/8/index/113400|Forums]].

=== Install Python 2.5 ===
Python 2.5 is required for the light mapping inside the toolkit to function, and it is preferred that it be installed first. ActiveState's ActivePython is the best choice, and is available for free. The latest version as of November 15, 2009 (2009/11/15) is 2.5.4.4 and it can be found [[#https://www.activestate.com/activepython/downloads/|here]].

Caveats:
* There are some who have had issues with the 64 bit version; I personally haven't. You may want to pick up the 32 bit version just in case.
* Install to the default directory to avoid any issues with the toolkit. C:\Python25 is the normal default.

=== Toolkit Installation ===
These instructions and screenshots are for v1.0.982.0 of the toolkit. They may or may not apply to later versions.

The toolkit is available from [[#http://social.bioware.com/toolset.php#downloads|Bioware's Community Site]]. It's 472Mb.

Double click the executable to install the toolkit. If you have an antivirus scanner installed on your computer don't be surprised if it doesn't pop up right away; the antivirus scanner has to process all 472MB of the executable before it will be allowed to run.

If you have Windows Vista or Windows 7 you'll be prompted by UAC to allow the installer to run. Choose yes if you obtained the toolset from the Bioware site.

==== Welcome Screen ====
[[Image:Talonius_Toolkit_Install_Screen_001.png|left|middle|frame|This is the installer's welcome screen.]] Click the '''Next''' button.

 
==== End User License Agreement ====
[[File:Talonius_Toolkit_Install_Screen_002.png|left|middle|frame|This screenshot shows the installer's EULA agreement screen.]]

You'll be greeted with the end user license agreement. You're creating content for someone's software using this application; I highly recommend you actually read the license.

Accept the license agreement by selecting '''I accept the terms of the License Agreement''' and click '''Next'''.

 
==== Dragon Age Installation Directory Confirmation ====
[[File:Talonius_Toolkit_Install_Screen_003.png|left|middle|frame|This shows the screen confirming the location of Dragon Age on the PC the toolset is being installed on.]]

The third screen is asking you to confirm the installation directory of Dragon Age. The toolset requires Dragon Age to be installed; if the directory shown here isn't correct I would recommend reinstalling the game, then restarting the installation of the toolkit.

If the location is correct click '''Next''' to continue.

 
==== SQL Server 2005 Express Installation ====
[[File:Talonius_Toolkit_Install_Screen_004.png|left|middle|frame|This screen shows the configuration options for SQL Server 2005 Express.]]

SQL Server Express is a free version of SQL Server offered by Microsoft. It is a relational database that the toolset uses to store information about the currently installed modules and campaigns. Most of the problems around the installation of the toolkit revolve around the installation of SQL Server Express 2005.

If you have no idea what any of these things mean it is recommended that you leave the default settings as they are.

If you have an existing SQL Server 2005 installation you wish to use uncheck '''Install MS SQL Express 2005 SP3'''. You'll then need to check '''Custom settings:''' and enter in the information for the database you already have.

 
'''Examples:'''
* My SQL Server 2005 machine is named VORTEX, and it does not have any instances installed on it. The '''database server''' for it would simply be VORTEX. The '''database name''' would remain bw_dragonage_content unless you have a reason to change it.
* My workstation also has a copy of SQL Server 2008 on it with no instances. I could reference this installation one of two ways. The first would be as BRIAN-PC; the other would be by using the period by itself.
* It should be noted that the . in the database server refers to the local machine; this should be replaced by the name of the machine on which your installation of SQL Server resides. The \BWDATOOLSET refers to the database instance on that machine.

The installer will attempt to connect to the SQL Server you specify and it will run a series of scripts against the database you provided. You should ensure that SQL Server is running on the appropriate machine and that you have no data you wish to save in the database you selected to install to.

 
'''Problems?'''
* Visit the official forums and search there before posting; the most common issues have solutions already posted.
* Check the [[Installation troubleshooting]] page.
* A log file will be created in your Documents folder during the installation. This is good to have handy if you have issues during installation. The file in question is named "Install Dragon Age Toolset.txt".

Once the configuration is to your liking click '''Install''' to continue.

 

==== Toolkit Installation ====
[[File:Talonius_Toolkit_Install_Screen_005.png|left|middle|frame|This screenshot shows the installer as it progresses.]]

The installation will take some time. Grab a drink, use the restroom, put together a playlist for your listening pleasure.

 
==== Toolkit Installation Finished Verification ====
[[File:Talonius_Toolkit_Install_Screen_006.png|left|middle|frame|A screenshot of a successful installation.]]

The last item in the window above should be ''Completed''. If there's anything else scroll up in the window until you find the error and copy and paste that error somewhere for safe keeping. Seek help in the forums or on the Internet, and restart the installation process.

Click '''Next''' to continue.

 
==== Toolkit Installation Finished ====
[[File:Talonius_Toolkit_Install_Screen_007.png|left|middle|frame|The last screen of the toolkit installation.]]

You're done. Assuming no unexpected errors appeared during the installation process you should be ready to start editing.

Click '''Finish''' to complete the installation.

 
=== Starting the Toolkit ===
[[File:Talonius_Toolkit_Startup_Screen_001.png|left|middle|frame|The Windows 7 toolkit startup menu entry.]]

Find the Start Menu entry for the toolkit and click it. Give the toolkit some time to start up. As a benchmark, it takes approximately 12 seconds for the toolkit to start on my AMD Phenom 9850 with 4GB of RAM with a Windows Experience score 7.2.

 
=== Terminology ===
Learning something new is difficult. Concise terminology is required to give direction, but the terminology is usually somewhat recursive in definition. The following are some definitions that will help you navigate the remainder of this document.

; [[Module]]
: A module is the overarching container in which content is housed. It is the parent of all other content. The best comparison to the Dragon Age module are Dungeons and Dragons modules. Each module in D&D was a self contained adventure, complete with background, NPCs, maps, encounters, and any special rules which were to be in effect during the adventure.
; [[Area]]
: An area in a module is a self contained subset of the module, limited in size and/or scope. Areas are used to break the adventure into pieces, and are where the characters interact with the game. An area requires a level layout before it can be defined; see below. Items placed in an area are generally interactive, examinable, or dynamic in nature.
; [[Level]]
: A level defines the underlying static, immovable, non interactive portion of an area - structure and appearance. The level determines where PCs and NPCs can move (pathfinding) and lighting (ambient and otherwise). A level layout is required in order to define an area. A level can be created in one of two forms: terrain and room.
; [[Room]]
: A room

 
=== Modules ===
The toolset comes with two modules installed.

* The '''Single Player''' module is the campaign, and shouldn't be edited unless you want to modify the Dragon Age campaign itself. If you're creating an addin or mod for the official campaign, this is the module in which you'll want to work.
* The '''Demo''' module is installed for demonstration purposes by Bioware, and several other tutorials and forum posts refer to it.
 
[[File:Talonius_Toolkit_Module_Current_001.png|frame|left|The currently selected module is highlighted in the red box.]]

You can easily determine which module you're editing by looking at the title bar of the toolbox. In the image the currently edited module is highlighted by the red rectangle; the example has the '''Single Player''' module loaded.

Until you're comfortable with the toolkit it's best to work in a module separate from either of the above modules.

 
==== Create A Module ====
[[File:Talonius_Toolkit_Module_Create_001.png|left|middle|frame|The first step of creating a module.]]

To create a module click '''File''' then '''Manage Modules'''.

 
[[File:Talonius_Toolkit_Module_Create_002.png|left|middle|frame|The manage modules window.]]

The Manage Modules window will appear. Click the '''New''' button to create a module.

 
[[File:Talonius_Toolkit_Module_Create_003.png|left|middle|frame|The manage modules window.]]

The Object Inspector window appears. All of these properties can be changed at a later date; our primary concern are the '''Name''' and '''UID''' properties.

; Name
: The name of the module is displayed to the player and is used if a '''Description String ID''' has not been set.
; UID
: The UID is not intended to be a GUID. It is used in some configuration files and is the name of the directory to which the module is exported.

We will return to the Module's Object Properties later as there are several important settings here.

'''Notes:'''
* Modules cannot be deleted from the toolset once they're created.
* The only valid module type is currently Addin. A module created as an Addin will appear under '''Other Campaigns''' in Dragon Age.

 
[[File:Talonius_Toolkit_Module_Create_004.png|left|middle|frame|Sample module properties for the "Fall of Gargamel" module.]]

The image shows the module properties for the '''Fall of Gargamel''' module which we will be using for demonstration purposes.

Enter the values shown in the appropriate area, or create your own, and hit '''OK''' to continue with the module creation process.

 
[[File:Talonius_Toolkit_Module_Create_005.png|left|middle|frame|How our module appears in the Other Campaigns menu.]]

This image gives you an idea as to where the values we're entering are being used. The menu shown is the '''Other Campaigns''' menu off the Dragon Age main menu. (The module will not show up until we export at least a portion of it; this is handled later.)

As you can see the name of our addin matches the '''Name''' property we entered in the Object Inspector window.

 
[[File:Talonius_Toolkit_Module_Create_006.png|left|middle|frame|Shows where our files live when they are exported on Windows 7.]]

Here we can see that the directory in which our addin lives is named Gargamel, which corresponds to the '''UID''' value entered in the Object Inspector. We can also see the various DLC items that have been installed from the game.

'''Note:''' On a Windows XP computer you'll find this directory in your '''My Documents''' folder.

Tutorials

2009-11-16T20:18:30Z

Talonius: Added video tutorial notation to last two tutorials. (Thanks for fixed links, Bryan. :))

In the course of these tutorials we'll go through all the steps needed to create a basic adventure.

{{sidebox|
*Boxes like this contain a checklist of important steps.
*They're intended as a reminder and as a navigational aid.
}}

*[[Introductory tutorial]] - An overview of the toolset as a whole
*[[Module tutorial]] - how to create a module to work in.

This set of tutorials forms a series, each building on or filling in omissions by the last:
*[[Level Editor Tutorial]]
*[[Placeable tutorial]]
*[[Area tutorial]]
*[[Item tutorial]]
*[[Creature tutorial]]
*[[Conversation tutorial]]
*[[Scripting tutorial]]

Once you've become familiar with the basics introduced on those tutorials you might have a better grounding for:
*[[Cutscene tutorial]]
*[[Map tutorial]] (which also introduces you to [[2DA]] editing)

== Demo module ==

The toolset currently ships with a simple demo module pre-loaded into its database.

*[[Demo module]] - how to export and run the demo module.

== External Tutorials ==

*[http://www.youtube.com/watch?v=TwQNRBFLhrE Playable Area and Conversation] video tutorial by [http://social.bioware.com/64020/ st4rdog].
*[http://www.youtube.com/watch?v=CaHldJcUTz8 Simple Converstaion Cameras] video tutorial by [http://social.bioware.com/64020/ st4rdog].
*[http://www.youtube.com/watch?v=QOQJ2heQto4 Cutscene and Trigger] video tutorial by [http://social.bioware.com/64020/ st4rdog].
*[http://www.youtube.com/watch?v=szWKgj2ZuXo Custom Level and Room Building] video tutorial by [http://social.bioware.com/64020/ st4rdog].
*[http://www.youtube.com/watch?v=DKJ7F14n8o8 Downloading and Installing the Toolset] video tutorial by [http://social.bioware.com/74287/ DragonAge22].
*[http://www.youtube.com/watch?v=iMPBsulv9xI Creating a Room] video tutorial by [http://social.bioware.com/74287/ DragonAge22].
*[http://www.youtube.com/watch?v=g3kx2CaarHo How to Make an Interior Level with Lighting] video tutorial by [http://social.bioware.com/group/60/ Darkworld Development Team].
*[http://www.youtube.com/watch?v=O6TeZeE1Lc8 Making a Room] video tutorial by BigDrip681.

[[Category:Tutorials| ]]

User:Talonius/Sandbox

2009-11-16T20:08:52Z

Talonius:

== Creating a Small Adventure Step by Step ==
This page is intended to provide step by step instructions for each portion of the module creation process, including by linkage the various other pieces of the Wiki but allowing someone to follow it and understand how all the pieces go together.

=== Check Prerequisites ===
Do not attempt to install the toolkit without ensuring you have at least Windows XP with Service Pack 3, Windows Vista, or Windows 7. The SP3 requirement can be overlooked if you're technically savvy but for the smoothest experience I'd recommend installing the whole shebang.

Want to know why not? Check the [[#http://social.bioware.com/forum/1/topic/8/index/113400|Forums]].

=== Install Python 2.5 ===
Python 2.5 is required for the light mapping inside the toolkit to function, and it is preferred that it be installed first. ActiveState's ActivePython is the best choice, and is available for free. The latest version as of November 15, 2009 (2009/11/15) is 2.5.4.4 and it can be found [[#https://www.activestate.com/activepython/downloads/|here]].

Caveats:
* There are some who have had issues with the 64 bit version; I personally haven't. You may want to pick up the 32 bit version just in case.
* Install to the default directory to avoid any issues with the toolkit. C:\Python25 is the normal default.

=== Toolkit Installation ===
These instructions and screenshots are for v1.0.982.0 of the toolkit. They may or may not apply to later versions.

The toolkit is available from [[#http://social.bioware.com/toolset.php#downloads|Bioware's Community Site]]. It's 472Mb.

Double click the executable to install the toolkit. If you have an antivirus scanner installed on your computer don't be surprised if it doesn't pop up right away; the antivirus scanner has to process all 472MB of the executable before it will be allowed to run.

If you have Windows Vista or Windows 7 you'll be prompted by UAC to allow the installer to run. Choose yes if you obtained the toolset from the Bioware site.

==== Welcome Screen ====
[[Image:Talonius_Toolkit_Install_Screen_001.png|left|middle|frame|This is the installer's welcome screen.]] Click the '''Next''' button.

 
==== End User License Agreement ====
[[File:Talonius_Toolkit_Install_Screen_002.png|left|middle|frame|This screenshot shows the installer's EULA agreement screen.]]

You'll be greeted with the end user license agreement. You're creating content for someone's software using this application; I highly recommend you actually read the license.

Accept the license agreement by selecting '''I accept the terms of the License Agreement''' and click '''Next'''.

 
==== Dragon Age Installation Directory Confirmation ====
[[File:Talonius_Toolkit_Install_Screen_003.png|left|middle|frame|This shows the screen confirming the location of Dragon Age on the PC the toolset is being installed on.]]

The third screen is asking you to confirm the installation directory of Dragon Age. The toolset requires Dragon Age to be installed; if the directory shown here isn't correct I would recommend reinstalling the game, then restarting the installation of the toolkit.

If the location is correct click '''Next''' to continue.

 
==== SQL Server 2005 Express Installation ====
[[File:Talonius_Toolkit_Install_Screen_004.png|left|middle|frame|This screen shows the configuration options for SQL Server 2005 Express.]]

SQL Server Express is a free version of SQL Server offered by Microsoft. It is a relational database that the toolset uses to store information about the currently installed modules and campaigns. Most of the problems around the installation of the toolkit revolve around the installation of SQL Server Express 2005.

If you have no idea what any of these things mean it is recommended that you leave the default settings as they are.

If you have an existing SQL Server 2005 installation you wish to use uncheck '''Install MS SQL Express 2005 SP3'''. You'll then need to check '''Custom settings:''' and enter in the information for the database you already have.

 
'''Examples:'''
* My SQL Server 2005 machine is named VORTEX, and it does not have any instances installed on it. The '''database server''' for it would simply be VORTEX. The '''database name''' would remain bw_dragonage_content unless you have a reason to change it.
* My workstation also has a copy of SQL Server 2008 on it with no instances. I could reference this installation one of two ways. The first would be as BRIAN-PC; the other would be by using the period by itself.
* It should be noted that the . in the database server refers to the local machine; this should be replaced by the name of the machine on which your installation of SQL Server resides. The \BWDATOOLSET refers to the database instance on that machine.

The installer will attempt to connect to the SQL Server you specify and it will run a series of scripts against the database you provided. You should ensure that SQL Server is running on the appropriate machine and that you have no data you wish to save in the database you selected to install to.

 
'''Problems?'''
* Visit the official forums and search there before posting; the most common issues have solutions already posted.
* Check the [[Installation troubleshooting]] page.
* A log file will be created in your Documents folder during the installation. This is good to have handy if you have issues during installation. The file in question is named "Install Dragon Age Toolset.txt".

Once the configuration is to your liking click '''Install''' to continue.

 

==== Toolkit Installation ====
[[File:Talonius_Toolkit_Install_Screen_005.png|left|middle|frame|This screenshot shows the installer as it progresses.]]

The installation will take some time. Grab a drink, use the restroom, put together a playlist for your listening pleasure.

 
==== Toolkit Installation Finished Verification ====
[[File:Talonius_Toolkit_Install_Screen_006.png|left|middle|frame|A screenshot of a successful installation.]]

The last item in the window above should be ''Completed''. If there's anything else scroll up in the window until you find the error and copy and paste that error somewhere for safe keeping. Seek help in the forums or on the Internet, and restart the installation process.

Click '''Next''' to continue.

 
==== Toolkit Installation Finished ====
[[File:Talonius_Toolkit_Install_Screen_007.png|left|middle|frame|The last screen of the toolkit installation.]]

You're done. Assuming no unexpected errors appeared during the installation process you should be ready to start editing.

Click '''Finish''' to complete the installation.

 
=== Starting the Toolkit ===
[[File:Talonius_Toolkit_Startup_Screen_001.png|left|middle|frame|The Windows 7 toolkit startup menu entry.]]

Find the Start Menu entry for the toolkit and click it. Give the toolkit some time to start up. As a benchmark, it takes approximately 12 seconds for the toolkit to start on my AMD Phenom 9850 with 4GB of RAM with a Windows Experience score 7.2.

 
=== Terminology ===
Learning something new is difficult. Concise terminology is required to give direction, but the terminology is usually somewhat recursive in definition. The following are some definitions that will help you navigate the remainder of this document.

; [[Module]]
: A module is the overarching container in which content is housed. It is the parent of all other content. The best comparison to the Dragon Age module are Dungeons and Dragons modules. Each module in D&D was a self contained adventure, complete with background, NPCs, maps, encounters, and any special rules which were to be in effect during the adventure.
; [[Area]]
: An area in a module is a self contained subset of the module, limited in size and/or scope. Areas are used to break the adventure into pieces, and are where the characters interact with the game. An area requires a level layout before it can be defined; see below. Items placed in an area are generally interactive, examinable, or dynamic in nature.
; [[Level]]
: A level defines the underlying static, immovable, non interactive portion of an area - structure and appearance. The level determines where PCs and NPCs can move (pathfinding) and lighting (ambient and otherwise). A level layout is required in order to define an area. A level can be created in one of two forms: terrain and room.
; [[Room]]
: A room

 
=== Modules ===
The toolset comes with two modules installed.

* The '''Single Player''' module is the campaign, and shouldn't be edited unless you want to modify the Dragon Age campaign itself. If you're creating an addin or mod for the official campaign, this is the module in which you'll want to work.
* The '''Demo''' module is installed for demonstration purposes by Bioware, and several other tutorials and forum posts refer to it.
 
[[File:Talonius_Toolkit_Module_Current_001.png|frame|left|The currently selected module is highlighted in the red box.]]

You can easily determine which module you're editing by looking at the title bar of the toolbox. In the image the currently edited module is highlighted by the red rectangle; the example has the '''Single Player''' module loaded.

Until you're comfortable with the toolkit it's best to work in a module separate from either of the above modules.

 
==== Create A Module ====
[[File:Talonius_Toolkit_Module_Create_001.png|left|middle|frame|The first step of creating a module.]]

To create a module click '''File''' then '''Manage Modules'''.

 
[[File:Talonius_Toolkit_Module_Create_002.png|left|middle|frame|The manage modules window.]]

The Manage Modules window will appear. Click the '''New''' button to create a module.

 
[[File:Talonius_Toolkit_Module_Create_003.png|left|middle|frame|The manage modules window.]]

The Object Inspector window appears. All of these properties can be changed at a later date; our primary concern are the '''Name''' and '''UID''' properties.

; Name
: The name of the module is displayed to the player and is used if a '''Description String ID''' has not been set.
; UID
: The UID is not intended to be a GUID. It is used in some configuration files and is the name of the directory to which the module is exported.

We will return to the Module's Object Properties later as there are several important settings here.

'''Notes:'''
* Modules cannot be deleted from the toolset once they're created.
* The only valid module type is currently Addin. A module created as an Addin will appear under '''Other Campaigns''' in Dragon Age.

 
[[File:Talonius_Toolkit_Module_Create_004.png|left|middle|frame|Sample module properties for the "Fall of Gargamel" module.]]

The image shows the module properties for the '''Fall of Gargamel''' module which we will be using for demonstration purposes.

 
[[File:Talonius_Toolkit_Module_Create_005.png|left|middle|frame|How our module appears in the Other Campaigns menu.]]

This image gives you an idea as to where the values we're entering are being used. The menu shown is the '''Other Campaigns''' menu off the Dragon Age main menu. (The module will not show up until we export at least a portion of it; this is handled later.)

 
[[File:Talonius_Toolkit_Module_Create_006.png|left|middle|frame|Shows where our files live when they exported on Windows 7.]]

Here we can see that the directory in which our addin lives is named Gargamel, which corresponds to the '''UID''' value entered in the module properties. We can also see the various DLC items that have been installed from the game.

'''Note:''' On a Windows XP computer you'll find this directory in your '''My Documents''' folder.

User:Talonius/Sandbox

2009-11-16T20:07:51Z

Talonius: Minor corrections.

== Creating a Small Adventure Step by Step ==
This page is intended to provide step by step instructions for each portion of the module creation process, including by linkage the various other pieces of the Wiki but allowing someone to follow it and understand how all the pieces go together.

=== Check Prerequisites ===
Do not attempt to install the toolkit without ensuring you have at least Windows XP with Service Pack 3, Windows Vista, or Windows 7. The SP3 requirement can be overlooked if you're technically savvy but for the smoothest experience I'd recommend installing the whole shebang.

Want to know why not? Check the [[#http://social.bioware.com/forum/1/topic/8/index/113400|Forums]].

=== Install Python 2.5 ===
Python 2.5 is required for the light mapping inside the toolkit to function, and it is preferred that it be installed first. ActiveState's ActivePython is the best choice, and is available for free. The latest version as of November 15, 2009 (2009/11/15) is 2.5.4.4 and it can be found [[#https://www.activestate.com/activepython/downloads/|here]].

Caveats:
* There are some who have had issues with the 64 bit version; I personally haven't. You may want to pick up the 32 bit version just in case.
* Install to the default directory to avoid any issues with the toolkit. C:\Python25 is the normal default.

=== Toolkit Installation ===
These instructions and screenshots are for v1.0.982.0 of the toolkit. They may or may not apply to later versions.

The toolkit is available from [[#http://social.bioware.com/toolset.php#downloads|Bioware's Community Site]]. It's 472Mb.

Double click the executable to install the toolkit. If you have an antivirus scanner installed on your computer don't be surprised if it doesn't pop up right away; the antivirus scanner has to process all 472MB of the executable before it will be allowed to run.

If you have Windows Vista or Windows 7 you'll be prompted by UAC to allow the installer to run. Choose yes if you obtained the toolset from the Bioware site.

==== Welcome Screen ====
[[Image:Talonius_Toolkit_Install_Screen_001.png|left|middle|frame|This is the installer's welcome screen.]] Click the '''Next''' button.

 
==== End User License Agreement ====
[[File:Talonius_Toolkit_Install_Screen_002.png|left|middle|frame|This screenshot shows the installer's EULA agreement screen.]]

You'll be greeted with the end user license agreement. You're creating content for someone's software using this application; I highly recommend you actually read the license.

Accept the license agreement by selecting '''I accept the terms of the License Agreement''' and click '''Next'''.

 
==== Dragon Age Installation Directory Confirmation ====
[[File:Talonius_Toolkit_Install_Screen_003.png|left|middle|frame|This shows the screen confirming the location of Dragon Age on the PC the toolset is being installed on.]]

The third screen is asking you to confirm the installation directory of Dragon Age. The toolset requires Dragon Age to be installed; if the directory shown here isn't correct I would recommend reinstalling the game, then restarting the installation of the toolkit.

If the location is correct click '''Next''' to continue.

 
==== SQL Server 2005 Express Installation ====
[[File:Talonius_Toolkit_Install_Screen_004.png|left|middle|frame|This screen shows the configuration options for SQL Server 2005 Express.]]

SQL Server Express is a free version of SQL Server offered by Microsoft. It is a relational database that the toolset uses to store information about the currently installed modules and campaigns. Most of the problems around the installation of the toolkit revolve around the installation of SQL Server Express 2005.

If you have no idea what any of these things mean it is recommended that you leave the default settings as they are.

If you have an existing SQL Server 2005 installation you wish to use uncheck '''Install MS SQL Express 2005 SP3'''. You'll then need to check '''Custom settings:''' and enter in the information for the database you already have.

 
'''Examples:'''
* My SQL Server 2005 machine is named VORTEX, and it does not have any instances installed on it. The '''database server''' for it would simply be VORTEX. The '''database name''' would remain bw_dragonage_content unless you have a reason to change it.
* My workstation also has a copy of SQL Server 2008 on it with no instances. I could reference this installation one of two ways. The first would be as BRIAN-PC; the other would be by using the period by itself.
* It should be noted that the . in the database server refers to the local machine; this should be replaced by the name of the machine on which your installation of SQL Server resides. The \BWDATOOLSET refers to the database instance on that machine.

The installer will attempt to connect to the SQL Server you specify and it will run a series of scripts against the database you provided. You should ensure that SQL Server is running on the appropriate machine and that you have no data you wish to save in the database you selected to install to.

 
'''Problems?'''
* Visit the official forums and search there before posting; the most common issues have solutions already posted.
* Check the [[Installation troubleshooting]] page.
* A log file will be created in your Documents folder during the installation. This is good to have handy if you have issues during installation. The file in question is named "Install Dragon Age Toolset.txt".

Once the configuration is to your liking click '''Install''' to continue.

 

==== Toolkit Installation ====
[[File:Talonius_Toolkit_Install_Screen_005.png|left|middle|frame|This screenshot shows the installer as it progresses.]]

The installation will take some time. Grab a drink, use the restroom, put together a playlist for your listening pleasure.

 
==== Toolkit Installation Finished Verification ====
[[File:Talonius_Toolkit_Install_Screen_006.png|left|middle|frame|A screenshot of a successful installation.]]

The last item in the window above should be ''Completed''. If there's anything else scroll up in the window until you find the error and copy and paste that error somewhere for safe keeping. Seek help in the forums or on the Internet, and restart the installation process.

Click '''Next''' to continue.

 
==== Toolkit Installation Finished ====
[[File:Talonius_Toolkit_Install_Screen_007.png|left|middle|frame|The last screen of the toolkit installation.]]

You're done. Assuming no unexpected errors appeared during the installation process you should be ready to start editing.

Click '''Finish''' to complete the installation.

 
=== Starting the Toolkit ===
[[File:Talonius_Toolkit_Startup_Screen_001.png|left|middle|frame|The Windows 7 toolkit startup menu entry.]]

Find the Start Menu entry for the toolkit and click it. Give the toolkit some time to start up. As a benchmark, it takes approximately 12 seconds for the toolkit to start on my AMD Phenom 9850 with 4GB of RAM with a Windows Experience score 7.2.

 
=== Terminology ===
Learning something new is difficult. Concise terminology is required to give direction, but the terminology is usually somewhat recursive in definition. The following are some definitions that will help you navigate the remainder of this document.

; [[Module]]
: A module is the overarching container in which content is housed. It is the parent of all other content. The best comparison to the Dragon Age module are Dungeons and Dragons modules. Each module in D&D was a self contained adventure, complete with background, NPCs, maps, encounters, and any special rules which were to be in effect during the adventure.
; [[Area]]
: An area in a module is a self contained subset of the module, limited in size and/or scope. Areas are used to break the adventure into pieces, and are where the characters interact with the game. An area requires a level layout before it can be defined; see below. Items placed in an area are generally interactive, examinable, or dynamic in nature.
; [[Level]]
: A level defines the underlying static, immovable, non interactive portion of an area - structure and appearance. The level determines where PCs and NPCs can move (pathfinding) and lighting (ambient and otherwise). A level layout is required in order to define an area. A level can be created in one of two forms: terrain and room.
; [[Room]]
: A room

 
=== Modules ===
The toolset comes with two modules installed.

* The '''Single Player''' module is the campaign, and shouldn't be edited unless you want to modify the Dragon Age campaign itself. If you're creating an addin or mod for the official campaign, this is the module in which you'll want to work.
* The '''Demo''' module is installed for demonstration purposes by Bioware, and several other tutorials and forum posts refer to it.
 
[[File:Talonius_Toolkit_Module_Current_001.png|frame|left|The currently selected module is highlighted in the red box.]]

You can easily determine which module you're editing by looking at the title bar of the toolbox. In the image the currently edited module is highlighted by the red rectangle; the example has the '''Single Player''' module loaded.

Until you're comfortable with the toolkit it's best to work in a module separate from either of the above modules.

 
==== Create A Module ====
[[File:Talonius_Toolkit_Module_Create_001.png|left|middle|frame|The first step of creating a module.]]

To create a module click '''File''' then '''Manage Modules'''.

 
[[File:Talonius_Toolkit_Module_Create_002.png|left|middle|frame|The manage modules window.]]

The Manage Modules window will appear. Click the '''New''' button to create a module.

 
[[File:Talonius_Toolkit_Module_Create_003.png|left|middle|frame|The manage modules window.]]

The Object Inspector window appears. All of these properties can be changed at a later date; our primary concern are the '''Name''' and '''UID''' properties.

; Name
: The name of the module is displayed to the player and is used if a '''Description String ID''' has not been set.
; UID
: The UID is not intended to be a GUID. It is used in some configuration files and is the name of the directory to which the module is exported.

We will return to the Module's Object Properties later as there are several important settings here.

'''Notes:'''
* Modules cannot be deleted from the toolset once they're created.
* The only valid module type is currently Addin. A module created as an Addin will appear under '''Other Campaigns''' in Dragon Age.

 
[[File:Talonius_Toolkit_Module_Create_004.png|left|middle|frame|Sample module properties for the "Fall of Gargamel" module.]]

The image shows the module properties for the '''Fall of Gargamel''' module which we will be using for demonstration purposes.

 
[[File:Talonius_Toolkit_Module_Create_005.png|left|middle|frame|How our module appears in the Other Campaigns menu.]]

This image gives you an idea as to where the values we're entering are being used. The menu shown is the '''Other Campaigns''' menu off the Dragon Age main menu. (The module will not show up until we export at least a portion of it; this is handled later.)

 
[[File:Talonius_Toolkit_Module_Create_006.png|left|middle|frame|Shows where are files live when they exported on Windows 7.]]

Here we can see that the directory in which our addin lives is named Gargamel, which corresponds to the '''UID''' value entered in the module properties. We can also see the various DLC items that have been installed from the game.

'''Note:''' On a Windows XP computer you'll find this directory in your '''My Documents''' folder.

User:Talonius/Sandbox

2009-11-16T20:06:29Z

Talonius: Further additions; WIP.

== Creating a Small Adventure Step by Step ==
This page is intended to provide step by step instructions for each portion of the module creation process, including by linkage the various other pieces of the Wiki but allowing someone to follow it and understand how all the pieces go together.

=== Check Prerequisites ===
Do not attempt to install the toolkit without ensuring you have at least Windows XP with Service Pack 3, Windows Vista, or Windows 7. The SP3 requirement can be overlooked if you're technically savvy but for the smoothest experience I'd recommend installing the whole shebang.

Want to know why not? Check the [[#http://social.bioware.com/forum/1/topic/8/index/113400|Forums]].

=== Install Python 2.5 ===
Python 2.5 is required for the light mapping inside the toolkit to function, and it is preferred that it be installed first. ActiveState's ActivePython is the best choice, and is available for free. The latest version as of November 15, 2009 (2009/11/15) is 2.5.4.4 and it can be found [[#https://www.activestate.com/activepython/downloads/|here]].

Caveats:
* There are some who have had issues with the 64 bit version; I personally haven't. You may want to pick up the 32 bit version just in case.
* Install to the default directory to avoid any issues with the toolkit. C:\Python25 is the normal default.

=== Toolkit Installation ===
These instructions and screenshots are for v1.0.982.0 of the toolkit. They may or may not apply to later versions.

The toolkit is available from [[#http://social.bioware.com/toolset.php#downloads|Bioware's Community Site]]. It's 472Mb.

Double click the executable to install the toolkit. If you have an antivirus scanner installed on your computer don't be surprised if it doesn't pop up right away; the antivirus scanner has to process all 472MB of the executable before it will be allowed to run.

If you have Windows Vista or Windows 7 you'll be prompted by UAC to allow the installer to run. Choose yes if you obtained the toolset from the Bioware site.

==== Welcome Screen ====
[[Image:Talonius_Toolkit_Install_Screen_001.png|left|middle|frame|This is the installer's welcome screen.]] Click the '''Next''' button.

 
==== End User License Agreement ====
[[File:Talonius_Toolkit_Install_Screen_002.png|left|middle|frame|This screenshot shows the installer's EULA agreement screen.]]

You'll be greeted with the end user license agreement. You're creating content for someone's software using this application; I highly recommend you actually read the license.

Accept the license agreement by selecting '''I accept the terms of the License Agreement''' and click '''Next'''.

 
==== Dragon Age Installation Directory Confirmation ====
[[File:Talonius_Toolkit_Install_Screen_003.png|left|middle|frame|This shows the screen confirming the location of Dragon Age on the PC the toolset is being installed on.]]

The third screen is asking you to confirm the installation directory of Dragon Age. The toolset requires Dragon Age to be installed; if the directory shown here isn't correct I would recommend reinstalling the game, then restarting the installation of the toolkit.

If the location is correct click '''Next''' to continue.

 
==== SQL Server 2005 Express Installation ====
[[File:Talonius_Toolkit_Install_Screen_004.png|left|middle|frame|This screen shows the configuration options for SQL Server 2005 Express.]]

SQL Server Express is a free version of SQL Server offered by Microsoft. It is a relational database that the toolset uses to store information about the currently installed modules and campaigns. Most of the problems around the installation of the toolkit revolve around the installation of SQL Server Express 2005.

If you have no idea what any of these things mean it is recommended that you leave the default settings as they are.

If you have an existing SQL Server 2005 installation you wish to use uncheck '''Install MS SQL Express 2005 SP3'''. You'll then need to check '''Custom settings:''' and enter in the information for the database you already have.

 
'''Examples:'''
* My SQL Server 2005 machine is named VORTEX, and it does not have any instances installed on it. The '''database server''' for it would simply be VORTEX. The '''database name''' would remain bw_dragonage_content unless you have a reason to change it.
* My workstation also has a copy of SQL Server 2008 on it with no instances. I could reference this installation one of two ways. The first would be as BRIAN-PC; the other would be by using the period by itself.
* It should be noted that the . in the database server refers to the local machine; this should be replaced by the name of the machine on which your installation of SQL Server resides. The \BWDATOOLSET refers to the database instance on that machine.

The installer will attempt to connect to the SQL Server you specify and it will run a series of scripts against the database you provided. You should ensure that SQL Server is running on the appropriate machine and that you have no data you wish to save in the database you selected to install to.

 
'''Problems?'''
* Visit the official forums and search there before posting; the most common issues have solutions already posted.
* Check the [[Installation troubleshooting]] page.
* A log file will be created in your Documents folder during the installation. This is good to have handy if you have issues during installation. The file in question is named "Install Dragon Age Toolset.txt".

Once the configuration is to your liking click '''Install''' to continue.

 

==== Toolkit Installation ====
[[File:Talonius_Toolkit_Install_Screen_005.png|left|middle|frame|This screenshot shows the installer as it progresses.]]

The installation will take some time. Grab a drink, use the restroom, put together a playlist for your listening pleasure.

 
==== Toolkit Installation Finished Verification ====
[[File:Talonius_Toolkit_Install_Screen_006.png|left|middle|frame|A screenshot of a successful installation.]]

The last item in the window above should be ''Completed''. If there's anything else scroll up in the window until you find the error and copy and paste that error somewhere for safe keeping. Seek help in the forums or on the Internet, and restart the installation process.

Click '''Next''' to continue.

 
==== Toolkit Installation Finished ====
[[File:Talonius_Toolkit_Install_Screen_007.png|left|middle|frame|The last screen of the toolkit installation.]]

You're done. Assuming no unexpected errors appeared during the installation process you should be ready to start editing.

Click '''Finish''' to complete the installation.

 
=== Starting the Toolkit ===
[[File:Talonius_Toolkit_Startup_Screen_001.png|left|middle|frame|The Windows 7 toolkit startup menu entry.]]

Find the Start Menu entry for the toolkit and click it. Give the toolkit some time to start up. As a benchmark, it takes approximately 12 seconds for the toolkit to start on my AMD Phenom 9850 with 4GB of RAM with a Windows Experience score 7.2.

 
=== Terminology ===
Learning something new is difficult. Concise terminology is required to give direction, but the terminology is usually somewhat recursive in definition. The following are some definitions that will help you navigate the remainder of this document.

; [[Module]]
: A module is the overarching container in which content is housed. It is the parent of all other content. The best comparison to the Dragon Age module are Dungeons and Dragons modules. Each module in D&D was a self contained adventure, complete with background, NPCs, maps, encounters, and any special rules which were to be in effect during the adventure.
; [[Area]]
: An area in a module is a self contained subset of the module, limited in size and/or scope. Areas are used to break the adventure into pieces, and are where the characters interact with the game. An area requires a level layout before it can be defined; see below. Items placed in an area are generally interactive, examinable, or dynamic in nature.
; [[Level]]
: A level defines the underlying static, immovable, non interactive portion of an area - structure and appearance. The level determines where PCs and NPCs can move (pathfinding) and lighting (ambient and otherwise). A level layout is required in order to define an area. A level can be created in one of two forms: terrain and room.
; [[Room]]
: A room

 
=== Modules ===
The toolset comes with two modules installed.

* The '''Single Player''' module is the campaign, and shouldn't be edited unless you want to modify the Dragon Age campaign itself. If you're creating an addin or mod for the official campaign, this is the module in which you'll want to work.
* The '''Demo''' module is installed for demonstration purposes by Bioware, and several other tutorials and forum posts refer to it.
 
[[File:Talonius_Toolkit_Module_Current_001.png|frame|left|The currently selected module is highlighted in the red box.]]

You can easily determine which module you're editing by looking at the title bar of the toolbox. In the image the currently edited module is highlighted by the red rectangle; the example has the '''Single Player''' module loaded.

Until you're comfortable with the toolkit it's best to work in a module separate from either of the above modules.

 
==== Create A Module ====
[[File:Talonius_Toolkit_Module_Create_001.png|left|middle|frame|The first step of creating a module.]]

To create a module click '''File''' then '''Manage Modules'''.

 
[[File:Talonius_Toolkit_Module_Create_002.png|left|middle|frame|The manage modules window.]]

The Manage Modules window will appear. Click the '''New''' button to create a module.

 
[[File:Talonius_Toolkit_Module_Create_003.png|left|middle|frame|The manage modules window.]]

The Object Properties window appears. All of these properties can be changed at a later date; our primary concern are the '''Name''' and '''UID''' properties.

; Name
: The name of the module is displayed to the player and is used if a '''Description String ID''' has not been set.
; UID
: The UID is not intended to be a GUID. It is used in some configuration files and is the name of the directory to which the module is exported.

We will return to the Module's Object Properties later as there are several important settings here.

'''Notes:'''
* Modules cannot be deleted from the toolset once they're created.
* The only valid module type is currently Addin. A module created as an Addin will appear under '''Other Campaigns''' in Dragon Age.

 
[[File:Talonius_Toolkit_Module_Create_004.png|left|middle|frame|Sample module properties for the "Fall of Gargamel" module.]]

The image shows the module properties for the '''Fall of Gargamel''' module which we will be using for demonstration purposes.

 
[[File:Talonius_Toolkit_Module_Create_005.png|left|middle|frame|How our module appears in the Other Campaigns menu.]]

This image gives you an idea as to where the values we're entering are being used. The menu shown is the '''Other Campaigns''' menu off the Dragon Age main menu. (The module will not show up until we export at least a portion of it; this is handled later.)

 
[[File:Talonius_Toolkit_Module_Create_006.png|left|middle|frame|Shows where are files live when they exported on Windows 7.]]

Here we can see that the directory in which our addin lives is named Gargamel, which corresponds to the UID value entered in the module properties. We can also see the various DLC items that have been installed from the game.

'''Note:''' On a Windows XP computer you'll find this directory in your '''My Documents''' folder.

File:Talonius Toolkit Module Create 004.png

2009-11-16T20:05:46Z

Talonius: uploaded a new version of "File:Talonius Toolkit Module Create 004.png": Revised version of the module properties with the user entered values highlighted.

Sample module properties screen for the "Fall of Gargamel" module.

File:Talonius Toolkit Module Create 006.png

2009-11-16T20:00:45Z

Talonius: Shows where the addins we create live on our file system.

Shows where the addins we create live on our file system.

File:Talonius Toolkit Module Create 005.png

2009-11-16T19:55:02Z

Talonius: Shows one way in which the module name is used in game.

Shows one way in which the module name is used in game.

File:Talonius Toolkit Module Create 004.png

2009-11-16T18:30:41Z

Talonius: Sample module properties screen for the "Fall of Gargamel" module.

Sample module properties screen for the "Fall of Gargamel" module.

User:Talonius/Sandbox

2009-11-16T18:21:26Z

Talonius:

User:Talonius/Sandbox

2009-11-16T18:19:04Z

Talonius: /* SQL Server 2005 Express Installation */ -- Correcting button caption.

== Why is this in your user profile? ==

I'm using my user profile as a scratch pad where I can get this into shape before adding it to the rest of the Wiki; I may or may not finish it depending upon what quality of tutorials I find elsewhere, so I don't want to create a page for it and then have to delete it. (I also need to do some verification/fact checking on some of what I believe.)

This page is intended to provide step by step instructions for each portion of the module creation process, including by linkage the various other pieces of the Wiki but allowing someone to follow it and understand how all the pieces go together.

== Creating a Small Adventure Step by Step ==

=== Check Prerequisites ===
Do not attempt to install the toolkit without ensuring you have at least Windows XP with Service Pack 3, Windows Vista, or Windows 7. The SP3 requirement can be overlooked if you're technically savvy but for the smoothest experience I'd recommend installing the whole shebang.

Want to know why not? Check the [[#http://social.bioware.com/forum/1/topic/8/index/113400|Forums]].

=== Install Python 2.5 ===
Python 2.5 is required for the light mapping inside the toolkit to function, and it is preferred that it be installed first. ActiveState's ActivePython is the best choice, and is available for free. The latest version as of November 15, 2009 (2009/11/15) is 2.5.4.4 and it can be found [[#https://www.activestate.com/activepython/downloads/|here]].

Caveats:
* There are some who have had issues with the 64 bit version; I personally haven't. You may want to pick up the 32 bit version just in case.
* Install to the default directory to avoid any issues with the toolkit. C:\Python25 is the normal default.

=== Toolkit Installation ===
These instructions and screenshots are for v1.0.982.0 of the toolkit. They may or may not apply to later versions.

The toolkit is available from [[#http://social.bioware.com/toolset.php#downloads|Bioware's Community Site]]. It's 472Mb.

Double click the executable to install the toolkit. If you have an antivirus scanner installed on your computer don't be surprised if it doesn't pop up right away; the antivirus scanner has to process all 472MB of the executable before it will be allowed to run.

If you have Windows Vista or Windows 7 you'll be prompted by UAC to allow the installer to run. Choose yes if you obtained the toolset from the Bioware site.

==== Welcome Screen ====
[[Image:Talonius_Toolkit_Install_Screen_001.png|left|middle|frame|This is the installer's welcome screen.]] Click the '''Next''' button.

 
==== End User License Agreement ====
[[File:Talonius_Toolkit_Install_Screen_002.png|left|middle|frame|This screenshot shows the installer's EULA agreement screen.]]

You'll be greeted with the end user license agreement. You're creating content for someone's software using this application; I highly recommend you actually read the license.

Accept the license agreement by selecting '''I accept the terms of the License Agreement''' and click '''Next'''.

 
==== Dragon Age Installation Directory Confirmation ====
[[File:Talonius_Toolkit_Install_Screen_003.png|left|middle|frame|This shows the screen confirming the location of Dragon Age on the PC the toolset is being installed on.]]

The third screen is asking you to confirm the installation directory of Dragon Age. The toolset requires Dragon Age to be installed; if the directory shown here isn't correct I would recommend reinstalling the game, then restarting the installation of the toolkit.

If the location is correct click '''Next''' to continue.

 
==== SQL Server 2005 Express Installation ====
[[File:Talonius_Toolkit_Install_Screen_004.png|left|middle|frame|This screen shows the configuration options for SQL Server 2005 Express.]]

SQL Server Express is a free version of SQL Server offered by Microsoft. It is a relational database that the toolset uses to store information about the currently installed modules and campaigns. Most of the problems around the installation of the toolkit revolve around the installation of SQL Server Express 2005.

If you have no idea what any of these things mean it is recommended that you leave the default settings as they are.

If you have an existing SQL Server 2005 installation you wish to use uncheck '''Install MS SQL Express 2005 SP3'''. You'll then need to check '''Custom settings:''' and enter in the information for the database you already have.

 
'''Examples:'''
* My SQL Server 2005 machine is named VORTEX, and it does not have any instances installed on it. The '''database server''' for it would simply be VORTEX. The '''database name''' would remain bw_dragonage_content unless you have a reason to change it.
* My workstation also has a copy of SQL Server 2008 on it with no instances. I could reference this installation one of two ways. The first would be as BRIAN-PC; the other would be by using the period by itself.
* It should be noted that the . in the database server refers to the local machine; this should be replaced by the name of the machine on which your installation of SQL Server resides. The \BWDATOOLSET refers to the database instance on that machine.

The installer will attempt to connect to the SQL Server you specify and it will run a series of scripts against the database you provided. You should ensure that SQL Server is running on the appropriate machine and that you have no data you wish to save in the database you selected to install to.

 
'''Problems?'''
* Visit the official forums and search there before posting; the most common issues have solutions already posted.
* Check the [[Installation troubleshooting]] page.
* A log file will be created in your Documents folder during the installation. This is good to have handy if you have issues during installation. The file in question is named "Install Dragon Age Toolset.txt".

Once the configuration is to your liking click '''Install''' to continue.

 

==== Toolkit Installation ====
[[File:Talonius_Toolkit_Install_Screen_005.png|left|middle|frame|This screenshot shows the installer as it progresses.]]

The installation will take some time. Grab a drink, use the restroom, put together a playlist for your listening pleasure.

 
==== Toolkit Installation Finished Verification ====
[[File:Talonius_Toolkit_Install_Screen_006.png|left|middle|frame|A screenshot of a successful installation.]]

The last item in the window above should be ''Completed''. If there's anything else scroll up in the window until you find the error and copy and paste that error somewhere for safe keeping. Seek help in the forums or on the Internet, and restart the installation process.

Click '''Next''' to continue.

 
==== Toolkit Installation Finished ====
[[File:Talonius_Toolkit_Install_Screen_007.png|left|middle|frame|The last screen of the toolkit installation.]]

You're done. Assuming no unexpected errors appeared during the installation process you should be ready to start editing.

Click '''Finish''' to complete the installation.

 
=== Starting the Toolkit ===
[[File:Talonius_Toolkit_Startup_Screen_001.png|left|middle|frame|The Windows 7 toolkit startup menu entry.]]

Find the Start Menu entry for the toolkit and click it. Give the toolkit some time to start up. As a benchmark, it takes approximately 12 seconds for the toolkit to start on my AMD Phenom 9850 with 4GB of RAM with a Windows Experience score 7.2.

 
=== Terminology ===
Learning something new is difficult. Concise terminology is required to give direction, but the terminology is usually somewhat recursive in definition. The following are some definitions that will help you navigate the remainder of this document.

; [[Module]]
: A module is the overarching container in which content is housed. It is the parent of all other content. The best comparison to the Dragon Age module are Dungeons and Dragons modules. Each module in D&D was a self contained adventure, complete with background, NPCs, maps, encounters, and any special rules which were to be in effect during the adventure.
; [[Area]]
: An area in a module is a self contained subset of the module, limited in size and/or scope. Areas are used to break the adventure into pieces, and are where the characters interact with the game. An area requires a level layout before it can be defined; see below. Items placed in an area are generally interactive, examinable, or dynamic in nature.
; [[Level]]
: A level defines the underlying static, immovable, non interactive portion of an area - structure and appearance. The level determines where PCs and NPCs can move (pathfinding) and lighting (ambient and otherwise). A level layout is required in order to define an area. A level can be created in one of two forms: terrain and room.
; [[Room]]
: A room

 
=== Modules ===
The toolset comes with two modules installed.

* The '''Single Player''' module is the campaign, and shouldn't be edited unless you want to modify the Dragon Age campaign itself. If you're creating an addin or mod for the official campaign, this is the module in which you'll want to work.
* The '''Demo''' module is installed for demonstration purposes by Bioware, and several other tutorials and forum posts refer to it.
 
[[File:Talonius_Toolkit_Module_Current_001.png|frame|left|The currently selected module is highlighted in the red box.]]

You can easily determine which module you're editing by looking at the title bar of the toolbox. In the image the currently edited module is highlighted by the red rectangle; the example has the '''Single Player''' module loaded.

Until you're comfortable with the toolkit it's best to work in a module separate from either of the above modules.

 
==== Create A Module ====
[[File:Talonius_Toolkit_Module_Create_001.png|left|middle|frame|The first step of creating a module.]]

To create a module click '''File''' then '''Manage Modules'''.

 
[[File:Talonius_Toolkit_Module_Create_002.png|left|middle|frame|The manage modules window.]]

The Manage Modules window will appear. Click the '''New''' button to create a module.

 
[[File:Talonius_Toolkit_Module_Create_003.png|left|middle|frame|The manage modules window.]]

The Object Properties window appears. All of these properties can be changed at a later date; our primary concern are the '''Name''' and '''UID''' properties.

User:Talonius/Sandbox

2009-11-16T18:18:31Z

Talonius: Saving WIP.

== Why is this in your user profile? ==

I'm using my user profile as a scratch pad where I can get this into shape before adding it to the rest of the Wiki; I may or may not finish it depending upon what quality of tutorials I find elsewhere, so I don't want to create a page for it and then have to delete it. (I also need to do some verification/fact checking on some of what I believe.)

This page is intended to provide step by step instructions for each portion of the module creation process, including by linkage the various other pieces of the Wiki but allowing someone to follow it and understand how all the pieces go together.

== Creating a Small Adventure Step by Step ==

=== Check Prerequisites ===
Do not attempt to install the toolkit without ensuring you have at least Windows XP with Service Pack 3, Windows Vista, or Windows 7. The SP3 requirement can be overlooked if you're technically savvy but for the smoothest experience I'd recommend installing the whole shebang.

Want to know why not? Check the [[#http://social.bioware.com/forum/1/topic/8/index/113400|Forums]].

=== Install Python 2.5 ===
Python 2.5 is required for the light mapping inside the toolkit to function, and it is preferred that it be installed first. ActiveState's ActivePython is the best choice, and is available for free. The latest version as of November 15, 2009 (2009/11/15) is 2.5.4.4 and it can be found [[#https://www.activestate.com/activepython/downloads/|here]].

Caveats:
* There are some who have had issues with the 64 bit version; I personally haven't. You may want to pick up the 32 bit version just in case.
* Install to the default directory to avoid any issues with the toolkit. C:\Python25 is the normal default.

=== Toolkit Installation ===
These instructions and screenshots are for v1.0.982.0 of the toolkit. They may or may not apply to later versions.

The toolkit is available from [[#http://social.bioware.com/toolset.php#downloads|Bioware's Community Site]]. It's 472Mb.

Double click the executable to install the toolkit. If you have an antivirus scanner installed on your computer don't be surprised if it doesn't pop up right away; the antivirus scanner has to process all 472MB of the executable before it will be allowed to run.

If you have Windows Vista or Windows 7 you'll be prompted by UAC to allow the installer to run. Choose yes if you obtained the toolset from the Bioware site.

==== Welcome Screen ====
[[Image:Talonius_Toolkit_Install_Screen_001.png|left|middle|frame|This is the installer's welcome screen.]] Click the '''Next''' button.

 
==== End User License Agreement ====
[[File:Talonius_Toolkit_Install_Screen_002.png|left|middle|frame|This screenshot shows the installer's EULA agreement screen.]]

You'll be greeted with the end user license agreement. You're creating content for someone's software using this application; I highly recommend you actually read the license.

Accept the license agreement by selecting '''I accept the terms of the License Agreement''' and click '''Next'''.

 
==== Dragon Age Installation Directory Confirmation ====
[[File:Talonius_Toolkit_Install_Screen_003.png|left|middle|frame|This shows the screen confirming the location of Dragon Age on the PC the toolset is being installed on.]]

The third screen is asking you to confirm the installation directory of Dragon Age. The toolset requires Dragon Age to be installed; if the directory shown here isn't correct I would recommend reinstalling the game, then restarting the installation of the toolkit.

If the location is correct click '''Next''' to continue.

 
==== SQL Server 2005 Express Installation ====
[[File:Talonius_Toolkit_Install_Screen_004.png|left|middle|frame|This screen shows the configuration options for SQL Server 2005 Express.]]

SQL Server Express is a free version of SQL Server offered by Microsoft. It is a relational database that the toolset uses to store information about the currently installed modules and campaigns. Most of the problems around the installation of the toolkit revolve around the installation of SQL Server Express 2005.

If you have no idea what any of these things mean it is recommended that you leave the default settings as they are.

If you have an existing SQL Server 2005 installation you wish to use uncheck '''Install MS SQL Express 2005 SP3'''. You'll then need to check '''Custom settings:''' and enter in the information for the database you already have.

 
'''Examples:'''
* My SQL Server 2005 machine is named VORTEX, and it does not have any instances installed on it. The '''database server''' for it would simply be VORTEX. The '''database name''' would remain bw_dragonage_content unless you have a reason to change it.
* My workstation also has a copy of SQL Server 2008 on it with no instances. I could reference this installation one of two ways. The first would be as BRIAN-PC; the other would be by using the period by itself.
* It should be noted that the . in the database server refers to the local machine; this should be replaced by the name of the machine on which your installation of SQL Server resides. The \BWDATOOLSET refers to the database instance on that machine.

The installer will attempt to connect to the SQL Server you specify and it will run a series of scripts against the database you provided. You should ensure that SQL Server is running on the appropriate machine and that you have no data you wish to save in the database you selected to install to.

 
'''Problems?'''
* Visit the official forums and search there before posting; the most common issues have solutions already posted.
* Check the [[Installation troubleshooting]] page.
* A log file will be created in your Documents folder during the installation. This is good to have handy if you have issues during installation. The file in question is named "Install Dragon Age Toolset.txt".

Once the configuration is to your liking click '''Next''' to continue.

 
==== Toolkit Installation ====
[[File:Talonius_Toolkit_Install_Screen_005.png|left|middle|frame|This screenshot shows the installer as it progresses.]]

The installation will take some time. Grab a drink, use the restroom, put together a playlist for your listening pleasure.

 
==== Toolkit Installation Finished Verification ====
[[File:Talonius_Toolkit_Install_Screen_006.png|left|middle|frame|A screenshot of a successful installation.]]

The last item in the window above should be ''Completed''. If there's anything else scroll up in the window until you find the error and copy and paste that error somewhere for safe keeping. Seek help in the forums or on the Internet, and restart the installation process.

Click '''Next''' to continue.

 
==== Toolkit Installation Finished ====
[[File:Talonius_Toolkit_Install_Screen_007.png|left|middle|frame|The last screen of the toolkit installation.]]

You're done. Assuming no unexpected errors appeared during the installation process you should be ready to start editing.

Click '''Finish''' to complete the installation.

 
=== Starting the Toolkit ===
[[File:Talonius_Toolkit_Startup_Screen_001.png|left|middle|frame|The Windows 7 toolkit startup menu entry.]]

Find the Start Menu entry for the toolkit and click it. Give the toolkit some time to start up. As a benchmark, it takes approximately 12 seconds for the toolkit to start on my AMD Phenom 9850 with 4GB of RAM with a Windows Experience score 7.2.

 
=== Terminology ===
Learning something new is difficult. Concise terminology is required to give direction, but the terminology is usually somewhat recursive in definition. The following are some definitions that will help you navigate the remainder of this document.

; [[Module]]
: A module is the overarching container in which content is housed. It is the parent of all other content. The best comparison to the Dragon Age module are Dungeons and Dragons modules. Each module in D&D was a self contained adventure, complete with background, NPCs, maps, encounters, and any special rules which were to be in effect during the adventure.
; [[Area]]
: An area in a module is a self contained subset of the module, limited in size and/or scope. Areas are used to break the adventure into pieces, and are where the characters interact with the game. An area requires a level layout before it can be defined; see below. Items placed in an area are generally interactive, examinable, or dynamic in nature.
; [[Level]]
: A level defines the underlying static, immovable, non interactive portion of an area - structure and appearance. The level determines where PCs and NPCs can move (pathfinding) and lighting (ambient and otherwise). A level layout is required in order to define an area. A level can be created in one of two forms: terrain and room.
; [[Room]]
: A room

 
=== Modules ===
The toolset comes with two modules installed.

* The '''Single Player''' module is the campaign, and shouldn't be edited unless you want to modify the Dragon Age campaign itself. If you're creating an addin or mod for the official campaign, this is the module in which you'll want to work.
* The '''Demo''' module is installed for demonstration purposes by Bioware, and several other tutorials and forum posts refer to it.
 
[[File:Talonius_Toolkit_Module_Current_001.png|frame|left|The currently selected module is highlighted in the red box.]]

You can easily determine which module you're editing by looking at the title bar of the toolbox. In the image the currently edited module is highlighted by the red rectangle; the example has the '''Single Player''' module loaded.

Until you're comfortable with the toolkit it's best to work in a module separate from either of the above modules.

 
==== Create A Module ====
[[File:Talonius_Toolkit_Module_Create_001.png|left|middle|frame|The first step of creating a module.]]

To create a module click '''File''' then '''Manage Modules'''.

 
[[File:Talonius_Toolkit_Module_Create_002.png|left|middle|frame|The manage modules window.]]

The Manage Modules window will appear. Click the '''New''' button to create a module.

 
[[File:Talonius_Toolkit_Module_Create_003.png|left|middle|frame|The manage modules window.]]

The Object Properties window appears. All of these properties can be changed at a later date; our primary concern are the '''Name''' and '''UID''' properties.

File:Talonius Toolkit Module Create 003.png

2009-11-16T18:16:25Z

Talonius: Shows the New Module Properties window that appears when creating a new module.

Shows the New Module Properties window that appears when creating a new module.

File:Talonius Toolkit Module Create 002.png

2009-11-16T18:12:00Z

Talonius: uploaded a new version of "File:Talonius Toolkit Module Create 002.png": A new version of the manage modules window with the new button highlighted.

Second step of the module creation process.

File:Talonius Toolkit Module Create 002.png

2009-11-16T17:44:45Z

Talonius: Second step of the module creation process.

Second step of the module creation process.

File:Talonius Toolkit Module Create 001.png

2009-11-16T17:41:31Z

Talonius: Screenshot of the first step of creating a module.

Screenshot of the first step of creating a module.

File:Talonius Toolkit Module Current 001.png

2009-11-16T17:31:19Z

Talonius: Highlighted area showing how to determine which module is being edited.

Highlighted area showing how to determine which module is being edited.

User:Talonius

2009-11-16T17:01:02Z

Talonius:

[[User:Talonius/Sandbox|Sandbox]]

User:Talonius/Sandbox

2009-11-16T17:00:31Z

Talonius: moved User:Talonius to User:Talonius/Sandbox: Sandbox is the proper location for this.

== Why is this in your user profile? ==

I'm using my user profile as a scratch pad where I can get this into shape before adding it to the rest of the Wiki; I may or may not finish it depending upon what quality of tutorials I find elsewhere, so I don't want to create a page for it and then have to delete it. (I also need to do some verification/fact checking on some of what I believe.)

This page is intended to provide step by step instructions for each portion of the module creation process, including by linkage the various other pieces of the Wiki but allowing someone to follow it and understand how all the pieces go together.

== Creating a Small Adventure Step by Step ==

=== Check Prerequisites ===
Do not attempt to install the toolkit without ensuring you have at least Windows XP with Service Pack 3, Windows Vista, or Windows 7. The SP3 requirement can be overlooked if you're technically savvy but for the smoothest experience I'd recommend installing the whole shebang.

Want to know why not? Check the [[#http://social.bioware.com/forum/1/topic/8/index/113400|Forums]].

=== Install Python 2.5 ===
Python 2.5 is required for the light mapping inside the toolkit to function, and it is preferred that it be installed first. ActiveState's ActivePython is the best choice, and is available for free. The latest version as of November 15, 2009 (2009/11/15) is 2.5.4.4 and it can be found [[#https://www.activestate.com/activepython/downloads/|here]].

Caveats:
* There are some who have had issues with the 64 bit version; I personally haven't. You may want to pick up the 32 bit version just in case.
* Install to the default directory to avoid any issues with the toolkit. C:\Python25 is the normal default.

=== Toolkit Installation ===
These instructions and screenshots are for v1.0.982.0 of the toolkit. They may or may not apply to later versions.

The toolkit is available from [[#http://social.bioware.com/toolset.php#downloads|Bioware's Community Site]]. It's 472Mb.

Double click the executable to install the toolkit. If you have an antivirus scanner installed on your computer don't be surprised if it doesn't pop up right away; the antivirus scanner has to process all 472MB of the executable before it will be allowed to run.

If you have Windows Vista or Windows 7 you'll be prompted by UAC to allow the installer to run. Choose yes if you obtained the toolset from the Bioware site.

==== Welcome Screen ====
[[File:Talonius_Toolkit_Install_Screen_001.png]]

Click the '''Next''' button.

==== End User License Agreement ====
[[File:Talonius_Toolkit_Install_Screen_002.png]]

You'll be greeted with the end user license agreement. You're creating content for someone's software using this application; I highly recommend you actually read the license.

Accept the license agreement by selecting '''I accept the terms of the License Agreement''' and click '''Next'''.

==== Dragon Age Installation Directory Confirmation ====
[[File:Talonius_Toolkit_Install_Screen_003.png]]

The third screen is asking you to confirm the installation directory of Dragon Age. The toolset requires Dragon Age to be installed; if the directory shown here isn't correct I would recommend reinstalling the game, then restarting the installation of the toolkit.

==== SQL Server 2005 Express Installation ====
[[File:Talonius_Toolkit_Install_Screen_004.png]]

SQL Server Express is a free version of SQL Server offered by Microsoft. It is a relational database that the toolset uses to store information about the currently installed modules and campaigns. Most of the problems around the installation of the toolkit revolve around the installation of SQL Server Express 2005.

If you have an existing SQL Server 2005 installation you wish to use uncheck '''Install MS SQL Express 2005 SP3'''. You'll then need to check '''Custom settings:''' and enter in the information for the database you already have.

Examples:
* My SQL Server 2005 machine is named VORTEX, and it does not have any instances installed on it. The '''database server''' for it would simply be VORTEX. The database name would remain bw_dragonage_content unless I had changed it when I created it.
* My workstation also has a copy of SQL Server 2008 on it with no instances. I could reference this installation one of two ways. The first would be as BRIAN-PC; the other would be by using the period by itself.
* It should be noted that the . in the database server refers to the local machine; this should be replaced by the name of the machine on which your installation of SQL Server resides. The \BWDATOOLSET refers to the database instance on that machine.

The installer will attempt to connect to the SQL Server you specify and it will run a series of scripts against the database you provided. You should ensure that SQL Server is running on the appropriate machine and that you have no data you wish to save in the database you selected to install to.

Problems?
* Visit the official forums and search there before posting; the most common issues have solutions already posted.
* Check the [[Installation troubleshooting]] page.
* A log file will be created in your Documents folder during the installation. This is good to have handy if you have issues during installation. The file in question is named "Install Dragon Age Toolset.txt".

==== Toolkit Installation ====
[[File:Talonius_Toolkit_Install_Screen_005.png]]

The installation will take some time.

==== Toolkit Installation Finished Verification ====
[[File:Talonius_Toolkit_Install_Screen_006.png]]

The last item in the window above should be ''Completed''. If there's anything else scroll up in the window until you find the error and copy and paste that error somewhere for safe keeping. Seek help in the forums or on the Internet, and restart the installation process.

Click '''Next'''.

==== Toolkit Installation Finished ====
[[File:Talonius_Toolkit_Install_Screen_007.png]]

You're done. Assuming no unexpected errors appeared during the installation process you should be ready to start editing.

=== Starting the Toolkit ===
[[File:Talonius_Toolkit_Startup_Screen_001.png]]

Find the Start Menu entry for the toolkit and click it. Again, give the toolkit some time to start up. As a benchmark, it takes approximately 12 seconds for the toolkit to start on my AMD Phenom 9850 with 4GB of RAM, with a Windows Experience score 7.2.

=== Terminology ===
Learning something new is difficult. Concise terminology is required to give direction, but the terminology is usually somewhat recursive in definition. The following are some definitions that will help you navigate the remainder of this document.

; [[Module]]
: A module is the overarching container in which content is housed. It is the parent of all other content. The best comparison to the Dragon Age module are Dungeons and Dragons modules. Each module in D&D was a self contained adventure, complete with background, NPCs, maps, encounters, and any special rules which were to be in effect during the adventure.
; [[Area]]
: An area in a module is a self contained subset of the module, limited in size and/or scope. Areas are used to break the adventure into pieces, and are where the characters interact with the game. An area requires a level layout before it can be defined; see below. Items placed in an area are generally interactive, examinable, or dynamic in nature.
; [[Level]]
: A level defines the underlying static, immovable, non interactive portion of an area - structure and appearance. The level determines where PCs and NPCs can move (pathfinding) and lighting (ambient and otherwise). A level layout is required in order to define an area. A level can be created in one of two forms: terrain and room.
; [[Room]]
: A room

==== Modules ====
The toolset comes with two modules installed.

* The '''Single Player''' module is the campaign, and shouldn't be edited unless you want to modify the Dragon Age campaign itself. If you're creating an addin or mod for the official campaign, this is the module in which you'll want to work.
* The '''Demo''' module is installed for demonstration purposes by Bioware, and several other tutorials and forum posts refer to it.

User:Talonius

2009-11-16T17:00:31Z

Talonius: moved User:Talonius to User:Talonius/Sandbox: Sandbox is the proper location for this.

#REDIRECT [[User:Talonius/Sandbox]]

User:Talonius/Sandbox

2009-11-16T05:42:32Z

Talonius:

== Why is this in your user profile? ==

I'm using my user profile as a scratch pad where I can get this into shape before adding it to the rest of the Wiki; I may or may not finish it depending upon what quality of tutorials I find elsewhere, so I don't want to create a page for it and then have to delete it. (I also need to do some verification/fact checking on some of what I believe.)

This page is intended to provide step by step instructions for each portion of the module creation process, including by linkage the various other pieces of the Wiki but allowing someone to follow it and understand how all the pieces go together.

== Creating a Small Adventure Step by Step ==

=== Check Prerequisites ===
Do not attempt to install the toolkit without ensuring you have at least Windows XP with Service Pack 3, Windows Vista, or Windows 7. The SP3 requirement can be overlooked if you're technically savvy but for the smoothest experience I'd recommend installing the whole shebang.

Want to know why not? Check the [[#http://social.bioware.com/forum/1/topic/8/index/113400|Forums]].

=== Install Python 2.5 ===
Python 2.5 is required for the light mapping inside the toolkit to function, and it is preferred that it be installed first. ActiveState's ActivePython is the best choice, and is available for free. The latest version as of November 15, 2009 (2009/11/15) is 2.5.4.4 and it can be found [[#https://www.activestate.com/activepython/downloads/|here]].

Caveats:
* There are some who have had issues with the 64 bit version; I personally haven't. You may want to pick up the 32 bit version just in case.
* Install to the default directory to avoid any issues with the toolkit. C:\Python25 is the normal default.

=== Toolkit Installation ===
These instructions and screenshots are for v1.0.982.0 of the toolkit. They may or may not apply to later versions.

The toolkit is available from [[#http://social.bioware.com/toolset.php#downloads|Bioware's Community Site]]. It's 472Mb.

Double click the executable to install the toolkit. If you have an antivirus scanner installed on your computer don't be surprised if it doesn't pop up right away; the antivirus scanner has to process all 472MB of the executable before it will be allowed to run.

If you have Windows Vista or Windows 7 you'll be prompted by UAC to allow the installer to run. Choose yes if you obtained the toolset from the Bioware site.

==== Welcome Screen ====
[[File:Talonius_Toolkit_Install_Screen_001.png]]

Click the '''Next''' button.

==== End User License Agreement ====
[[File:Talonius_Toolkit_Install_Screen_002.png]]

You'll be greeted with the end user license agreement. You're creating content for someone's software using this application; I highly recommend you actually read the license.

Accept the license agreement by selecting '''I accept the terms of the License Agreement''' and click '''Next'''.

==== Dragon Age Installation Directory Confirmation ====
[[File:Talonius_Toolkit_Install_Screen_003.png]]

The third screen is asking you to confirm the installation directory of Dragon Age. The toolset requires Dragon Age to be installed; if the directory shown here isn't correct I would recommend reinstalling the game, then restarting the installation of the toolkit.

==== SQL Server 2005 Express Installation ====
[[File:Talonius_Toolkit_Install_Screen_004.png]]

SQL Server Express is a free version of SQL Server offered by Microsoft. It is a relational database that the toolset uses to store information about the currently installed modules and campaigns. Most of the problems around the installation of the toolkit revolve around the installation of SQL Server Express 2005.

If you have an existing SQL Server 2005 installation you wish to use uncheck '''Install MS SQL Express 2005 SP3'''. You'll then need to check '''Custom settings:''' and enter in the information for the database you already have.

Examples:
* My SQL Server 2005 machine is named VORTEX, and it does not have any instances installed on it. The '''database server''' for it would simply be VORTEX. The database name would remain bw_dragonage_content unless I had changed it when I created it.
* My workstation also has a copy of SQL Server 2008 on it with no instances. I could reference this installation one of two ways. The first would be as BRIAN-PC; the other would be by using the period by itself.
* It should be noted that the . in the database server refers to the local machine; this should be replaced by the name of the machine on which your installation of SQL Server resides. The \BWDATOOLSET refers to the database instance on that machine.

The installer will attempt to connect to the SQL Server you specify and it will run a series of scripts against the database you provided. You should ensure that SQL Server is running on the appropriate machine and that you have no data you wish to save in the database you selected to install to.

Problems?
* Visit the official forums and search there before posting; the most common issues have solutions already posted.
* Check the [[Installation troubleshooting]] page.
* A log file will be created in your Documents folder during the installation. This is good to have handy if you have issues during installation. The file in question is named "Install Dragon Age Toolset.txt".

==== Toolkit Installation ====
[[File:Talonius_Toolkit_Install_Screen_005.png]]

The installation will take some time.

==== Toolkit Installation Finished Verification ====
[[File:Talonius_Toolkit_Install_Screen_006.png]]

The last item in the window above should be ''Completed''. If there's anything else scroll up in the window until you find the error and copy and paste that error somewhere for safe keeping. Seek help in the forums or on the Internet, and restart the installation process.

Click '''Next'''.

==== Toolkit Installation Finished ====
[[File:Talonius_Toolkit_Install_Screen_007.png]]

You're done. Assuming no unexpected errors appeared during the installation process you should be ready to start editing.

=== Starting the Toolkit ===
[[File:Talonius_Toolkit_Startup_Screen_001.png]]

Find the Start Menu entry for the toolkit and click it. Again, give the toolkit some time to start up. As a benchmark, it takes approximately 12 seconds for the toolkit to start on my AMD Phenom 9850 with 4GB of RAM, with a Windows Experience score 7.2.

=== Terminology ===
Learning something new is difficult. Concise terminology is required to give direction, but the terminology is usually somewhat recursive in definition. The following are some definitions that will help you navigate the remainder of this document.

; [[Module]]
: A module is the overarching container in which content is housed. It is the parent of all other content. The best comparison to the Dragon Age module are Dungeons and Dragons modules. Each module in D&D was a self contained adventure, complete with background, NPCs, maps, encounters, and any special rules which were to be in effect during the adventure.
; [[Area]]
: An area in a module is a self contained subset of the module, limited in size and/or scope. Areas are used to break the adventure into pieces, and are where the characters interact with the game. An area requires a level layout before it can be defined; see below. Items placed in an area are generally interactive, examinable, or dynamic in nature.
; [[Level]]
: A level defines the underlying static, immovable, non interactive portion of an area - structure and appearance. The level determines where PCs and NPCs can move (pathfinding), lighting (ambient and otherwise), and starting points. A level layout is required in order to define an area. A level can be created in one of two forms: terrain and room.
; [[Room]]
: A room

==== Modules ====
The toolset comes with two modules installed.

* The '''Single Player''' module is the campaign, and shouldn't be edited unless you want to modify the Dragon Age campaign itself. If you're creating an addin or mod for the official campaign, this is the module in which you'll want to work.
* The '''Demo''' module is installed for demonstration purposes by Bioware, and several other tutorials and forum posts refer to it.

User:Talonius/Sandbox

2009-11-16T04:41:05Z

Talonius:

User:Talonius/Sandbox

2009-11-16T04:34:50Z

Talonius: Created page with '== Creating a Small Adventure Step by Step == === Check Prerequisites === Do not attempt to install the toolkit without ensuring you have at least Windows XP with Service Pack 3...'

== Creating a Small Adventure Step by Step ==

=== Check Prerequisites ===
Do not attempt to install the toolkit without ensuring you have at least Windows XP with Service Pack 3, Windows Vista, or Windows 7. The SP3 requirement can be overlooked if you're technically savvy but for the smoothest experience I'd recommend installing the whole shebang.

Want to know why not? Check the [[#http://social.bioware.com/forum/1/topic/8/index/113400|Forums]].

=== Install Python 2.5 ===
Python 2.5 is required for the light mapping inside the toolkit to function, and it is preferred that it be installed first. ActiveState's ActivePython is the best choice, and is available for free. The latest version as of November 15, 2009 (2009/11/15) is 2.5.4.4 and it can be found [[#https://www.activestate.com/activepython/downloads/|here]].

Caveats:
* There are some who have had issues with the 64 bit version; I personally haven't. You may want to pick up the 32 bit version just in case.
* Install to the default directory to avoid any issues with the toolkit. C:\Python25 is the normal default.

=== Toolkit Installation ===
These instructions and screenshots are for v1.0.982.0 of the toolkit. They may or may not apply to later versions.

The toolkit is available from [[#http://social.bioware.com/toolset.php#downloads|Bioware's Community Site]]. It's 472Mb.

Double click the executable to install the toolkit. If you have an antivirus scanner installed on your computer don't be surprised if it doesn't pop up right away; the antivirus scanner has to process all 472MB of the executable before it will be allowed to run.

If you have Windows Vista or Windows 7 you'll be prompted by UAC to allow the installer to run. Choose yes if you obtained the toolset from the Bioware site.

==== Welcome Screen ====
[[File:Talonius_Toolkit_Install_Screen_001.png]]

Click the '''Next''' button.

==== End User License Agreement ====
[[File:Talonius_Toolkit_Install_Screen_002.png]]

You'll be greeted with the end user license agreement. You're creating content for someone's software using this application; I highly recommend you actually read the license.

Accept the license agreement by selecting '''I accept the terms of the License Agreement''' and click '''Next'''.

==== Dragon Age Installation Directory Confirmation ====
[[File:Talonius_Toolkit_Install_Screen_003.png]]

The third screen is asking you to confirm the installation directory of Dragon Age. The toolset requires Dragon Age to be installed; if the directory shown here isn't correct I would recommend reinstalling the game, then restarting the installation of the toolkit.

==== SQL Server 2005 Express Installation ====
[[File:Talonius_Toolkit_Install_Screen_004.png]]

SQL Server Express is a free version of SQL Server offered by Microsoft. It is a relational database that the toolset uses to store information about the currently installed modules and campaigns. Most of the problems around the installation of the toolkit revolve around the installation of SQL Server Express 2005.

If you have an existing SQL Server 2005 installation you wish to use uncheck '''Install MS SQL Express 2005 SP3'''. You'll then need to check '''Custom settings:''' and enter in the information for the database you already have.

Examples:
* My SQL Server 2005 machine is named VORTEX, and it does not have any instances installed on it. The '''database server''' for it would simply be VORTEX. The database name would remain bw_dragonage_content unless I had changed it when I created it.
* My workstation also has a copy of SQL Server 2008 on it with no instances. I could reference this installation one of two ways. The first would be as BRIAN-PC; the other would be by using the period by itself.
* It should be noted that the . in the database server refers to the local machine; this should be replaced by the name of the machine on which your installation of SQL Server resides. The \BWDATOOLSET refers to the database instance on that machine.

The installer will attempt to connect to the SQL Server you specify and it will run a series of scripts against the database you provided. You should ensure that SQL Server is running on the appropriate machine and that you have no data you wish to save in the database you selected to install to.

Problems?
* Visit the official forums and search there before posting; the most common issues have solutions already posted.
* Check the [[Installation troubleshooting]] page.
* A log file will be created in your Documents folder during the installation. This is good to have handy if you have issues during installation. The file in question is named "Install Dragon Age Toolset.txt".

==== Toolkit Installation ====
[[File:Talonius_Toolkit_Install_Screen_005.png]]

The installation will take some time.

==== Toolkit Installation Finished Verification ====
[[File:Talonius_Toolkit_Install_Screen_006.png]]

The last item in the window above should be ''Completed''. If there's anything else scroll up in the window until you find the error and copy and paste that error somewhere for safe keeping. Seek help in the forums or on the Internet, and restart the installation process.

Click '''Next'''.

==== Toolkit Installation Finished ====
[[File:Talonius_Toolkit_Install_Screen_007.png]]

You're done. Assuming no unexpected errors appeared during the installation process you should be ready to start editing.

=== Starting the Toolkit ===
[[File:Talonius_Toolkit_Startup_Screen_001.png]]

Find the Start Menu entry for the toolkit and click it. Again, give the toolkit some time to start up. As a benchmark, it takes approximately 12 seconds for the toolkit to start on my AMD Phenom 9850 with 4GB of RAM, with a Windows Experience score 7.2.

File:Talonius Toolkit Startup Screen 001.png

2009-11-16T04:31:52Z

Talonius: Toolkit Installation Startup for Dummies, Screen 1.

Toolkit Installation Startup for Dummies, Screen 1.

File:Talonius Toolkit Install Screen 007.png

2009-11-16T04:21:45Z

Talonius: Toolkit Installation Walkthrough for Dummies, Screen 7.

Toolkit Installation Walkthrough for Dummies, Screen 7.

File:Talonius Toolkit Install Screen 006.png

2009-11-16T04:21:33Z

Talonius: Toolkit Installation Walkthrough for Dummies, Screen 6.

Toolkit Installation Walkthrough for Dummies, Screen 6.

File:Talonius Toolkit Install Screen 005.png

2009-11-16T04:17:51Z

Talonius: Toolkit Installation Walkthrough for Dummies, Screen 5.

Toolkit Installation Walkthrough for Dummies, Screen 5.

File:Talonius Toolkit Install Screen 004.png

2009-11-16T04:17:41Z

Talonius: Toolkit Installation Walkthrough for Dummies, Screen 4.

Toolkit Installation Walkthrough for Dummies, Screen 4.

File:Talonius Toolkit Install Screen 003.png

2009-11-16T04:17:28Z

Talonius: Toolkit Installation Walkthrough for Dummies, Screen 3.

Toolkit Installation Walkthrough for Dummies, Screen 3.

File:Talonius Toolkit Install Screen 002.png

2009-11-16T04:17:13Z

Talonius: Toolkit Installation Walkthrough for Dummies, Screen 2.

Toolkit Installation Walkthrough for Dummies, Screen 2.

File:Talonius Toolkit Install Screen 001.png

2009-11-16T04:16:53Z

Talonius: Toolkit Installation Walkthrough for Dummies, Screen 1.

Toolkit Installation Walkthrough for Dummies, Screen 1.

Tutorials

2009-11-16T01:04:05Z

Talonius: Added links to known external tutorials.

In the course of these tutorials we'll go through all the steps needed to create a basic adventure.

{{sidebox|
*Boxes like this contain a checklist of important steps.
*They're intended as a reminder and as a navigational aid.
}}

*[[Introductory tutorial]] - An overview of the toolset as a whole
*[[Module tutorial]] - how to create a module to work in.

This set of tutorials forms a series, each building on or filling in omissions by the last:
*[[Level Editor Tutorial]]
*[[Placeable tutorial]]
*[[Area tutorial]]
*[[Item tutorial]]
*[[Creature tutorial]]
*[[Conversation tutorial]]
*[[Scripting tutorial]]

Once you've become familiar with the basics introduced on those tutorials you might have a better grounding for:
*[[Cutscene tutorial]]
*[[Map tutorial]] (which also introduces you to [[2DA]] editing)

== Demo module ==

The toolset currently ships with a simple demo module pre-loaded into its database.

*[[Demo module]] - how to export and run the demo module.

== External Tutorials ==

*[[#http://www.youtube.com/watch?v=TwQNRBFLhrE|Playable Area and Conversation]] video tutorial by [[#http://social.bioware.com/64020/|st4rdog]].
*[[#http://www.youtube.com/watch?v=CaHldJcUTz8|Simple Converstaion Cameras]] video tutorial by [[#http://social.bioware.com/64020/|st4rdog]].
*[[#http://www.youtube.com/watch?v=QOQJ2heQto4|Cutscene and Trigger]] video tutorial by [[#http://social.bioware.com/64020/|st4rdog]].
*[[#http://www.youtube.com/watch?v=szWKgj2ZuXo|Custom Level and Room Building]] video tutorial by [[#http://social.bioware.com/64020/|st4rdog]].
*[[#http://www.youtube.com/watch?v=DKJ7F14n8o8|Downloading and Installing the Toolset]] video tutorial by [[#http://social.bioware.com/74287/|DragonAge22]].
*[[#http://www.youtube.com/watch?v=iMPBsulv9xI|Creating a Room]] video tutorial by [[#http://social.bioware.com/74287/|DragonAge22]].
*[[#http://www.youtube.com/watch?v=g3kx2CaarHo|How to Make an Interior Level with Lighting]] by [[#http://social.bioware.com/group/60/|Darkworld Development Team]].
*[[#http://www.youtube.com/watch?v=O6TeZeE1Lc8|Making a Room]] by BigDrip681.

[[Category:Tutorials| ]]