🇬🇧

Documentation

Glossary

Quick Start: Install Production Assist for AutoCAD and BricsCAD#

This guide takes you from the prerequisites to a verified connection between Production Assist and AutoCAD or BricsCAD. It covers installation and the one-time technical setup only. Preparing custom blocks, symbol maps, layer mappings, and running an initial structural calculation are outside the scope of this quick start.

Last updated: October 20, 2026

Goal#

After completing this guide:

  • the Production Assist desktop app is installed and running,
  • the plugin for your CAD version is installed,
  • the plugin is loaded in AutoCAD or BricsCAD,
  • the plugin is configured to start automatically,
  • the Production Assist toolbar is visible,
  • the desktop app is connected to the running CAD application, and
  • the separately provided DWG library is installed and connected in BricsCAD.

At a glance#

PhaseAutoCADBricsCAD
Basic installationInstall the desktop app; AutoCAD 2024 can be installed through the app, and other available versions from the download packageInstall the desktop app and select the matching BRXYY plugin
Load the moduleOn Windows, load ProductionAssist.arx with APPLOAD and add it to the startup suiteLoad the BRX/MRX module with APPLOAD and enable Autoload
Set up the interfaceWith a drawing open, the tools load automatically: the Windows ribbon or the Mac menu and toolbarsThe tab loads automatically; then add ProductionAssistLibrary
Check the connectionSet the desktop app to Plugin and select Enable PA in AutoCADSet the desktop app to Plugin and select Enable PA in BricsCAD

1. Check the prerequisites#

Install all required programs first, then check their versions.

Required programs and access#

  • AutoCAD or BricsCAD is already installed.
  • The Production Assist desktop app is installed and has been started at least once.
  • You have a Production Assist user account and can sign in to the desktop app.
  • A suitable license is assigned to your account. For a shared team license, an administrator must add your account to the team.
  • An internet connection is available for automatic installation.
  • If installing to protected program folders, you have administrator rights when required.

Important: The desktop app provides the shared user interface and required resources. The CAD plugin adds integration with AutoCAD or BricsCAD. Both components are required for the complete workflow.

Find the CAD version#

Enter ABOUT in the AutoCAD or BricsCAD command line. Note the application's major version.

Each CAD major version requires its own plugin module. The identifier in the download must therefore match the installed host version:

IdentifierHost applicationPackage platforms in the current distribution
ARX24AutoCAD 2024Windows, macOS
ARX25AutoCAD 2025Windows, macOS
ARX26AutoCAD 2026Windows, macOS
BRX21BricsCAD 21Windows, macOS
BRX22BricsCAD 22Windows, macOS
BRX23BricsCAD 23Windows
BRX24BricsCAD 24Windows
BRX25BricsCAD 25Windows, macOS
BRX26BricsCAD 26Windows, macOS
BRX27BricsCAD 27Windows, macOS

Example: For AutoCAD 2025, use the ARX25 folder; for BricsCAD 26, use BRX26. Do not load a module for a different major version.

The table lists the currently intended major versions. The desktop app's installation dialog only offers versions detected on your computer for which a package is available on the server. Availability on the download page also depends on the operating system.

2. Choose an installation method#

There are two installation methods:

  1. Install through the Production Assist desktop app: Recommended because the desktop app detects installed CAD versions, downloads available packages from the server, and can check for plugin updates.
  2. Install manually from the ZIP archive: Useful for controlled rollouts or when automatic installation is unavailable. With this method, plugin updates are not checked automatically.

Close AutoCAD and BricsCAD before installing so files can be updated without conflicts. Restart the CAD application only after installation is complete.

The two CAD-specific installation commands are in the Help menu. Choose the command for your installed host application.

Desktop app Help menu with the AutoCAD and BricsCAD installation commands

Install AutoCAD 2024 through the desktop app#

The current installation dialog lists AutoCAD 2024. For AutoCAD 2025 and 2026, use the matching download package and manual installation in sections 4 and 7. The download packages include ARX24, ARX25, and ARX26 for Windows and macOS.

  1. Start the Production Assist desktop app and sign in.
  2. Open Install AutoCAD Plugin....
  3. In the installation dialog, select the version that matches your installed AutoCAD major version.
  4. Confirm the installation and wait for the success message.
  5. Close the dialog and start AutoCAD.

In the dialog, you can select only plugins whose host application was detected by the desktop app and for which a package is available on the server.

Current installation dialog showing detected AutoCAD version 2024

The dialog shows the detected AutoCAD version and downloads the matching package. Other versions are not offered as selectable targets if no host was detected or no package is available.

