Skip to main content
April 2, 2026Trevor Cornell/5 min read

Automating Door Animation with Navisworks Scripter: Creating Scripts with Multiple Events and Hotspot Triggers

Master Advanced Navisworks Automation and Interactive Door Controls

Course Context

This tutorial builds on previous Navisworks Scripter lessons using the BIM361Complete.nwf model from Lesson 3. Ensure Scripter is enabled before proceeding.

Key Scripting Concepts

Multiple Events

Scripts can handle multiple trigger conditions using AND/OR logic operators for flexible automation control.

Hotspot Triggers

Invisible spherical zones that automatically execute scripts when users enter or leave the defined radius area.

Event Operators

AND requires all conditions to be true, while OR requires only one condition for script execution.

Event Operator Logic

FeatureAND OperatorOR Operator
Trigger RequirementAll conditions must be trueOne condition must be true
Door ExampleHold L key AND approach doorHold L key OR approach door
Use CaseRestrictive controlUser-friendly automation
Recommended: Use OR operator for intuitive door automation that works with either key press or proximity.

Setting Up Hotspot Events

1

Select Existing Script

Choose the leftDoorOpen script and add an On Hotspot event to modify existing functionality.

2

Configure Operator

Change the operand from AND to OR to allow either key press or proximity to trigger the door.

3

Set Sphere Parameters

Configure hotspot as sphere with 15-foot radius and set trigger condition to entering position.

4

Pick Door Position

Use the pick button to select the door and automatically populate the spatial coordinates in Navisworks.

Hotspot Configuration

The 15-foot radius creates an invisible sphere around the door. Users trigger the opening animation when entering this zone and closing animation when leaving it.

Complete Door Automation Setup

0/4
Animation Starting Position

When animation is set to start from 'Start' rather than current position, doors may open unexpectedly during testing. Adjust this setting for smoother user experience.

Advanced Section Control Techniques

Dual Key Method

Use separate scripts with S for section and A for reverse, providing independent control over section animations.

Single Key Toggle

Configure key down for section and key up for reverse using the same S key for streamlined operation.

Creating Section Animation Scripts

1

Create Section Script

Make new script called 'section' with On Key Press event using S key and Cut Front animation from start to end.

2

Create Reverse Script

Make 'section reverse' script with A key that plays Cut Front animation from end to start position.

3

Optimize for Fluidity

Set section animation to start at current position to prevent jumping back to fully visible state.

4

Configure Single Key Control

Use S key down for sectioning and S key up for reverse to create toggle functionality.

Professional Application

Section scripts are particularly valuable for clash detection workflows when you have multiple section planes for different floors or need quick roof removal for interior visualization.

Automated vs Manual Script Control

Pros
Hotspot automation provides intuitive user experience without memorizing key combinations
Section animations work from any location in the project for flexible visualization
Multiple trigger methods offer backup control options for different user preferences
Fluid animations are more visually appealing than instant disappearing objects
Cons
Hotspot triggers may activate unintentionally when navigating near doors
15-foot radius might be too large or small depending on model scale
Complex scripts require careful testing to ensure smooth operation
Users need to remember to disable Enable Scripts when editing

This lesson is a preview from our Revit MEP Certification Course Online (includes software & exam). Enroll in this course for detailed lessons, live instructor support, and project-based training.

Welcome back to our comprehensive Navisworks video series. In this installment, we'll advance your Scripter expertise by exploring multi-event script creation, with particular focus on the powerful On Hotspot event functionality. We'll continue working with the BIM361Complete.nwf model from your Lesson 3 folder, building upon the foundation we established in previous sessions.

Before proceeding, ensure Scripter is activated and navigate to the Scripter tab. Today's objective centers on enhancing our existing scripts—beginning with the leftDoorOpen script—by implementing intelligent automation that responds to user proximity and manual triggers seamlessly.

Our first enhancement involves creating an On Hotspot event that enables Scripter to automatically open doors as users approach them and close them upon departure. This proximity-based automation works in conjunction with the existing On Key Press events, creating a more intuitive and immersive navigation experience. With the leftDoorOpen script selected, access the On Hotspot function and observe that the operand defaults to "and".

Understanding operand logic is crucial for effective script behavior. The "and" setting requires both conditions to be true simultaneously for event triggering—meaning users would need to hold the L key while approaching the door. This creates unnecessary complexity. Switch the operand to "or" to enable either condition to trigger the action independently. This logical adjustment allows users to either approach the door naturally or use the manual L key override as needed.

