Dragon Age Toolset Wiki - User contributions [en]

Community Contest 4: Minigame Script

2010-10-30T20:27:37Z

L o B o: Added "The Doors of Death by Lobo" constest entry.

[[File:Community_Contest_back.jpg|link=Community_Contest_Main_Page]] [[File:CC_BSN_GetInvolved.jpg|link=http://social.bioware.com/group/2535/&v=discussions]]

== Brief ==

Create a minigame or puzzle using scripting. The contest discussion thread can be found [http://social.bioware.com/group/2535/discussion/10583/916864/#post_916864 here].

'''DEADLINE: Monday 1 November''' - your entry must be ready for judging before midday GMT+0. It is strongly recommended you submit well before this time (sunday!) in case you run into troubles. Modifications to your submission are welcomed - the newest version of your entry will be judged, although modifications made ''after'' the submission date will not be judged.

=== Requirements ===
All entries must:
* Reserve and use a [[Community_Contest_ID_Ranges|StringID range]]
* Be thoroughly tested in-game
* Be submitted in a single, playable area (the level will not be "marked")
* Include dadbdata export of all relevant resources
* Include a playable dazip of the mini-game - should be playable from the other campaigns menu
* Include a plain-text file detailing the mini-game implementation - the objective, customization options (if present) and solutions
* Use only DA assets (placeables, levels) ''unless the relevant files are included with the submission and author's permission has been given''
* Be submitted before Monday 1 November midday (GMT+0)

=== Guidelines ===
Strong entries will:
* be easily adaptable to vary the minigame in other modules
* be unique and interesting
* use elegant and tidy scripting
* include well-written, detailed comments
* be well-designed and be free of bugs and discourage user error
* be significant as a piece of scripting: doing something new or expanding beyond the fundamentals of scripting
* make appropriate use of secondary resources (triggers, placeables, dialogues, floaty text, VFX, sound, etc)

=== Allowable ===
While no "bonus points" will be given for the following, entries may:
* use custom levels provided that the level is shared with the submission (.lvl and exported files)

== Groups and Prizes ==

=== Groups ===
This contest has only one group.

* 1st place - 15 points, chooses first
* 2nd place - 10 points, chooses second
* 3rd place - 5 points, chooses third
* Best Newcomer - 3 points (unless 1st, 2nd or 3rd place)
* All other entries meeting requirements - 1 point

To receive an "entry point", your submission must meet the requirements of the contest, listed at the top of this page

=== Best Newcomer Award ===
Every judge may nominate one newcomer as their favourite newcomer entry. To qualify, the entrant must not have submitted to a community contest before. The winning newcomer will receive three points if they don't podium (in which case, theyll be getting more points anyway!).

=== Prizes ===

Please see [[Community_Contest_Prizes|Community Contest Prizes]]

== Helpful Links ==
* [[Scripting_overview|Scripting Overview]] - Builder Wiki
* [[Scripting_tutorial|Scripting Tutorial]] - Builder Wiki
* [http://dalexicon.net/index.php?title=Main_Page Dragon Age Lexicon] - Scripting Resource

= Entries =

For information on how to enter, please see the [[Community_Contest_Entry_FAQ|Entry FAQs]]

For information on Judging, please see the [[Community_Contest_Judging|Judging]] page.

IMPORTANT - consent to share

By entering this competition you consent to share your work for other community members to benefit from.
Where appropriate, source files should be shared (dadbdata and any non-DA assets you have used including levels, props etc).
The work *MUST* be your own (obviously you may use DA assets).
Others may use and modify your work in their Dragon Age mods, though are encouraged to give credit.
As the entries are judged, local copies will be saved If your work is taken down.
If your work is taken down, you allow for it to be re-uploaded, crediting the work in your name. 

== Example Entry by YourNameHere ==

* '''[http://www.dragonagenexus.com/downloads/file.php?id=1559 Links here in this format]'''

Description here. Try to keep it short, but include as many relevant details as possible. Description here. Try to keep it short, but include as many relevant details as possible. Description here. Try to keep it short, but include as many relevant details as possible. Description here. Try to keep it short, but include as many relevant details as possible.

Description here. Try to keep it short, but include as many relevant details as possible. Description here. Try to keep it short, but include as many relevant details as possible. Description here. Try to keep it short, but include as many relevant details as possible. Description here. Try to keep it short, but include as many relevant details as possible.

[[File:terrainBlockExample.png|400px|example picture]]

=== Judges' Comments ===

Judges will leave comments both as contructive suggestions for the entrant and also as impartial guidance for any looking to make use of your work.

== Weighted RPS by Mengtzu ==

* '''[http://www.dragonagenexus.com/downloads/file.php?id=1850 Dragon Age Nexus project page]'''

Rock, Paper, Scissors as a multi-round gambling game, with weighted moves to introduce strategy and customisable AI. Multiple games with different settings may share an area, allowing a tournament/festival style implementation, as demonstrated in the sample module. By default the player earns prize tokens which may be traded in for items.

Modular functions and constants make the engine easy to extend or modify.

[[File:Rps guanyin.jpg|400px|Game in progress]]

=== Judges' Comments ===

== Nug Chase by Bloodsong ==

* '''[http://www.dragonagenexus.com/downloads/file.php?id=1859 Nug Chase on Dragon Age Nexus]'''

A simple action-oriented mini-game for players of any level. Granny Rockbottom's prize Racing Nug has escaped his pen, and you need to catch him. To do this, you need to click on the nug and get close enough to initate a conversation. If you are successful, you catch the pesky nug. If not, hilarity ensues. :X

Includes a custom Nug Wallows area/level, and a convoluted conversation tree with the NPC. Rewards are small gifts, some XP, and possibly a small amount of cash. Documentation for customizing also included.

[[File:NugChase1.jpg|400px|Nug Chase Promo]]

Please report any file/installation problems here:
* '''[http://social.bioware.com/project/3512/discussion/2597/20416/#post_20416 Nug Chase Project]'''

=== Judges' Comments ===

Judges will leave comments both as contructive suggestions for the entrant and also as impartial guidance for any looking to make use of your work.

== The Doors of Death by Lobo ==

* '''[http://www.dragonagenexus.com/downloads/file.php?id=1860 The Doors of Death on Dragon Age Nexus]'''

This is a standalone module that contains a simple puzzle with doors.

There is a sequence of 4 doors that will lead you to the exit of the maze.

Each wrong choice will bring you back to the starting position, so you'll have to repeat the sequence again.

There is a little secret that you'll have to find out to solve the puzzle :)

[[File:TheDoorsOfDeath.png|400px|The Doors Of Death Screenshot]]

=== Judges' Comments ===

Judges will leave comments both as contructive suggestions for the entrant and also as impartial guidance for any looking to make use of your work.

File:TheDoorsOfDeath.png

2010-10-30T20:24:05Z

L o B o: The Doors of Death Screenshot

The Doors of Death Screenshot

Community Contest ID Ranges

2010-10-23T16:06:07Z

L o B o: /* String ranges */

[[File:Community_Contest_back.jpg|link=Community_Contest_Main_Page]] [[File:CC_BSN_GetInvolved.jpg|link=http://social.bioware.com/group/2535/&v=discussions]]

So that all Community Contest entries are compatible with one another and also with other mods that are around, IDs must not conflict. To ensure this, we must reserve ID ranges for strings and 2da ranges.

= String ranges =

Please modify this table to reserve String IDs '''before you use them''' (to avoid lost work). Append within our range if required. Please do not use from outside this range.

{| class="wikitable"
|-
! Range Begin
! Range End
! Used by
|- style="color:#ff6666;"
| '''89000000'''
| '''89999999'''
| '''Entire CC Range (to be divided up)'''
|-
| 89000000
| 89099999
| Organiser reserved range
|-
| 89100000
| 89100999
| Cuvieronius
|-
| 89101000
| 89101999
| Vaylise
|-
| 89102000
| 89102999
| BAPACop
|-
| 89103000
| 89103999
| BloodsongVengeance
|-
| 89104000
| 89104999
| Jackkel Dragon
|-
| 89105000
| 89105999
| Lord Uber Dowzen (uberdowzen)
|-
| 89106000
| 89106999
| Shadow5973
|-
| 89107000
| 89107999
| Lobo
|-
| 89108000
| 89108999
| Available
|-
| 89109000
| 89109999
| (please keep extending this list as requried)
|}

=== Why reserve an ID range? ===
This prevents the need for other modders to change your strings. This prevents any chance of overlapping IDs with other entries or other mods. This means that if you attach voice to conversations, or specify a StringID in a 2da, these connections will not be broken when others use your mod.

=== How many do I reserve? ===
Just take 1000 unless you need more. Do not take less, we've got plenty to spare ;)

=== How do I set my module to use those strings? ===

* While logged in to builder wiki (same as login here), edit the page to put your name next to the range.
* In Toolset, go File > Manage Modules > (select your module) > Properties
* Set the following:
** StringID Begin
** StringID End
** StringID Last Used
* Hit OK and close dialogue.

= 2da Ranges =

Currently, we have not reserved any ranges on [[2DA_ranges_in_use|The 2da reserve page]]. If you require a 2da range, please contact [http://social.bioware.com/145661/ mikemike37]

Community Contest ID Ranges

2010-10-23T16:04:35Z

L o B o: /* String ranges */

[[File:Community_Contest_back.jpg|link=Community_Contest_Main_Page]] [[File:CC_BSN_GetInvolved.jpg|link=http://social.bioware.com/group/2535/&v=discussions]]

So that all Community Contest entries are compatible with one another and also with other mods that are around, IDs must not conflict. To ensure this, we must reserve ID ranges for strings and 2da ranges.

= String ranges =

Please modify this table to reserve String IDs '''before you use them''' (to avoid lost work). Append within our range if required. Please do not use from outside this range.

{| class="wikitable"
|-
! Range Begin
! Range End
! Used by
|- style="color:#ff6666;"
| '''89000000'''
| '''89999999'''
| '''Entire CC Range (to be divided up)'''
|-
| 89000000
| 89099999
| Organiser reserved range
|-
| 89100000
| 89100999
| Cuvieronius
|-
| 89101000
| 89101999
| Vaylise
|-
| 89102000
| 89102999
| BAPACop
|-
| 89103000
| 89103999
| BloodsongVengeance
|-
| 89104000
| 89104999
| Jackkel Dragon
|-
| 89105000
| 89105999
| Lord Uber Dowzen (uberdowzen)
|-
| 89106000
| 89106999
| Shadow5973
|-
| 89108000
| 89108999
| Lobo
|-
| 89109000
| 89109999
| Available
|-
| 89110000
| 89110999
| (please keep extending this list as requried)
|}

=== Why reserve an ID range? ===
This prevents the need for other modders to change your strings. This prevents any chance of overlapping IDs with other entries or other mods. This means that if you attach voice to conversations, or specify a StringID in a 2da, these connections will not be broken when others use your mod.

=== How many do I reserve? ===
Just take 1000 unless you need more. Do not take less, we've got plenty to spare ;)

=== How do I set my module to use those strings? ===

* While logged in to builder wiki (same as login here), edit the page to put your name next to the range.
* In Toolset, go File > Manage Modules > (select your module) > Properties
* Set the following:
** StringID Begin
** StringID End
** StringID Last Used
* Hit OK and close dialogue.

= 2da Ranges =

Currently, we have not reserved any ranges on [[2DA_ranges_in_use|The 2da reserve page]]. If you require a 2da range, please contact [http://social.bioware.com/145661/ mikemike37]

Adding a Location to the Single Player Campaign Tutorial

2010-01-14T17:36:16Z

L o B o:

This tutorial describes how to add a new visitable location to the single player world map. It is assumed that the reader is familiar with [[Creating a module]], and the [[Area tutorial]].

__TOC__

==Create your Module==

Create a new module: File -> Manage Modules... -> New...

Change the default script field to (None), as in Fig. 1. This field must be changed because running module_core has been known to cause unusual behavior in the game.

[[Image:Map-tut-no-script.png|thumb|Figure 1: Setting the module script to (None).]]

Additionally, the module should extend the single player campaign. To do this, set the “Extended Module” field to Single Player (Fig. 2).

[[Image:Map-tut-extend-single-player.png|thumb|Figure 2: Changing the extended module to “Single Player”.]]

==Create an Area==

Create a new area: File->New->Area. Give the area a meaningful tag. The tag will be how the area is referred to in the toolset. The area in this tutorial is tagged “maptutarea”. Select the appropriate layout for your area in the object inspector. (If you have created a level and exported it, this is where you would select your exported level). For the tutorial, I have used Flemeth's hut---“ost101d”. For more information about creating new areas, see the Area Tutorial.

Most of the default properties of this area are fine for our purposes. The one field that will need to be changed is “Variables.” Select the ellipses by the Variables field to bring up the list of variables for the area, and scroll down to “AREA_WORLD_MAP_ENABLED”. This variable determines whether or not it is possible to travel to the world map from this area. Since we're keeping things very basic, we won't have any doors leading to area transitions---instead, we'll just make fast travel possible from anywhere in this area. To do this, change AREA_WORLD_MAP_ENABLED's value to 1 (Fig. 3)

[[Image:Map-tut-area-wm-enabled.png|thumb|Figure 3: Enabling fast travel in the area variables list.]]

In the area itself, place a waypoint and give it a meaningful tag. This tag will be the location where the player is spawned when he or she travels to that location. I've given my waypoint the tag “start”.

==Make a Map==

Create a new map: File->New->Map. Most of the default properties of the map can be left alone. The one field to change is the Map field, under Map Selection. Select “Wide Open World” from the list of selectable maps. This provides the background image for the map.

You can skip the last step (Modify the Map File) if you change the Parent Map attribute. Just select "wide_open_world" and the job is done. This way you are saying to the game that the new locations included in this map will be added to the Single Campaign's main map.

Next, place a pin on the map wherever you wish your new location to be located. To place a pin, right-click on the map and select “insert pin”. My pin was placed near the Korcari Wilds (Fig. 4).

[[Image:Map-pin.png|thumb|Figure 4: A sample map and pin.]]

In the object inspector, name the pin the name you want displayed in the world map. Set the Area Tag field to the name of the area created in Section 2. Then, for the waypoint override field, put the tag of the starting waypoint in the area being added. The waypoint in this tutorial was tagged “start”. (See Fig. 5]).

[[Image:Pin-properties.png|thumb|Figure 5: Properties of the map pin.]]

''Note: The following needs some images''

Next, place a trail on the map from an existing pin (doesn't have to be exact, but closer is better) to your new pin. Try to use a logical jumping off place. To find pins to start with load the wide_open_world.map file from the main campaign ([[Extracting And Viewing The Main Campaign Map]]) or check out this list ([[Single Player Campaign Map Pin List]]). To create the trail, right click on the map and click "insert trail" and left click for each point in the trail. You want enough points that the trail looks good, it takes a little experimentation to get it just right. Double left click on the map when you're finished creating the trail. In the object inspector, set the properties for your new trail. Set the name to anything you want and set the start pin tag to the tag from the wide_open_world map and the end pin tag to your pin.

==Export the Module==

For each resource created, select “export without dependent resources.” The resources to export are:

• The custom area (named “maptutarea” in this tutorial)

• The custom map (named “tut_map” in this tutorial)

• Any other custom items or areas included

Then, update the module and manifest XMLs (Tools->Export->Generate Module XML and Tools->Export->Generate Manifest XML).

==Modify the Map File==

The final step in adding a new location to the single player map is modifying the exported map file. To do this, open the map file in the toolset: File->Open File. It can be found in:

Documents\BioWare\Dragon Age\AddIns\(your module name)\module\override\toolsetexport\

[[Image:Tut-map-location.png|thumb|Figure 6: Opening the map file.]]

Once this file is opened, its parent map must be set to the World Map. To do this, change the MAP_MAP_PARENT_RESREF field to “wide_open_world”. (Fig. 7)

[[Image:Change-to-wide-open-world.png|thumb|Figure 7: Editing the map file.]]

Once this final modification is made, the location should be visitable from the single player campaign, just like any official DLC.
[[category:tutorials]]