Installation & Setup

This article describes how to install the MultiPushTool in Revit and configure it for first use.

System Requirements

Revit automatically loads add-ins when a .addin file is placed in the following folder:

%APPDATA%\Autodesk\Revit\Addins\<RevitVersion>\

Example for Revit 2024:

C:\Users\<Username>\AppData\Roaming\Autodesk\Revit\Addins\2024\MultiPushTool.addin

Field	Description	Example
`Assembly`	Full path to the DLL	`K:\bimm\...\Planworks.MultiPushTool.dll`
`FullClassName`	Entry class of the add-in	`Planworks.RevitAddin.MultiPushTool.QuickAccessApplication`
`ClientId`	Unique GUID of the add-in	`{...}`
`Name`	Display name in Revit	`MultiPushTool`

Points to the central application configuration – set once by the administrator:

<add key="MainConfigurationPath" value="\\server\share\MultiPushTool.application.config" />

<add key="QuickAccessConfiguration" value="" />
<add key="AllowUserConfig" value="True" />
<add key="ShowDecimalPlaces" value="" />

Key	Function
`QuickAccessConfiguration`	Path to the central Quick Access configuration file (XML)
`AllowUserConfig`	Allows (`True`) or disables (`False`) user-created Quick Access buttons
`ShowDecimalPlaces`	Sets fixed decimal places for all users (empty = not enforced)

Important: When ShowDecimalPlaces is set, users cannot change rounding settings in the tool.

Start Revit and open a project.
The MultiPushTool appears in the Revit Ribbon under the tab "b.i.m.m Tools" in the panel "MultiPushTool".
On first launch, the license check runs. If no valid license is found, startup is aborted.
You can check the current license status at any time via Menu › Info.

Problem	Possible Cause	Solution
Ribbon tab not visible	.addin file missing or in wrong folder	Check path and Revit version of the folder
Add-in fails to load	Wrong DLL path in .addin file	Correct the `Assembly` path
License dialog appears	No valid license found	Obtain license from Planworks GmbH
Revit version error	DLL compiled for different Revit version	Use the correct build for the installed Revit version