If you later need the location for APPLOAD, look for ProductionAssist.arx or the ARXYY folder in the local Production Assist data folder:

  • Windows: %APPDATA%\productionassist
  • macOS: ~/Library/Application Support/productionassist

The exact subfolder may depend on the desktop app version and operating system.

Install the BricsCAD plugin#

  1. Start the Production Assist desktop app and sign in.
  2. Open Install BricsCAD Plugin....
  3. In the installation dialog, select the version that matches your installed BricsCAD major version.
  4. Confirm the installation and wait for the success message.
  5. Close the dialog and start BricsCAD.

Current installation dialog showing detected BricsCAD version 26

Depending on the version, the automatically installed BricsCAD files are in these folders. YY stands for the major version:

ContentsWindowsmacOS
Plugin module%APPDATA%\productionassist\brx_plugin\BRXYY\~/Library/Application Support/productionassist/brx_plugin/BRXYY/
Component libraryDownloaded separately through Install Library to a destination folder of your choiceDownloaded separately through Install Library to a destination folder of your choice

The module filename includes the version identifier, for example:

  • libProductionAssistBRX26.brx for BricsCAD 26 on Windows,
  • libProductionAssistBRX26.mrx for BricsCAD 26 on macOS.

4. Alternative: install manually#

Use this section only if you are not installing the plugin through the desktop app.

Prepare the files#

  1. Open the Production Assist download page, select your operating system, then choose AutoCAD Plugin or BricsCAD Plugin.
  2. Select your installed CAD major version from the drop-down menu and download the offered ZIP archive. Each archive contains the plugin and support files for the selected version. The DWG library is then downloaded separately through Install Library.
  3. Extract the entire ZIP archive to a local folder. The included version folder is named, for example, ARX25 or BRX26.
  4. Do not move only the ARX, BRX, or MRX file. Keep the module and all bundled DLLs, libraries, and support files together in their intended folder structure.
  5. Note the final location. You will need it when loading the plugin.

Not recommended: Do not store the active plugin on a network drive or in a folder synchronized by Dropbox or a similar service. CAD applications load parts of native modules on demand; network and synchronization paths can therefore cause long load times or dependencies that do not load completely.

A local application folder already used for other trusted CAD extensions is suitable. In AutoCAD, you can also use a separate local folder and configure it as a trusted location.

Notes for manual installation#

  • After each update, check whether a new plugin package is available.
  • For an update, always replace the entire related plugin folder.
  • Then reload the module or restart the CAD application.
  • Configure the matching module separately for each CAD major version installed side by side.

5. Load the plugin in BricsCAD#

After copying the files, register the module in BricsCAD once.

  1. Start BricsCAD.
  2. Enter APPLOAD in the command line and press Enter.
  3. Click the plus icon on the right side of the dialog.
  4. Open the BRXYY folder for your BricsCAD version.
  5. Select the module:
    • Windows: the file with BRXYY in its name and the .brx extension,
    • macOS: the file with BRXYY in its name and the .mrx extension.
  6. Enable Autoload or AUTO for this entry. This loads the plugin automatically every time BricsCAD starts.
  7. Close the dialog.

BricsCAD APPLOAD dialog

After it loads successfully:

  • the Production Assist tab and toolbar appear at the top,
  • the command line reports the signed-in user, and
  • the command line shows the status Production Assist Ready or Ready.

Command line after the BricsCAD plugin loads successfully

Without Autoload, you must load the module again with APPLOAD after every startup.

6. Install and connect the Production Assist Library in BricsCAD#

The DWG library is provided for BricsCAD, AutoCAD, and ZWCAD. Connecting it in the BricsCAD panel is required only for BricsCAD. The library contains prepared truss, scaffolding, and chain-hoist blocks with the information Production Assist needs for calculations.

Install and check the library#

Install and check the separately provided library from the Library panel on the Production Assist tab:

  1. Click Install Library.
  2. In the dialog, select the destination folder for the library. This is a folder dialog and accepts folders only, not individual files. Use a permanent folder with write access, for example ProductionAssistLibrary under Documents.
  3. Confirm the download and installation. Production Assist downloads the latest DWG library for the app version and the release channel in use; its build number does not have to match the app's build number. Production Assist checks the files before and after installation. An internet connection is required. Older packages that include a matching library can still copy it.
  4. Use Check Library later to check the version, build, and file checksums. If the library is missing, outdated, or modified, you can download and install it again. A successfully installed, unchanged library is checked against the saved verification data without downloading it again.

Warning: If you confirm the installation or repair, the library files in the destination folder are replaced. This also applies to files customized locally. Back up your own changes elsewhere first. Selecting Cancel leaves the existing library unchanged.

