Knowledgebase
How to install DesignBuilder plugins
Posted by Andy Tindale on 08-Aug-23 04:06 PM

Many DesignBuilder plugins consist of a single dll file but more complex plugins may also include other support files. The file(s) should be installed in a special location on the disk where DesignBuilder can find them. This article explains how to do that.

The easiest way to navigate to this folder is from DesignBuilder using steps 1-3 in the detailed steps below.

Follow these steps:

1. Click on the DesignBuilder "File > Folders > Library" data folder menu option
2. In Windows File Explorer go up a level to the "DesignBuilder" folder and you should find the "User Plugins" folder listed there.

Alternatively instead of steps 1 - 2, you can navigate to your local application data folder in Windows File Explorer. Usually, this can be found at C:\Users\<username>\AppData\Local\DesignBuilder, where “<username>” is your user name. The AppData directory may be hidden in which case you’ll have to enable the display of hidden files, folders, and drives in Windows File Explorer. To do that click on the  "View > Show > Hidden items" menu option.

3. Navigate to the "User Plugins" folder. If there is no folder called “User Plugins”, create one.
4. Create a new sub-folder under "User Plugins" using a name that describes the plugin.
5. Copy the plugin dll plus and any external assemblies or other support files that your plugin replies upon to the sub-folder you created. E.g. EPNet.dll might also need to be copied to the folder if the plugin uses it.

Note: Each plugin dll (and any support files required) should be placed into its own sub-folder under the “DesignBuilder/User Plugins” folder (the name of the sub-folder does not matter).