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. Not all keys have to be present if no custom configurations are needed.

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	true, false	true	Determines whether the cursor is enabled or not.
scale optional	float	0.50 - 8.00 (incrementing by 0.05)	1.00	Specifies the Scale of the cursor.
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
    }
  }
}