Now let's configure the On Hotspot event parameters. The default sphere hotspot setting is optimal for our proximity detection needs. Set the trigger to activate when entering the invisible detection sphere, establishing a 15-foot radius as our starting parameter. While you might not know the exact spatial coordinates initially, Navisworks simplifies positioning through its pick function. Click the pick button and select the target door—Navisworks automatically populates the precise position coordinates. Since our animation play settings are already configured, no additional action modifications are necessary.

Testing validates our configuration's effectiveness. Select Enable Scripts and approach the door methodically. Upon entering the 15-foot detection radius, the door opens automatically—demonstrating successful proximity trigger implementation. Note that the door won't close automatically yet, as we haven't applied the On Hotspot event to the doorsClose script. You can still manually trigger door closure using the K key, though both doors may open if your animation start point is set to "Start" rather than current position.

Consistency across similar elements ensures professional implementation. Apply identical On Hotspot functionality to the rightDoorOpen script by first disabling Enable Scripts for safe editing. Navigate to rightDoorOpen, create a new On Hotspot event, change the operand to "or," and configure the sphere trigger for entering position with a 15-foot radius. While configuring, extend this automation to the doorsClose script by creating its On Hotspot event—but set this trigger to activate when leaving the position, maintaining the same location and 15-foot radius.


The complete automation cycle now functions seamlessly. Enable Scripts and test the full sequence: approaching triggers both door opening animations simultaneously, while departing the detection sphere activates the closing animation. The spherical detection zone ensures consistent behavior regardless of approach direction, creating natural user interaction patterns.

Fine-tuning animation timing enhances user experience significantly. With Enable Scripts disabled, return to the Animator tab to adjust door opening and closing duration. Reducing animation time to one second creates snappier, more responsive interactions that feel natural during navigation. Re-enable Scripts to test the improved timing—the faster response maintains immersion while providing clear visual feedback.

The beauty of this hybrid approach lies in maintaining manual override capabilities. Users can still activate doors manually using L, R, and K keys, providing flexibility for different interaction preferences and accessibility needs. This dual-mode functionality exemplifies professional BIM tool implementation.

Let's expand our scripting repertoire by creating additional automated features. With Enable Scripts disabled to prevent door interference, we'll develop scripts for the Section Front animation created in previous lessons. This demonstrates Scripter's versatility beyond door automation.

Create a new script named "section" with an On Key Press event using the S key. Configure the action as Cut Front animation, starting at start and ending at end. Professional implementation requires providing users with intuitive exit strategies, so create a complementary "section reverse" script with On Key Press event using the A key on key down. Set this action to animate Cut Front from end to start, effectively reversing the section cut.

Test this basic implementation: pressing S activates the section cut, while pressing A reverses it. However, we can achieve more elegant control by consolidating these functions under a single key. Modify the section reverse script to use on key up for the S key, while setting the section script to key down S. This creates intuitive hold-to-section functionality that feels natural to users.


For optimal fluidity, adjust the section animation to start at current position and end at end. This prevents jarring jumps when reactivating the script, ensuring smooth transitions that maintain user immersion throughout the sectioning process.

The practical applications of this functionality extend far beyond demonstration purposes. Enable Scripts and test from various project locations—the sectioning capability works universally, allowing instant building analysis from any viewpoint. Hold S to maintain the section view, release to restore the complete building visualization. This approach proves invaluable for clash detection workflows, especially when working with multiple section planes representing different floor levels.

Consider advanced applications: assign specific keys to different building elements (R for roof removal, for instance) to create rapid visualization tools that surpass simple object hiding. The animated transitions provide contextual understanding that static visibility toggles cannot match, making complex spatial relationships more comprehensible for project stakeholders.

As you explore the creative possibilities within Animator and Scripter tools, you'll discover their potential for transforming standard BIM navigation into engaging, intuitive experiences. These tools bridge the gap between technical functionality and user-friendly interaction, making complex building data more accessible to diverse project team members. The investment in mastering these capabilities pays dividends in presentation quality and collaborative effectiveness.

Key Takeaways

1Multiple events in Navisworks scripts use AND/OR operators to control trigger conditions, with OR providing more user-friendly automation
2Hotspot events create invisible spherical zones that automatically execute scripts when users enter or leave the defined radius area
3Door automation requires three scripts: leftDoorOpen, rightDoorOpen for entering hotspots, and doorsClose for leaving the trigger zone
4The pick position feature automatically populates spatial coordinates by selecting objects directly in the Navisworks interface
5Section animations can be controlled with either separate keys for independent control or single key toggle using key down/up events
6Setting animations to start from current position rather than start creates smoother, more fluid user experiences
7Section scripts are particularly useful for clash detection workflows and can be triggered from anywhere in the project
8Scripter automation makes complex visualizations more accessible than manual controls while maintaining professional presentation quality

RELATED ARTICLES