Plugins + Scripts Mouse Control Overhaul

Custom hover selection:​

• Choosing the closest controller to mouse position in screen space using mouse location and radius which depends of fov and distance to controller.
• Scale 1.0 is about radius of rectangular controller icon of Empty or CUA Atom.
• Ignoring hidden controllers (default implementation allowing to drag and select hidden controllers).
• Ignoring default style cycle through few near controllers (using C button) because it is garbage and very strange idea in such big radius.

Custom cycle through nearest:​

• Can help if controllers are super close to each other in screen space. For example, you have few atoms at zero position.
• Controllers are count nearest when you barely can see difference in the overlapping icons (about 2 pixels on example image).
• Selected controller can be hovered if no other controllers are close enough to mouse, allowing user to select another controller in the same location.

Drag Activation Distance:​

• Default drag activates when mouse moves quite far away from previous position in one tick.
• This one checking distance from pressed position to current mouse position in screen space.

Custom Select From Scene Mode:​

• Replaced standard button callbacks with custom ones:
  • Link To Rigidbody
  • Align To Rigidbody
  • Parent Atom
  • Move Receiver Controller (AnimationPattern)
  • Force Receiver Rigidbody (CycleForce, GrabPoint, RhythmForce, SyncForce)
• If controller and it's ForceReceiver are very close, priority will be for controller, use Cycle hotkey to select ForceReceiver.
• When many controllers and ForceReceivers are close, firstly cyclic selection will be from nearest controllers, then from nearest ForceReceivers.
• When any SelectFromSceneMode is active Gizmo's handles will be hidden.
• Unfortunately can't modify PossesAndAlignHead menu button because it is calling HeadPossess, which is private.

Changeable hotkeys​

Global Axis Mode:​

• Local/Global axis mode can be toggled by ToggleAxisMode hotkey and inverted by HoldAxisMode hotkey while holding.

Handles Mode:​

• Hold:
  • You need to Hold hotkey to enable position or rotation handle, otherwise it will be disabled.
• Press:
  • You need to Press hotkey to choose which handle will be active: None, Position, Rotation.
• Toggle:
  • You need to Press hotkey to switch between Positioin and Rotation handles.

Changeable hotkeys​

Help Text:​

• Hovered controller's name is showing as help text at left of main HUD.

Mouse Cursor Text:​

• Display name of hovered atom and controller under mouse cursor.
• If displayed text moves lower than the edge of the screen, it will be displayed above mouse cursor.
• Horizontal position of text depends of mouse cursor on screen.

Small Tweaks:​

• Gizmo is deselecting if mouse on GUI.
• Dragging radius of selected controller covering full gizmo circle if RotationHandle is active, if not it is using SelectedDragScale value.
• Stop dragging if application window lost focus.
• Escape button by default cancelling current selection or closing menu if nothing selected.
• Fixed MacGruber's hack to make Empty atom's sphere renderer visible only when collision is enabled and current menu is SelectedOptions (like default one).
• Pressing right or middle mouse button on GUI disabling mouse navigation, so you will not rotate camera while doing something in menu.
• Changing GameMode to Play cancels SelectFromSceneMode.
• Selected controller is always visible to understand where is it.
• In GlobalAxisMode resetting rotation after dragging is finished.
• Do not process mouse logic (hovering, selecting, start dragging) when any modifier key is holding (control, shift, alt, windows, command, apple).
  • Allows you to use modifier+click combinations in other plugins.

Hints:​

• If you don't plan to use FreeMode (Tab button) and you are using Keybindings plugin, you can remove this button and assing Tab for ToggleAxisMode.
• For high resolution monitors you may need to increase DragActivationPixelDistance.

Knowing Issues:​

• LookAtTrigger does not work.
  • Cannot use default variables and methods.
  • I haven't seen anyone use it, so likely you will not notice it.
• I don't like how handle's grid mode works (it is just rounding all coordinates even when you moving along one axis), so i disabled it.
• Menu button PossesAndAlignHead calling method HeadPossess, which is private, so I cannot use it.
• DisableNavigationLookOnGUIPress conflicts with plugins, which changing GlobalSceneOptions.singleton.disableNavigationvariable.
  • You can disable this subplugin and reload other plugin, which changing variable to make it correct.
  • Embody plugin:
    • Exiting embody mode, sometimes causes to disable the option toggle mouse lock. (Thanks ccammell)
  • Keybindings plugin:
    • Default VAM keybindings works too

Little Issues:​

• Cursor blinking when I am trying to hide it every frame, so I don't hide it at all.
• Switching to FreeMode sometimes causes the controllers to be hidden for one frame.
• Switching ShowHiddenAtoms causes the controllers to be hidden for one frame.
• In FreeMode when you move cursor above gui, a blue circle should be visible.
• In Global Axis Mode when selected controller changed, you can see gizmo in local axis for one frame.

Mouse Control UI:​

Handles Control UI:​

Hovered Object Name Display UI:​