Dungeon Siege 2 Tool Kit
Version 1.1
Installation Notes:
The The DSII Tool Kit V1.1 is available for download.
Interested in modding but don't know where to begin? Start with the DSII Toolkit companion, Siege University II. The DS2 Tool Kit V1.1 installer includes the
complete set of files that make up the tool kit; however, if you are updating from a previous release you can simply run the new installer WITHOUT uninstalling your existing tools.
If it detects an installed version, the
v1.1 installer will automatically select the current DS2TK directory
as the install target. If you have made specific changes to the tools (for example,
modifications to the maxscripts used in Siege Max) and are concerned about losing your customizations, you can elect to install
this DS2TK release to a different folder and then migrate your personalized files
by hand from the old folder to the new one.
CAUTION: The DS2TK uninstaller will automatically remove your Siege Editor 'favorites' list when it removes the Tool Kit. If you are uninstalling and want to preserve your favorites, be sure to copy your '..\My Documents\My Games\Dungeon Siege 2 Mod\Dev\Config\editor\favorites.gas' file to safe place before you run the uninstaller. Once you have re-installed the DS2TK, you can restore your favorites list by overwriting the new favorites.gas with your original.
Siege Max Changes:
Support has been added for 3ds Max versions 4.2 and 5.1 (in
addition to previously supported versions 6, 7 and 8 )
If you have any of these versions installed on your system,
the appropriate files and shortcuts will be created in the DS2TK install
directory.
Dungeon Siege 2 Mod Changes:
A ‘mood’ command has been added to the console which will
allow modders to test mood settings without having to add additional triggers.
Type “help mood” at the console prompt after loading a map for syntax info.
Fixed a bug in the code that locates the dbghelp.dll file. DS2Mod
now uses the version installed by the retail release.
Several new and revised command line options improve mod
support <see below>
configfile=<filename> default:"DungeonSiege2"
Sets the name of the configuration file used to resolve
game settings. Relying on a custom config file allows you to avoid long command
line arguments as any option allowed on the command line can be entered into
this file. Settings for different mods can be selected by specifying alternate
config files.
If the config file path is not specified, the default is "..\My
Documents\My Games\Dungeon Siege 2 Mod".
The config file extension is always ".ini".
silentstartup=[true|false] default:false
Hides the console during engine initialization.
NOTE: Initialization can take several seconds during which the screen will
remain blank!
disableconsole=[true|false] default:false
Disables the debug console display. The console is still available to skrit
routines (through the ConsoleExecute() function ) but it cannot be toggled on by the user.
nointro=[true|false] default:false
Skip initial credits movie, jumps to main menu.
noloadintro=[true|false] default:false
Skip the DS2 loading movie
breakonerror=[true|false] default:false
Enable this to halt the program and pop up an error message dialog if an error
is encountered. If this flag is false, errors are simply written to the error
log file.
treatskritwarningsaserrors=[true|false] default:false
Warning messages encountered when parsing skrit code are normally just written
to the warning log file. Enable this option to treat such warnings as errors.
NOTE: Enabling this flag will detect issues with skrit code improperly
marked as 'dev_only' in DungeonSiege2 retail tanks. These messages can safely
be ignored!
enable_template_warnings=[true|false] default:false
Display warnings encountered while parsing content db templates.
NOTE: Enabling this flag will detect issues with templates improperly marked
as 'dev_only' in DungeonSiege2 retail tanks. These messages can safely be
ignored!
skrit_debugging=[true|false] default:false
Collect additional information regarding errors detected in skrit code. This
info includes the source file, line number and virtual machine state.
skrit_retry=[true|false] default:false
When errors are detected during compilation of skrit code, a retry message will
be generated. Enabling this flag allows you to edit the skrit file and retry
the compilation without having to restart the application.
log_all=[true|false] default:false
Log all console output to the "..\My Documents\My Games\Dungeon Siege 2
Mod\Logs\log-<machinename>.log" file. By default, only error and
warning messages are logged.
pcontent_db_dump=[true|false] default:false
Dump contents of the parameterized database to tab-delimited text files suitable
for loading into Excel. These files will be placed in a 'pcontent_reports'
folder located in the DS2TK install directory (or which ever directory the game
executable is launched from, if the 'Start In' shortcut parameter is changed)
dumphelp=[true|false] default:false
Generates a 'fubi.log' file that contains a listing of the functions, classes
and enumerations exported by the game engine that are available to skrit. This
file is written to the DS2TK install directory.
NOTE: The game will exit after generating the help information!
skritbot=<string[,string]...>
List of skritbots to load and run. These specialized skrits can be used to
automate the startup of the game. See the Siege U skritbot entry at
garage.gaspowered.com for more info.
