1. Launch Autodesk Revit and open a project.

2. Navigate to the Add-Ins tab in the Revit ribbon and locate the Ostacolo panel. The panel contains four main buttons and a slide-out utility button.

3. Before running detection for the first time, expand the slide-out by clicking the small arrow at the bottom of the Ostacolo panel, then click File Config. Enter a Project name that groups all buildings in the same scheme (for example, "Tower Complex A") and a Building name that identifies this specific Revit model — this defaults to the document title. Click Save.

4. Click the Find Clashes button to open the clash detection setup form.

5. Select a detection protocol from the available options:

   — Structural vs MEP: detects clashes between structural framing, columns, and foundations against pipes, ducts, conduit, cable tray, and MEP equipment.

   — Architecture RC vs Structural & MEP: checks roofs, floors, and ceilings against structural and MEP elements.

   — Architecture WD vs Structural & MEP: checks windows and doors against structural and MEP elements.

   — MEP Internal: checks MEP distribution elements against each other.

   — All: runs all protocols in sequence.

6. Select the detection mode. Hard Clash detects physical intersections between element solids. Clearance detects elements that come within a specified minimum distance (enter the distance in millimetres).

7. Click Run. OSTACOLO will extract elements from the active model and all loaded Revit link instances, run geometry intersection checks, and place a Clash Sphere family instance at each detected intersection point. A summary dialog confirms the number of clashes found and how many are new.

8. Click View Clashes to open the clash dashboard. The dashboard lists all detected clashes with their ID, status, workflow, detection date, and element information.

9. Use the filter controls to narrow the list by status (Open, In Progress, Closed, Ignored), workflow, or building.

10. Click the Navigate button on any clash row to fly the active 3D view to that clash location in the model.

11. To update a clash, select it in the dashboard, change the status using the dropdown, add a description note if needed, and save.

12. To run detection again after a model update, click Find Clashes and run the same protocol. Existing clashes with assigned statuses are preserved — only new clashes are added.

13. To share clash data or sync status updates made outside Revit, click JSON Manager. Select Update JSON from Model to push current model data to the project JSON file. Select Update Model from JSON to pull status changes from an updated JSON file back into the model without overwriting detection records.

14. To review clashes across multiple buildings in the same project, click Review Clashes. This opens the cross-building Clash Reviewer, which aggregates records from all buildings sharing the same Project name set in File Config.

Notes:

• File Config must be completed on every new model before running detection. Detection results will not be stored if the project/building mapping is missing.

• Keep the Project name identical across all building models in the same scheme so the Clash Reviewer can aggregate them.

• Close Revit before running the installer when updating to a new version.

• The Clash Sphere Revit family is loaded automatically on the first detection run. No manual family loading is required.

• Running Find Clashes on a model with existing clash records does not delete those records. Only new clashes are added; existing clashes retain their current status.

The installer that ran when you downloaded this app/plug-in from the Autodesk App Store will start installing the app/plug-in. Simply double-click the downloaded installer to install the app/plugin. Make sure that Autodesk Revit is completely closed when running the installer.

To uninstall this plug-in, exit Autodesk Revit if currently running, then rerun the installer and select the "Uninstall" button. Alternatively, go to Control Panel > Programs > Programs and Features (Windows 10/11) and uninstall as you would any other application.

The Clash detection tool is a sample development to display Avant Leap's capabilities to develop cutting-edge workflows and automation for BIM project management. As we receive increasing user consumption of this tool or particular development solicitudes we'll extend and empower its capabilities.

Here is the Quick Guide: Quick Guide Clash Detection | Avant Leap

No known critical issues in this version.

Detection on very large models with many linked files may take several minutes depending on available system memory and the number of elements in the selected categories. Using a specific protocol (e.g., Structural vs MEP) rather than All will reduce run time significantly.

If you encounter any issues, please contact us at

info@avantleap.com