Troubleshooting
Use the current selection, status and saved data to diagnose a failed action.
I cannot move the door
Load only the moving assembly. A saved mechanism starts idle. Open Motion and click Edit to show its handles. Drag these controls to move the blue ghost while the original stays closed. Run Preview motion and Apply to save the behavior.
Apply asks for a preview
Run Preview motion and wait for completion. A changed field or geometry, cancellation, Undo or Redo or a saved-config conflict invalidates review. An unchanged saved mechanism has nothing to apply.
A frame moves with the leaf
The frame is inside the moving selection. Cancel, select only the movable assembly and author it again. Separate a combined mesh outside this plugin.
No prompt or no opening
Check Direct interaction, reach, the anchor position and line of sight. Confirm the assembly is in Workspace, anchored, and has a valid config. Check the key Tool on the server. Inspect Studio Output for VoidInteract warnings. Other scripts may conflict.
Runtime code differs
The plugin found local source edits and refuses to replace them. Back up the place, compare the runtime with the supplied readable source and reconcile deliberately. Do not discard custom code merely to silence the warning.
The door keeps reopening
Read the reported blocker and inspect the full moving path, including trim, handles and frame clearance. A blocked opening stops. If it moved partway, Close returns it from that position. Retry open appears only when it could not move at all. A blocked close requests reopening, which can also stop if obstructed. Adjust the geometry or opening path so walls and players have clearance.
Something stays in the middle
An opening stopped by an obstacle offers Close if it moved partway, or Retry open if it never moved. Close returns from its stopped position. Optional Auto-resume continues only after sampled clearance and valid access. See blocked opening.
The wrong nearby prompt activates
Check the highlighted focused target and action before activating. Object names are hidden by default. Enable them in Place prompt appearance & input if helpful. One target receives keyboard/controller focus, while Touch has separate tap targets. Direct front/back and linked prompts share mechanism state. Reposition anchors or reduce reach if an approach is ambiguous.
The ghost belongs to my previous selection
Selecting another object, clearing selection or mixing unrelated objects pauses the loaded mechanism, removes its ghost and handles, and disables editing and Apply. Its draft is kept. Choose Load selection to switch, or select the loaded assembly again to resume it. Cancel explicitly discards that loaded draft. Linking a selected button and managing assembly membership remain deliberate separate-selection actions.
The plugin panel is too short
Enlarge or undock the panel using Studio’s dock controls. Aim for at least 340 × 460 pixels. If the panel is too short, an expansion notice appears and your draft is kept.
Door pivots from the wrong side
Moving the hinge and reversing the angle are different operations. Use Other hinge side for the wrong pivot edge, or Reverse opening for the wrong swing direction. Then Preview motion and Apply. See the illustrated hinge-side guide.