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

{
  "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
    }
  }
}