Resource Pack Settings

Important

The Minecraft Cursor Wiki has moved to:
https://fishstiz.github.io/minecraft-cursor-wiki/.

This page will no longer be updated.

---

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 - 3.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 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
    }
  }
}

---

Previous: Create Cursor Textures Image specifications and animations.