The selected destination folder is saved and reused for later checks. If no destination has been saved yet, Install Library opens the folder picker automatically.

Connect the library in BricsCAD#

  1. Right-click the right sidebar to open its context menu.
  2. Under PANELS, enable the Library panel.
  3. Open the three-dot menu in the Library panel.
  4. Select Manage Library. The Settings window opens.
  5. Under Program Options → Files → Library directory path, select the ProductionAssistLibrary folder.
  6. Confirm the path.
  7. Open the three-dot menu again and select Generate thumbnails so BricsCAD creates previews for the blocks.

Set up the Production Assist Library in BricsCAD

Check: The Library panel now shows Production Assist components with previews.

7. Load the plugin and tools in AutoCAD#

With a drawing open, the AutoCAD plugin loads its tools automatically:

  1. The native plugin module provides the Production Assist commands.
  2. On Windows, productionassist.cuix provides the tab and ribbon buttons. On macOS, productionassist-menu.json provides the Production Assist menu and the Production Assist - … toolbars in Draw and Model. On macOS, the productionassist-menu.json file and its associated PNG images are required alongside ProductionAssist.bundle.

Operating system note: AutoCAD for Mac does not have the Windows ribbon. For a manual installation, also copy productionassist-menu.json and its associated PNG images beside ProductionAssist.bundle. The plugin sets up the toolbars and then requests a user interface refresh. The Production Assist menu provides the same commands.

7.1 Load the plugin module with APPLOAD#

  1. Start AutoCAD.
  2. Enter APPLOAD in the command line and press Enter.
  3. Open the ARXYY folder for your AutoCAD version.
  4. Select ProductionAssist.arx on Windows or ProductionAssist.bundle on macOS.
  5. Click Load.
  6. In the APPLOAD dialog, also add the module to the Startup Suite. This loads it automatically every time AutoCAD starts.
  7. If AutoCAD asks whether to allow the extension the first time it loads, choose the option to allow it permanently or always.

Check: The AutoCAD command line displays a Production Assist startup message and the signed-in user. Available Production Assist commands begin with the PA prefix.

Note: Do not enter only PA as a test command. PA is not itself a Production Assist command and may conflict with existing LISP routines. Use the startup message, the available PA... commands, and the loaded application's status in the APPLOAD dialog as confirmation.

7.2 Manually load the Production Assist ribbon in Windows when needed#

First open a drawing. The Production Assist tab is added automatically when the module loads. If the tab is missing even though the commands are available, check the AutoCAD command line. The plugin reports there if productionassist.cuix is missing or if no active document is available to load it. If needed, open a drawing and reload the module. The following manual steps are documented for AutoCAD on Windows. In BricsCAD, the ribbon is added directly when the module loads.

  1. Enter CUI in the AutoCAD command line.
  2. In the Customize User Interface dialog, open the Partial Customization Files area.
  3. Right-click to open the context menu and select Load Partial Customization File.
  4. Navigate to the appropriate ARXYY folder in the extracted ZIP package. Alternatively, use content\templates in the Production Assist desktop app's installation folder.
  5. Select productionassist.cuix.
  6. Click Open, then Apply and OK.

A typical path for a standard installation is:

C:\Program Files\Production Assist\content\templates\

If Production Assist was installed in a different folder, use <Production Assist installation folder>\content\templates instead.

Check: The Production Assist tab is now visible in the AutoCAD ribbon. Its buttons invoke the same commands that are available from the command line.

AutoCAD plugin on macOS#

The distribution configuration includes ProductionAssist.bundle for AutoCAD 2024, 2025, and 2026 on macOS. Load the appropriate bundle with APPLOAD and open a drawing. The plugin adds the Production Assist menu and its own toolbars in the Draw and Model areas. Press Cmd-1 to show the tool palette. In the command list for customizing a toolbar, search for PA - to find Production Assist commands and their icons.

Existing custom toolbars and commands are retained. If the PA tools are missing, check the JSON file and PNG images beside the bundle, then reload the plugin. The Windows steps for loading a CUIX file do not replace these Mac resources. The complete display and persistence after a restart still need to be checked in the running CAD application. If you have further problems, contact your CAD administrator or Production Assist Support.

8. Connect the desktop app to AutoCAD or BricsCAD#

  1. Start the Production Assist desktop app and sign in.
  2. Open the connection mode in the lower-right footer. Its initial value is App. Select the available CAD/plugin connection, such as the CAD application name or Plugin.
  3. Open or activate the desired DWG file in AutoCAD or BricsCAD.
  4. Return to the CAD application so it is in the foreground.
  5. Open the Production Assist tab, or in AutoCAD for Mac the Production Assist → Production Assist menu, and click Enable PA.

