Dungeon Siege 2: Mod ReadMe
___________________________
Mod Title: my_quest_example_world -- download link -- https://www.siegetheday.org/files/MyQuestExampleWorld-1.zip
Author(s): Sharkull
Mod Version Number......................: 1.0 Beta
Release Date............................: Jul.10,`07
Mod Size (approx.)......................: 0.02 MB
Contact Information (email / forum...)..: I can be reached through the forums at https://www.siegetheday.org
Web Site (for the mod / author...)......: -
Revision History:
1.0 - Initial beta release
This map + mod file is intended to be a resource for modders, as an aid in understanding how to create a quest within a custom map. Players will be disappointed as the map is tiny, with one NPC, one Quest and one braken defender.
The quest has two ways to start, either by accepting the quest from an NPC, or by walking through a bounding box trigger. The quest's goal is to kill a braken defender... Once that's taken care of, the quest is completed by telling the NPC what you've done.
Quick Installation Instructions:
1. Install the components of the DS2TK that you want to use (SE2 for mapping, DS2Mod for playing...). Remember to make sure that your DS2 Resources directory has only GPG's tanks (logic, movies1, movies2, objects, sound1, sound2, terrain and voices.ds2res).
2. Copy the file MyQuestExampleWorld.ds2map into \My Documents\My Games\Dungeon Siege 2 Mod\Maps\
3. Copy the file MyQuestExampleWorld.ds2mod into \My Documents\My Games\Dungeon Siege 2 Mod\Mods\
4. If you want to work with the contents of these files (using SE2 or DS2Mod), use Tank Viewer 2 to untank these two files into: \My Documents\My Games\Dungeon Siege 2 Mod\Bits\
5. Play test using the DS2Mod exe.
Quick Uninstall Instructions:
1. Delete the file: MyQuestExampleWorld.ds2mod
2. Delete the file: MyQuestExampleWorld.ds2map
********************************************************************************
* Requirements / Compatibility
Dungeon Siege 2 Version.........................: 2.2
Other requirements (other mods, expansion...)...: Intended to be used with DS2Mod / DS2TK (v1.1+).
Windows only (uses ds2dll or custom installer)..: No
Language .......................................: -
Known Bugs......................................: None
********************************************************************************
* Mod Details
Single Player only mod..........................: No
Multi-Player only mod...........................: No
New / Modified Difficulty Settings..............: No
New / Modified Graphics.........................: No
New / Modified Sounds / Music...................: No
New / Modified Weapons..........................: No
New / Modified Armor............................: No
New / Modified Spells...........................: No
New / Modified Misc. Items (Rings, Amulets...)..: No
New / Modified Character(s) / Pets..............: No
New / Modified Enemy Type(s)....................: No
Modified Experience / Attribute System..........: No
Modified Loot Drops.............................: No
Modified GUI....................................: No
Modified / Custom Map...........................: Yes
Modified Other..................................: -
Modding Tools Used..............................: DS2TK v1.1, Notepad
Modified files :
(example - logic\world\contentdb\pcontent.gas)
No files were *modified*... All content I created was put into new files, and I created a new actor template instead of modifying existing ones.
-
********************************************************************************
* Credits
Some content provided by........................: -
Modding advice received from....................: -
Tested by.......................................: -
Other Credits...................................: -
********************************************************************************
* Distribution
This mod may be freely distributed, as long as this readme file and all related content is included.
********************************************************************************
* Permissions (pertains to non-profit usage only):
_Yes_ Permission is given to re-use this mod's content without restrictions. (Open source)
_____ Permission is given to re-use this mod's content, as long as credit is given to the original content author(s). (Open source)
_____ Contact the author(s) for permission before re-using any content included in this mod. (Open source)
_____ A separate licence is included with this mod, and all permissions are described there in detail.
_____ No permission to re-use this mod's content is given by the author(s). (Not open source)
********************************************************************************
* Copyright:
All title and intellectual property rights to the content of this mod are the property of the respective content owner and may be protected by applicable copyright or other intellectual property laws and treaties.
(c) 2002-2005 Gas Powered Games Corp. All rights reserved. Gas Powered Games, the GPG logo, and Dungeon Siege are the exclusive trademarks of Gas Powered Games Corp.
********************************************************************************
* Disclaimer:
The author(s) of this mod accepts no responsibility for damage to data, or physical damage to hardware, caused by the appropriate or inappropriate use of this mod. Use this mod at your own risk.
********************************************************************************
* Further Details / Instructions:
This map + mod file is intended to be a resource for modders, as an aid in understanding how to create a quest within a custom map. Players will be disappointed as the map is tiny, with one NPC, one Quest and one braken defender.
The quest has two ways to start, either by accepting the quest from an NPC, or by walking through a bounding box trigger. The quest's goal is to kill a braken defender... Once that's taken care of, the quest is completed by telling the NPC what you've done.
Features:
* One tiny field... boring scenery (it was never meant to be a playable / adventure map).
* A functioning multi-task example "quest".
* An NPC to (possibly) initiate and complete the quest.
* A working mini-map so the included mini-map quest icons could be seen.
* Flexible camera angles.
* The braken defender has a trigger in its instance template, setting off a flick when it is killed. GPG uses another method for their monster death initiated quest stuff, but I like this way better (more flexible and easier to read).
********************************************************************************
* Files within MyQuestExampleWorld.ds2mod, and what each contains:
\world\contentdb\templates\actors\good\npc\my_quest_example_world_actors.gas
[t:template,n:my_quest_example_world_actor1] - Old Zeke, the quest giver. If looking for the flick / conversation linking I did that in the instance template (actors.gas in the map tank).
\world\global\flick\sequences\my_quest_example_world\zeke_talk.flick
[zeke_talk_flick]
- Contains all the conversation and quest logic applicable to the NCP's conversations...
\world\global\flick\sequences\my_quest_example_world\my_quest_example_world_quest.flick
[pq1_activate_act1]
Initiated by a bounding box trigger, this flick activates the first act (not sure if this is necessary...).
[pq1_walk_past_trigger]
Initiated by another bounding box trigger, this flick has some tricky logic for quest advancement (after checking on quest progress / completion status). If the player accepted the NPC's quest, a new task is added, otherwise the quest is activated and a different new task is added.
[pq1_beast_killed]
Initiated by killing the braken defender, this flick completes previous tasks and gives the quest's final task.
********************************************************************************
* Some key files within MyQuestExampleWorld.ds2map, and what each contains:
\world\maps\my_quest_example_world\info\questbook_info.gas
[questbook_info]
- Act / quest structure for the map. I made one Primary Quest with four tasks (two of which are conditional on player activity).
\world\maps\my_quest_example_world\regions\region1\conversations\conversations.gas
[zeke_give_quest]
- This is the conversation tree for when the player doesn't have the quest yet... player can accept or decline the quest.
[zeke_quest_urge]
- In the quest is active, but the beast hasn't been killed, this conversation is used as a filler (nothing being done here).
[zeke_quest_being_finished]
- When the beast has been killed, this is how you tell the NPC of your feat in order to complete the quest.
[zeke_quest_already_complete]
- Talk to the NPC after the quest is completed and you get this one... just filler - no substance.
********************************************************************************
********************************************************************************
