User Tools

Site Tools


snowberry:managing_addons

cleanup update

This article explains how addons are managed by Snowberry, and how you can create new addons to be used with Snowberry.

In this document, the term “addon” refers to all resource packs, custom maps, effect definitions, and other such files that can be loaded by Doomsday. Snowberry treats all of these files as optional addon components.

Browsing and selecting addons

Addons that are used with selected profile can be browsed by selecting Addons tab, where installed addons are listed in a tree hierarchy grouped by their category (Graphics, Sound etc.), shown as number 1 in picture 4.1. Tree shows only addons that are compatible with the selected profile. When Defaults profile is selected, all installed addons are shown. You can select the addons that you want to use with the current profile, by checking the box next to each addon. The Help Panel shows the readme text of selected addon. If you don't want to use some addon anymore with some profile, you just uncheck the box.

Via context menu you are able to check and uncheck all addons in a certain category. You also have options to expand and collapse the categories in the tree.

Default addons

When Defaults profile is selected and you are in Addons tab, you can select common addons for all profiles. Those addons are used as default addons when starting a new game with any profile. Default addons are shown as individual branches in tree view of other profiles.

Configuring an addon

Addons are configured by selecting Settings button, shown as number 3 in picture 4.1. If selected addon has no settings at all, Settings button is disabled.

  • After clicking the Settings button, you are shown the settings view, which shows the settings related to selected addon.
  • In settings view you can change and configure the settings of selected addon in the same way as all other settings are configured.
  • You can go back to view addons by selecting Addons tab.

Specifying the addon load order

When a new game is started, addons are loaded in a specific order. This load order can be configured by selecting Load Order button, shown as number 4 in picture 4.1 or selecting Load Order via the context menu. Load Order button opens a modal dialog, picture 4.2, where the addons checked in are listed in the order they will be loaded when a game is started. First you must select an addon. Now you can change priority of an addon by moving it up or down, or to first or last with the four buttons. You can reset the load order by selecting Reset button. After making the changes, you can save them by selecting OK or return to Addons view without saving changes by selecting Cancel.

Installing and uninstalling addons

New addons can be installed and uninstalled by Addon management buttons shown as number 2 in picture 4.1. You can install a new addon by selecting [+] button or selecting Install New… via the context menu. Those open a modal dialog that shows files with extensions: .addon, .pk3, .wad, .ded, .deh, .box. This dialog is presented in picture 4.3. Within the dialog you must first locate the addons you want to install. By pressing Uninstalled button you get a list of the uninstalled addons located in folder <HOME>\uninstalled\. Now select the ones you want and start the installation by selecting OK, or return with Cancel. The addon can be a file or a directory. The addon is then copied to the user's addons/ folder and is shown unselected in tree view of Addons.

Addons can be also uninstalled. You can uninstall an addon by first selecting and addon in tree view, then selecting [–] button or selecting Uninstall via the context menu. After that you are shown a dialog that asks your confirmation for the uninstallation. An uninstalled addon is not shown in tree view after uninstallation.

NOTE: Uninstalled addons are moved to your personal uninstalled_addons_folder.

See also

snowberry/managing_addons.txt · Last modified: 2008-06-22 22:33 (external edit)