With the default Manually Enable setting, click Enable PA. With Ask at each start, respond to the prompt; Always Use activates the drawing when it opens.

Production Assist desktop app footer with the initial “App” connection mode

The connection is successful when:

  • the PAIsActive command in the CAD command line returns true for the active drawing,
  • in BricsCAD, the Enable PA button shows its active state,
  • the CAD command line reports Production Assist Ready or an equivalent ready status, and
  • the desktop app connects automatically to the running CAD instance.

The AutoCAD Loading Behavior setting determines the activation behavior for each drawing you open. The default is Manually Enable. Autoload loads the module when the program starts, but with this default it does not activate a drawing.

BricsCAD note: BricsCAD must be in the foreground for changes from the desktop app to appear. On macOS, you may also need to switch views before the real-time change is displayed.

9. Check the installation after restarting#

Run this short test before working on a real project:

  1. Close the desktop app and the CAD application.
  2. Start the Production Assist desktop app, sign in, and enable Plugin mode.
  3. Start AutoCAD or BricsCAD and open a blank DWG file.
  4. Check that the Production Assist tab is visible without running APPLOAD again.
  5. Check that the drawing is activated; with Manually Enable, click Enable PA.
  6. Check the command line for the ready message.
  7. In BricsCAD, also check that ProductionAssistLibrary is available.

If all checks pass, installation is complete.

10. Troubleshooting#

ProblemLikely causeSolution
The required CAD version is not offered in the installation dialog.The dialog does not list the version, or the host application was not detected. AutoCAD 2025/2026 and BricsCAD 27 are not currently configured there.Check the major version with ABOUT. For AutoCAD 2025/2026 or BricsCAD 27, use the matching manual download package; if a listed version is disabled, restart the desktop app after installing the host application. Also check that the package includes a module for your operating system.
Production Assist reports Version conflict detected.The loaded CAD plugin and the Production Assist user interface have different versions.Update the desktop app and reinstall the matching plugin package. The dialog shows the detected versions and paths; Open Parent Folder opens the relevant location if it is available locally.
APPLOAD reports that the module cannot be loaded.The module is for a different major version, or a bundled dependency is missing.Select the matching ARXYY or BRXYY folder and restore the complete extracted folder structure.
Loading from a network or cloud folder is very slow or unreliable.Dependencies are being loaded on demand from an unsuitable location.Move the complete plugin folder to a local drive and register the module from there again.
AutoCAD blocks the extension.The folder is not allowed as a trusted location.Allow it permanently in the security prompt or add the local plugin folder to AutoCAD's trusted locations.
The PA... commands work, but the AutoCAD tab or Mac toolbars are missing.The module is loaded, but the user interface resources are missing or could not be set up.Open a drawing and reload the module. On Windows, load productionassist.cuix as described in section 7.2 if needed. On macOS, check productionassist-menu.json and the PNG images beside the bundle, and show the tool palette with Cmd-1.
The Production Assist tab is missing in BricsCAD.The BRX or MRX module was not loaded or was not registered to start automatically.Open APPLOAD, load the module for the correct version, and enable Autoload.
The plugin is gone again after every restart.Autoload, AUTO, or the AutoCAD startup suite is not configured.Open APPLOAD and register the module to start automatically.
The desktop app does not connect.The app is not running, Plugin mode is inactive, or the CAD application is not in the foreground.Start the desktop app, sign in, enable Plugin, bring the CAD application to the foreground, and toggle Disable PA/Enable PA once.
The BricsCAD Library is empty or has no previews.The Library path is wrong, or previews have not been generated yet.Select the ProductionAssistLibrary folder and run Generate thumbnails.
A manual installation does not receive updates.Manually installed plugins are not checked automatically.Download the current package again and replace the entire plugin folder.

If the connection still fails, fully restart the CAD application and the desktop app first. Then note the exact message in the CAD command line and contact Production Assist Support.

11. Special case: portable desktop app on Windows#

With the portable desktop app, user data is in the ProductionAssist-data folder beside ProductionAssist.exe in the extracted program folder. The plugin must therefore be explicitly pointed to this directory.

Beside the loaded CAD plugin module, create a UTF-8 encoded file named productionassist-plugin.json:

{
  "appDataFolder": "D:/Programme/ProductionAssist/ProductionAssist-data"
}

Replace the example path with the full path to your actual ProductionAssist-data folder. Then restart the CAD application. For details, see Configure the plugin AppData directory.

Further documentation#