Table of Contents

Remove fixed content

Open the BiG World Setup\Config\[GAME]\Mod.ini, search for your mod and remove the trailing ,F from the value of the Type-key.

[BeregostCF]
Name=Beregost Crash Fixer (Utility) v1.8b
Type=R,S,T,E,F ; this is the fixed status-line
Type=R,S,T,E   ; this is not fixed

This way you can actually select the mods clicking in the GUI. Make sure you run the BWS before you do so, since the automatic updates at the beginning may ruin your work otherwise. (Or stay offline while starting the BWS.)

If you want to remove some parts of a fixed mod, you may also want to add a line with NotFixed=X to the mods section. This will remove the fixed flag from those components. So you want to get rid of component 3 and 10? This is your line:

NotFixed=3 10.

Another option is to edit the BiG World Setup\Config\User.ini to fit your needs after it was written. (Shortly after you selected how to handle failures during download, extraction and installation.) You can do that until the mods get installed. Use the pause-button or force the issue like described in the next block.

Here is a sniplett of the [Current]-section that you want to edit:

[Current]
...
TP=0 1
A6XPPATCH=0 1
A6CHARMPATCH=0
bg2fixpack=0 3 100 101 102 103 104 106 107 108 109 110 111 112 113 114
...

It's as easy as it looks: The keys represent the setup-names, the values are the components that will be installed.
Remove a component here and it will not be installed.
Since the current-section is worked on, the selection is also save in the [Save]-section. Make sure you edit that section if you want to reload something later. Components that you didn't select are saved under [DeSave].

Please note that you may ruin your installation. So be careful.

Skip download or extraction

Open the BiG World Setup\Config\Setup.ini. The section [Order] shows the steps that are done. Replace them with one of the listed examples, which are Order-Select/Download/Extract/Install. These will start at the beginning of the selection, download, extraction or installation.

Be sure you have made the mod-selection you want and the game-folder is ready for an installation.

I miss component X for mod Y

Open the BiG World Setup\Config\[GAME]\Select.txt. This file contains all orders to install the BWP. They are executed line after line. There are several type of lines. Annotations, commands, downloads, standard, multiple choice-, sub-components and groups.

ANN;Solve the issue with Cespy Audio

Just some text.

CMD;IF EXIST Setup-scs.exe del ".\override\*.d"

A command that is executed in the BG2-folder.

DWN;IAContent01;0;20;1111;

A download. This element will not be installed by an own WeiDU-setup. Used to download the PDFs, additional packages and so on. 0 is used as a dummy-component number. The 20 is the type of the component. Since the BWS is multi-lingual, a number is used that is assigned to the following themes/genres:

