Interface CursorProperties

The CursorProperties interface is used to describe the properties of the Editor 3D block cursor construct. The 3D block cursor can be queried to retrieve the current properties, and the same property class can be used to set the current properties of the cursor. This interface is generally used at the activation stage of the active tool to set up the color, visibility and input properties of the 3D block cursor

Hierarchy

  • CursorProperties

Properties

controlMode? fillColor? fixedModeDistance? outlineColor? projectThroughLiquid? targetMode? visible?

Properties

Optional controlMode

controlMode?: CursorControlMode

Remarks

Enum representing the cursor control mode

  • Fixed Mode locks the cursor to a position which is blocks offset from the current player position. The cursor is camera relative, so it will always appear blocks ahead of the players feet
  • Keyboard Mode puts the cursor under direct control of the API, and ignores any mouse input. The cursor can only be moved around using the moveBy method
  • KeyboardAndMouse mode puts the cursor under a shared control of onMouseMove and keyboard input. Any mouse movement events will set the cursor to the position of the mouse/world raycast. This can be modified using the moveBy method, but any subsequent mouse events will reset the position back to where the raycast intersection occurs
  • Mouse mode puts the cursor under control of mouse move events, and moveBy method will be ignored

Optional fillColor

fillColor?: RGBA

Optional fixedModeDistance

fixedModeDistance?: number

Remarks

The fixed distance from the players feet at which the cursor is attached, relative to camera direction. This is only used when [controlMode] is set to Fixed

Optional outlineColor

outlineColor?: RGBA

Remarks

A [Color] Property representing the color of the block cursor object outline

Optional projectThroughLiquid

projectThroughLiquid?: boolean

Optional targetMode

targetMode?: CursorTargetMode

Remarks

An enum representing the cursor target mode

  • Block Mode records the block position of the mouse/world raycast intersection
  • Face Mode records the block position of the block adjacent to the mouse/world raycast intersection, according to the face of the collision point of the selected block

Optional visible

visible?: boolean

Remarks

Boolean flag controlling the visibility of the 3D block cursor

Settings

Member Visibility

Theme

On This Page