Skip to content

CURSOR Category

Nodes for controlling the mouse cursor and capturing its movement for cameras or characters.

Available Nodes

Node Type Description
Set Cursor Visible Action Shows, hides, or toggles cursor visibility
Center Cursor Action Moves the cursor to the screen center
Capture Mouse Action Captures mouse movement each frame (for mouselook)
Get Mouse Delta Data Returns the X or Y delta from a mouse capture
Get Cursor Pos Data Returns the current cursor position
Is Cursor Visible Data Returns whether the cursor is visible
Cursor Over Branch Detects whether the cursor is over a 3D object
Set Mouse Visible Action Alias of Set Cursor Visible (mouse_nodes module)
Set Mouse Position Action Moves the cursor to a specific position

Mouse Capture Pattern

For mouselook, Capture Mouse computes the per-frame delta and stores it in object attributes. Then Get Mouse Delta retrieves those values to apply to camera or character rotation.

[On Update] → [Capture Mouse: Capture ID="cam", Sensitivity=0.3]
[On Update] → [BTCustomTask:
                   dx = {Get Mouse Delta: Capture ID="cam", Axis=X}
                   dy = {Get Mouse Delta: Capture ID="cam", Axis=Y}
                   self.own.applyRotation([0, 0, -dx], False)]