Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

cursors.json — file map

Soft pointer profiles. Pick a default id, then define each look under profiles. Locale overlay: cursors_<locale>.json.

The whole file

Keys with { … } open below. Linked names jump to that section. Grey notes say what each key does. Under each section, Keys lists type, If omitted, allowed values, and a short note.

{
  "default": "default",  // active profile id
  "profiles": { … }      // named pointer looks — any ids you choose
}

Root keys

Top-level keys that are not objects.

default string
If omitted built-in / first profile
Which profile is used at start and after reset.

Learn more: default

profiles

Named pointer looks — any ids you choose.

{
  "profiles": {                        // named pointer looks — any ids you choose
    "default": {                       // any name you choose
      "kind": "image",                 // what draws the pointer
      "image": "sprites/pointer.png",  // pointer picture
      "object": "custom_cursor",       // object id
      "hotspot": [2, 2],               // click point
      "scale": 1.0,                    // size
      "modulate": "#ffffff",           // tint
      "opacity": 1.0,                  // alpha
      "shader": {}                     // pointer shader
    }
  }
}

Keys

kind enum
If omitted image
Values image · obj
image = PNG path · obj = object definition id.
image path
If omitted required for kind image
Path under the project.
object string
If omitted required for kind obj
Stem of sprites/<id>.obj.json.
hotspot array
If omitted [0,0]
[x, y] hotspot in the image.
scale number
If omitted 1.0
Scale multiplier.
modulate color
If omitted no tint
Colour multiply.
opacity number
If omitted 1.0
0–1 opacity.
shader object
If omitted none
Optional shader object — [Shared shapes](../shared-shapes.md#effects-shaders).

Learn more: profiles