Skip to content

Custom Settings

Custom settings can be defined in assets/minecraft-cursor/atlases/cursors.json.

Refer to the file structure of the resource pack.

NOTE

Custom settings are layered per resource pack.

Root
Key Type Description
settings required Map<String, Settings> Maps a cursor key to a Settings object.
Settings
Key Type Range Default Description
enabled optional boolean false only true Determines whether the cursor should be disabled.
scale optional float 0 - 8.00, incrementing in steps of 0.05 1.00

Specifies the Scale of the cursor.

To enable auto-scale, set the value to 0 or a number less than 0.50.

xhot optional int 0 - 31 0 Specifies the X Hotspot position.
yhot optional int 0 - 31 0 Specifies the Y Hotspot position.
animated optional boolean true, false, null null, or true if animation data exists Determines whether the cursor animation should be played.

Example usage:

cursors.json
json
{
  "settings": {
    "default": {
      "xhot": 7,
      "yhot": 3,
      "scale": 0.75
    },
    "pointer": {
      "xhot": 7,
      "yhot": 3,
      "scale": 0.75
    },
    "text": {
      "xhot": 12,
      "yhot": 15,
      "scale": 0.75
    },
    "grabbing": {
      "xhot": 15,
      "yhot": 3,
      "scale": 0.75
    },
    "shift": {
      "enabled": false 
    },
    "busy": {
      "animated": false
    }
  }
}

Released under the CC0-1.0 License.