For non-BWP games, the list is a bit shorter (since there's no BG1/BG2 separation).

The last column shows if this is preselected for recommended, standard, tactic or expert-installations. In this case, the package will be pre-selected in all those versions. Don't forget the closing semicolon.

STD;scs;10;16;1111;

A standard component. First comes the name without the "setup-" and ".exe", then the components number, the type and the pre-selection.

MUC;scs;Select;16;1111;
MUC;scs;1000;16;0000;
MUC;scs;1001;16;1111;

MUC are multiple choice-selections. The component-column starts with a select-line to create a new sub-menu. Underneath are the components that are choose-able. Pay attention that only one component can be and actually is selected per default per multiple-choice.

SUB;BG2_Tweaks;3183;16;1111;
SUB;BG2_Tweaks;3183?1_a;16;0111;
SUB;BG2_Tweaks;3183?1_b;16;1000;

SUB are sub-components. The component-column starts with the component that has this subs. The next lines start with the same component, then a question-mark and the number of the question. After the underline there is the answer that is given.
So the answer 6 to the third question of component 67 would be 67?3_6.
Pay attention that only one component of each question is selected.

GRP;Start
...
GRP;Stop

Used to start and stop adding components to a group which is installed in one go. Putting this into the Select.txt by yourself is only useful if WeiDU would grab too much memory (if it installed many components in one go) or the WeiDU-code requires you to do so. Installation of SUBs is not allowed. This is used automatically if you chose to install in batch-mode to speed up the installation.

Please note that you might have to add the translation of the component to the WeiDU-XX.ini.

Add some translations

The translations are placed in the WeiDU-XX.ini. If you have an English translation, go with EN, Russian with RU and so on. A minimalistic one looks like this:

[A6XPPATCH]
@0=Correct reporting of experience (EXE patch)
@1=Remove 110% scaling of some experience (EXE patch)
Tra=0

The name of each [section] is the setups name. As you might guess, the lines beginning with the @ are translations for the mods component 0 and 1. It is the text that is displayed in the WeiDU.log. You might want to shorten very long texts so you don't have to scroll so much in the selection-screen. If you wish extended / more detailed information, add a line with an E at the beginning instead of the @. Tra contains the number that WeiDU uses for that translation.

Please note that you have to edit the Mod.ini if you did not find an existing section and added a new translation for a mod.

Note that subcomponents are not listed in the WeiDU.log but are required to install the correct component. If you install a component with subcomponents, it may result in a question like this:

Please select:
[1] 1 hour real time between the talks
[2] 45 minutes real time between the talks
[3] 30 minutes real time between the talks
[4] 15 minutes real time between the talks
[5] 1 hour 30 minutes real time between the talks

If that screen showed up after you selected to install component 0, the output for the mod would look like this:

[ACBre]
@0=Breagar: Content
@0?1_1=30 minutes real time between the talks
@0?1_2=45 minutes real time between the talks
@0?1_3=1 hour real time between the talks
@0?1_4=15 minutes real time between the talks
@0?1_5=1 hour 30 minutes real time between the talks

To sum it up, you just add ?Question_Answer to the component-number and assign some text to it.

Add or modify mods

Lets take a look at an example from the mod.ini first:

[A6XPPATCH]
Name=Experience Corrections (BG2 XP Patch) v2
Type=R,S,T,E,F
Link=http://www.shsforums.net/index.php?autocom=downloads&showfile=518
Down=http://www.shsforums.net/index.php?app=downloads&module=display&section=download&do=confirm_download&id=518
Save=A6XPPatch_v2.rar
Size=561656
Tra=EN:0,GE:1,SP:2,IT:3,FR:4,--:0

The [section]-name is the name of the setup. The name is not translated and fixed for all translations. Type lists the pre-selections that this mod will be included in or at least be selectable (remember that you read about pre-selections). Link is the URL to the homepage that will be opened when you click on the button above the description (at the bottom of the selection-screen).

Down, Save and Size (lets call it a group) are added together and are available for the main-component (everything with an own WeiDU-setup), additional files (like a bunch of replacement-files) and additional language-dependent files (like sound-files). Additional files have an ADD-prefix, language-files an XX-Add-prefix, where XX can be replace by the language-token (like IT for Italy).
Set one or all of these values to Manual if the mod is embedded in another one or does not have a homepage...
Additional archives may also have a Test-key. The following will be "OK" if the file Kiara-Zaiya\Sounds\KHappy.ogg exists. Its file-size may be of any value. If you want a specific value, you can also set that. But if the files are changed, you may end up with some false positives.

AddTest=Kiara-Zaiya\Sounds\KHappy.ogg|-

The value of the Save- and Size-keys are updated during downloads and link-checks. If fetching these values via the URL, an update of the link will be attempted.

Seldom used Ren-keys are for mods that may be renamed to its value.

NotFixed-keys are used to remove the fixed-flag from components of a fixed mod. Eg.

NotFixed=3 10

will enable the deselection of components 3 and 10.

The available translations are listed in the Tra-key. These are substantial for the BWS:
It is used to show the mods in the selection-screen or avoid installing them if the desired language-token is missing. Later during the installation, WeiDU gets the number for its language-parameter. If a mod does not contain on-screen-text, use - to link all the missing translations to the following number. In our example, Korean users will install the English one.

You might have noticed that there's still no description for the mod. This is put into the Mod-XX.ini. It was put into different files so characters would not be corrupted when editing withanother codepage.

[Description]
1pp=This mod changes the paperdolls and inventory icons of Baldur's Gate II to those of Baldur's Gate.
1pp_avatars=The better looking avatars from BG1 are used in BG2.

Keep in mind that other files than mods have an additional exception. There are two types: Files that need to be downloaded (like a PDF-file) and files that need to be fetched and extracted (like the BiG World archives). Since you don't have a setup-name as a reference, jut be creative and invent a new name. Add this name to the value of the DownloadOnly- or ExtractOnly-key in the Game.inis [Options]-section.

ExtractOnly=BWInstallpack,BWTrimpack,BWFixpack,BWTextpack,WeiDU,BeregostCF,PCSoundsets

Manage conflicts and dependencies

There is a big section in the Game.ini called [Connections]. All dependencies and conflicts are listed there. The key of each entry is the description that will be shown at the bottom of the selection-screen. The value of the keys is quite flexible but has a simple system so most settings may be covered.
An ampersand means "and".
A vertical line "or".
The colon means "depends on" or divides groups in advanced conflicts.

After the setup-name, the component number is written down in curved braces. A dash stands for the hole mod. One or more components may be divided by a vertical line.

Lets see some comments from the section and examples:

NTotSC Patch=D:NTOTSC(-)&NTOTSCv171(-)

All mods/components depend another, so the mods will not be allowed to be installed alone. Only in a bunch of all mods.

BP And D0Questpack=D:BPV179(-)&D0questpack(-):MTS_CRAPPACK(29)

Multiple mods/components need another (to coexist).
The mods X1, X2, [...Xn] need Y if installed together. Y is not needed if any of X is missing.

NTotSC Patch Dependancy=D:NTOTSCv171(-):DSOTSC(-)&NTOTSC(-)

One mod/component need multiple others.
The mod X needs Y1, Y2, [...Yn] to be installed. This does not mean that Y1 needs Y2.

TS Animation Fix=D:NeJ2v602(2):TS-BP(-)

One (or more) components need one of multiple possible components. So if any of the components on the right are installed, the dependency is solved.

Improved encounters need smarter AI=D:scs(6090|6100):scs(5040|5041|5042|5043)

One mod needs another - not vise versa.

Alter Cleric Spell Progression Table=C:TDD(-)|Divine_Remix(100):BG2_Tweaks(2280|2281)

Advanced conflict - check Splits String by ':' (lets call it area). If one of the items is selected (or all of a group if '&' is used), it's displayed as a conflict. Advantage to normal conflicts: *Mods in an area are not treated as conflicts. *Mods can have conflicts in groups. So if two combined mods have a conflict with a third one, this is the ways to go.

The mods X1, X2, [...Xn] all have a conflict with Y. X1 and X2 do not have a conflict, so they can be installed without problems.

Fix the Mirror Image spell=C:Spell_Rev(20)>ToB_Hacks(31)>SCSII(1020)>SCS(40)

One or more mod/component has conflicts with another

Special dependencies

Mods that depend on BGT, a special language-selection or a version of the game are listed in the Game.ini's [Purge]-section. These are not shown in the selection-menu if the conditions are not matched, so people don't get confused.

Patches for BWP-Textpack=D:BWTextpackP(-):RU
The Big BG1 Mods=D:DarkHorizons(-)|drizztsaga(-)|DSotSC(-)|NTotSC(-)|NTotSCv171(-)|Bonehillv275(-):BGT(-)
AB Totl needs patch 142=D:ab_totlm(-):1.4.2.0
...

In this example, BWTextpackP is only shown when installing Russian translations. The second one will remove the big BG1 mods if the BGT-mod is not going to be installed. The version-option is for IWD-only, since the mods may need IWD, HoW or TotLM. It checks the version of IWD.exe and if it's not met, the mods are removed.

Managing groups of similar mods

There are some predefined groups that are available from the menus in the selection-screen. To edit or add a new one, open Game.ini and edit the [Groups]-section.

1=CWS(-),JZ(-),SkooterTheNPC(-),tb#quest(0&1),aip(-),mdx(-),hf_HHG(-),G3Anniversary(-)

Components in curved () brackets are acting along the rule and will be added or removed like the user asked to. So if the first group is selected, CWS and JZ will be selected among the others.

6=item_rev[3&8&9],fullplate(1&102&204)

Those components in edged [] brackets are removed if those on curved brackets are installed. This is useful to avoid conflicts. So when fullplate is selected, item_rev will be deselected.

The numbers are "translated" using the Menu[2][3]-key from your Translation-XX.ini. So 1 will be Fun, 2 Unsuitable...

If you play with the groups, remember to adjust the value of this key or the BWS will not work correctly!

Suggestions if installation fails

You could try to install the mods and make sure to enable the "Install components in batches"-checkbox. This way, the mods components are installed together. Components that use sub-components are installed one by one.

If mods would use too much memory, they are added to the EndGroupInstall-key underneath the [Options]-section of the Setup.ini. The syntax is the same as for groups. Right before the component, the last group is closed, will be installed and a new group is opened. This way, WeiDU should free those used resources.

BWS/AutoIt3 goes online

The BWS will try to update the mods data when it starts a BWP install. This is done by looking for some files hosted in the internet. The BWS (which uses the AutoIt3.exe) will attempt to fetch these files from the servers and continue. No personal data is collected.

How the download works

Every time the BWS is asked to check for a link, it will fetch the file-name and the size of the file provided by this URL. This way it verifies that the download is available during the link-check (right after you started the installation) and during the download-process.

By comparing the current information to the files that may exist in the download-folder, it determines if a download is needed or if the file from the internet is the same as the local copy. If the size of the download is null, the first few bytes will be loaded to see if the file is a website or a real file. This is useful for some sites. If the size is 0 but a real file exists, the currently available data (size) will be taken as a given.

If the file does not exist, the BWS checks for a new download-location (for this one only) by looking through the link-updates. If a new one is found, it will try anew. Otherwise the download will count as failed.

These checks are made with wget,which loads the http-header of the URLs to determine the correct values. If that fails for some reason, AutoIt3s internal function to at least get the size will be used.

The download itself will be made with wget. The main reason for that is the capability of fetching and resume downloads. So if your data-line is a bit unstable or you get disconnected, the wget-utility will still try to fetch the rest of the file another 2 times. Resuming a download will also work if you did download a part of a file with the BWS and the file on the internet did not change since then. It will not work if you throw in some partial downloads that the BWS did not log itself. Those are deleted before a download is started. This is because some files are named the same even if the version has changed and we don't want to have 50 MB of version A and 40 of version B.

To speed up the download-process, the BWS uses download-queues that manage up to five downloads simultaneously. You can choose to halt and pause or stop downloads one by one or all if you like to.

After all files are downloaded, the files are compared another time to see if everything went fine. If not, the missing ones are listed with those components/mods that depend on those and will fail to install later. You can either choose to try and reload the missing mods, provide them yourself or continue without those missing mods. If substantial files are missing, you can not do that. Providing a file means either that you use a file-selector and search for the mod on your hard-disk or get the download-URL opened in your default-browser so you can try to fetch the file for yourself. If you select them, you may even force the BWS to use the file if it differs from the expected values.

Missing files and components with open dependencies will be removed from further action and added to a list of files that will be displayed after the installation is finished as a reminder (to show what's missing).

How the extraction works

All the files that are required by the mods that were selected and downloaded are processed. It is checked if the file is a package create by INNO or NSIS installers. Those are handled by passing some parameters so the install correctly. NSIS installers come with this "Do you want to install" message-box which cannot be suppressed, so to avoid annoying popups, those are put at the end of the extraction-process.

Other files are extracted by 7zip, which unpacks the files into the installation-folder. All existing files are overwritten. After that, the BWS will look for the tp2-file and the mods directory. (Or other files that should exist now if the package does not contain a WeiDU-installer.) If they are not found, potential sub-folders are searched for them. If found, the content is moved, otherwise archives that were put into the current one are unpacked afterwards.

If the check for the mod-files still fails, the package is added to the list of faulty extractions. That means NSIS-packages are add, too. If a mod has some addon-packages (e.g. for fixing or providing sound-files) and the main-package is not extracted properly, the addons will also be added to this list.

After this procedure is done with all files, the NSIS-installers are executed. They are started with a parameter so they are extracted to a sub-directory named NSIS in your installation-folder. This leaves only the message-box open, which may or may not be closed automatically. The BWS tries to do that, but it still may fail and you have to do that manually. The mods are not installed into the main-folder because the installer will open the WeiDU-installer and try to install it's mod automatically. To prevent an installation at that time - which will mess up the order in which mods should be installed - this little trick is used (WeiDU will fail to find the game and stop). The WeiDU-instance will be closed and the next package is searched. Please note that all NSIS-installers are executed - there is no check if the installer was actually from a mod you selected or maybe exists due to another reason. This is on purpose so the maintenance does not have to keep track on the package-format.

After that, the files are checked another time and the mods that were put in NSIS-installers are recognized. Special extractions like InfinityAnimations content are also done here. When some mods had errors during the extraction, the BWS removes the key-files. If it finds them later, one can assume that the user extracted them correctly.

After that missing files and mods that depend on them are reported and you can either choose to test these files, provide them yourself (by either download or extraction) or remove them all from your installation. This will not work if substantial mods are involved. If you want to extract them yourself, the files are executed and your default program for extractions will be launched.

How the installation works

All actions are listed in the BiG World Setup\Config\[GAME]\Select.txt (See the third section of this page for details) They are executed line by line. CMD-lines are always executed. Lines that install components are checked if those should be executed. If already installed, the component will be skipped. If the dependencies are met and conflicts don't exist the component will be installed. Otherwise you can select to either give it a try or skip that installation.

After WeiDU finished the installation it is checked if it was a successful one. This is done by checking the WeiDU.log and the debug-file. This way, errors and warnings can be found. Depending on the selection of the installation-logic, the installation will be paused on warnings and/or errors. You can either try to give it another try or continue.

On errors, mods that depend on the current component are listed and removed if you skip the installation. If substantial mods are not installed, skipping will be forbidden. Skipped components will be added to the list of selected but missing components. It will be displayed at the end of the installation.

To help debugging some errors, a file called BiG World Debug.7z will be created that includes a slightly stripped version of the installation-messages. It well help guys to give you better support.

Edit mods with BWS

You can edit, add or delete mods by using the built in GUI. You can access it from the selection-window by choosing options>administration>Manage Mods. Now either select one of the existing mods by the mods name or the setup, or select to create a new mod by using the options-menu again. You can also delete the current mod or access some other options.

After selecting a mod, the different fields for description, version, type, translations and so on are set. Use the arrows to the left and right to skip through description for the mod in the available languages (English, German, Russian). In the lower part of the window, you find a listview with variables, mostly download-URLs, file-names and sizes. To edit those, either double-click the item, use the context-menu or the options-menu, where you'd use the edit-submenu.

When you enter a value in the edit-mode, choose one of the available keys and assign a value, then leave the edit-mode by clicking the button to the right. The BWS will run some checks if the entered combination seems valid or not and leave the screen. Note that those values are only saved if you choose to do so from the options-menu. So if you did something wrong, you can always revert to the original state.

You can check if the entries for name, size or tests are still valid. If you do so, the BWS will look up the info from the internet or your local files.
You cannot toggle mods to be fixed, downloaded or extracted only. Mods that are renamed during the installation also have to be edited manually. If you delete mods, the connections are still left intact (since that's a bit complex), so you will have to take care of these in the other GUI-window.

There are also some hotkeys you can use:

[ALT]+[1]=Focus description-field
[ALT]+[2]=Focus listview
[ALT]+[m]=Focus mods setup-field
[ALT]+[Left]=Previous mod
[ALT]+[Right]=Next mod
[ALT]+[Up]=Previous description of this mod (English, German, Russian)
[ALT]+[Down]=Next translation of this mod (English, German, Russian)
[CTRL]+[s]=Save mod
[CTRL]+[a]=Select all listview-entries
[CTRL]+[n]=New listview-entry
[CTRL]+[x]=Delete listview-entry
[F2]=Edit listview-entry

Edit components with BWS

You might also want to use the integrated editor for components. You can access it from the selection-window by choosing options>administration>Manage components. Now select one of the existing mods by the mods name or the setup. After that, the left panel of the GUI will display the output that was read from WeiDU - if the selected mods setup is present. On the right side you can see the currently saved entries. Switch between the found translations by choosing an entry from the dropdown-menu.

Please note that the conversion from the codepage WeiDU uses to the one AutoIt3 uses may result in some "bad" translations, so strings may not always be correct. For that very reason, I also included an option to read the English version of the descriptions. This should be used for Korean, Chinese and other languages that don't display appropriate characters.

To find out if some changes were made to the mod, the components are colored. Green means that the components number has the same description in both views. Blue means that there's a difference. Entries that are only available in one view are orange. Between the panels you can also find a counter. This is colored green if all the translations match or orange if not. This should help to increase your productivity.

Use the context-menu, the options-menu or the keyboard to copy the found entries from left to right, create new, delete or edit existing entries. If you want do the later, you can also double-click the entry. The GUI is changed to an edit-view and you can enter the components number and the description. Leave the view by clicking the button to the right. Note that those values are only saved if you choose to do so from the options-menu. So if you did something wrong, you can always revert to the original state.

There are also some hotkeys you can use:

[Alt]+[Down]=Skip to next translation
[Alt]+[Up]=Skip to previous translation
[Alt]+[Left]=Skip to previous mod
[Alt]+[Right]=Skip to next mod
[Alt]+[1]=Focus left panel
[Alt]+[2]=Focus right panel
[Alt]+[m]=Focus mod-selection
[Alt]+[l]=Focus language-selection
[Ctrl]+[a]=Select all
[Ctrl]+[x]=Cut selection
[Ctrl]+[s]=Save mods components for currently selected translation
[Ctrl]+[c]=Copy selection (left to right)
[Ctrl]+[f]=Find next difference. This will scan the available translations from WeiDU (left panel) and compare them to the current ones (right).
[F2]=Edit (right panel)
[Ctrl]+[e]=Replace detected component description on left panel with stored English description.

Edit connections with BWS

To adjust the dependencies and conflicts, open the built in editor by accessing it from the selection-window by choosing Options>Administration>Manage dependencies.

You get a listview in the middle, showing the list of connections that are available. You see the short description for the issue and the conflict/dependency as a text. At the top of the screen you can search for a specific text. Using the options-menu, the context-menu, keyboard or a double-click will open the edit-view for the selected entry. On the left side, you will find the conditions that have to be met to execute the check (e.g. one or more components are installed) and the type of connection that exists (conflict, dependency).

Choose a mod or one of its components by setup, name, component-number and description. Then copy the entry over to the right listview. Note that the type of entry is determined by the radio-button and the setting you choose. Depending on that, the entry will be colored white as a basis, red as a conflict and orange as the dependency that is needed. You need to enter a name to describe the problem before you can leave the view by clicking on the save-button. There are some checks being run when trying to save to technically verify the selection. Note that those values are only saved if you choose to do so from the options-menu. So if you did something wrong, you can always revert to the original state.

The BWS will not prevent you from creating an entry that is contradictory to another entry. You still have to be aware of what you do.
Make sure you delete old/non-existent entries. If you delete mods with some connections, please check this area. If you order the BWS to do something that it cannot do, that may lead to some bogus-error-messages.

There are also some hotkeys you can use:

[Ctrl]+[f]=Focus search-bar
[Ctrl]+[s]=Save connections
[Ctrl]+[n]=New entry
[Ctrl]+[x]=Delete entry
[F2]=Edit entry

Edit sequence with BWS

After setting up the mods, the components and the connections, you still need to specify the actions you want to be performed at which time. Use the built in editor to do just that by accessing it from the selection-window by choosing options>administration>Manage sequence.

In the middle you can see a listview with all the entries that are present. Those can be annotations, download, commands, components, multiple-choice or subcomponent-entries. You will also find the components description that will be displayed depending on the translations you selected for your installation. On top are some additional information like the mods name, the theme of the component that was associated and if the entry will be included in the pre-selections, namely recommended, standard, tactic and expert. At the bottom you'll find buttons to move the entries up or down. You can also use the entries from the context- or options-menu to move the entries around.

Double-clicking an entry will open the edit-view as usual. Here you can choose what is done. You can select from a variety of drop-down-selections and there's some logic behind this to prevent the creation bogus-entries. If there are some, it will tell you what's wrong. You can create one of the following:

  • Annotation: Just some notes for you or information about why components are left out or something
  • Command: Execute a dos-command like move, copy, rd, ...
  • Download: Entries for PDF or something similar that be loaded but cannot be installed, since there's no WeiDU-setup
  • Component: A single mod-component which is not in a group and has no sub-selections.
  • Choice: Those entries are used for components that have similar entries in the mods group, like "install portrait a, b or c?" or "use class a, b or c?". Those choice-entries do have an own WeiDU-component-number. The BWS gets to know that a new selection can be done here be using the "initiate"-entry in the field where the component-numbers are listed.
  • Sub-selection: Some components use sub-selections, meaning you install one component-number and it asks you if you want to use portrait a, b or c. That can result in the same component having different "flavors". In that case you use the sub-selection-type for the component. The BWS then knows that some selections will be following and will automatically create a tree from the additional entries. You create entries for each question and each possible answer. The component-number for component 0, question 1, answer 2 would be 0?1_2.
  • Group: Start or close a group. Groups are used if some components have to be installed in one go. This is rarely used.

Again, you can choose what type of theme this component is, the pre-selections that it will be installed by, choose between the mods by name or setup and the components number or description. You can also enter conditions that have to be met to execute the entry. Those should be mainly used for commands. Components conflicts or dependencies should be edited in the connections-window. The syntax for these conditions would be something like: D:SOS(0)&ROT(0). That would translate to "execute when SOS component 0 and ROT component 0 are both installed". When you are finished, leave the edit-view by clicking the button to the right. Note that those values are only saved if you choose to do so from the options-menu. So if you did something wrong, you can always revert to the original state.

If you are looking for a specific mod, you can toggle the search-bar on and search/loop through the current entries.

There are also some hotkeys you can use:

[Ctrl]+[f]=Toggle search-bar
[Ctrl]+[s]=Save sequence
[Ctrl]+[c]=Copy entry
[Ctrl]+[n]=New entry
[Ctrl]+[v]=Paste entry
[Ctrl]+[x]=Cut entry
[F2]=Edit entry

Admin example: Add a new mod

To make things a bit more clear, lets pretend we got a new mod: BG1 Mini Quests and Encounters. So what files do we need to edit if we don't use the built-in GUI?

  • mod.ini -> Add generic information like name, download, homepage, ...
  • mod-XX.ini -> Add some description about the mod that is displayed (currently in English, German or Russian)
  • select.txt -> Add possible actions the BWS has to perform during the install (execute commands, install components, ...)
  • WeiDU-XX.ini -> Add the possible translations for each of the components
  • Game.ini -> Add dependencies, conflicts, special options

Mod.ini

Lets have a look at the mod.ini first. Here are the possible entries:

[Setup-Name]
Name=The mods name
Rev=The revision/version number
Type=The mod is part in pre-selection... (Fixed,Recommended,Standard,Tactic,Expert)
Link=The link to the homepage
Down=The direct link to the download
Save=The filename of the download
Size=The filesize of the download in bytes
Tra=Available translations, listed by token:number
Wiki=Optional name of the wiki-page on Baldursgate.eu
Test=Optional test for a file to determine correct extraction
Ren=Optional alias-name for a setup if batch has problems with the original
NotFixed=Optional components if mod is fixed

If the mod has additional download-files, you would get down-, save-, size- and possible test-entries with a prefix. But in this case, BGQE has one download-package, the setups name does not contain special characters like a exclamation mark, nor is the mod fixed. So it looks like this:

[bgqe]
Name=BG1 Mini Quests and Encounters (BGQE)
Rev=8.1
Type=R,S,T,E
Link=http://www.gibberlings3.net/bgqe/
Down=http://kerzenburg.baldurs-gate.eu/downloads.php?do=downloadlatest&id=66
Save=bgqe-8.1.zip
Size=1188048
Tra=EN:0,GE:1,SP:2,FR:3,IT:4,RU:5,PO:6
Wiki=Baldur%27s_Gate_Mini_Quests_and_Encounters

Mod-XX.ini

Next step would be adding the translation in Mod-EN.ini, Mod-GE.ini and Mod-RU.ini:

[Description]
...
bgqe=The Mod adds several mall quests. Also included is the "Slime-Quest Mini-Modifikation, so now Jasteys BG1 Mini-Quests replaces Slime-Quest v1.6.

WeiDU-XX.ini

To see some text in the selection screen, you'll need to populate the WeiDU-XX.ini. Let's have a look what components WeiDU would reveal by using its --list-languages and --list-components -switches.

~BGQE/SETUP-BGQE.TP2~ #0 #0 // Baldur's Gate Mini-Quests and Encounters Mod: 7

Now just put those into the WeiDU-XX.ini. The Tra-entry is more or less a copy from the mod.ini. Repeat the step for each of the available translations.

[BGQE]
@0=Baldur's Gate Mini-Quests and Encounters Mod
Tra=0

Select.txt

To see some entries in the selection-view of the BWS. we still need to populate the select.txt. The syntax would be:

type of line;setups name;component number;corresponding number for the components theme;install with pre-selections (Recommended,Standard,Tactic,Expert);[optional dependency: if a component could be installed in two places depending on the selection, run a check if it should be installed "now".]
STD;bgqe;0;03;1111;

This is a standard component, thus STD. BGQE is the setups name. The only available component number is 0. The theme number 03 tells us the components theme would be "BG1 Quest Mods". As you can see, we install this component with all pre-selections.

Game.ini

If the mod does not depend on or conflict with others, you don't have to edit this file. Since the BGQE mod should not be displayed when BGT is not installed (if BG1 is not available), you have to put the mod in the [Purge]-section, too. That way, the mod will be purged if the dependency BGT is not meet. You usually just add the mod to existing lines if you know about that BGT-dependency. The option in the [connections]-section will ask you to install BGQE if you enabled NSCPortraits component 300 (and BGQE is not enabled yet).

[Purge]
...
BG1 Quest Mods=D:AC_QUEST(-)|bgqe(-)|bg1ub(-)|JA#BGT_AdvPack(-)|SirinesCall(-)|NMT(-)|TGC1E(-)|SOA(-)|Vault(-):BGT(-)
[Connections]
...
Alternate Portraits for 'BG1 Mini-Quests and Encounters'=D:NSCPortraits(300):bgqe(-)
Some mods would make a good examples for other situations:
[Textmusic] for multiple language-downloads in mod.ini
[TGC1E] for multiple choice in select.txt
[ACBRE] for subcomponents in select.txt and weidu-XX.ini