Minecraft Cursor

Replaces the boring old default system cursor with Minecraft-themed cursors.

📌 Requirements

• Minecraft 1.20.1 or 1.21.1+
• When on Fabric: Fabric API

🔄 Adaptive Cursor

• The cursor adapts to certain actions and elements (limited to Minecraft's native elements).
• Disable all cursors except for Default in the cursor settings to disable this feature,
  • You can also toggle all non-default cursors in one click from More Cursor Options
  • You can disable adaptive cursors for certain actions and elements in More Cursor Options.

🔧 Configure Cursors

• Configure from Mod Menu (if installed on Fabric)
• Configure from Options > Controls > Mouse Settings... > Cursor Settings...
• Configure More Cursor Options from Cursor Settings > More Cursor Options...
  • Override the Scale, Offset X, and Offset Y of all cursors.
  • Disable Adaptive Cursor for certain actions and elements.
• Disabled cursors will fallback to the Default cursor unless it is also disabled.

🎨 Resource Pack Support

With the use of resource packs, you can create custom cursors, even animate them, and define the settings of each one.

Visit the Minecraft Cursor Wiki for more details: https://fishstiz.github.io/minecraft-cursor-wiki/resource-pack/getting-started

Here's just one example:

🚀 Java API

The Minecraft Cursor mod provides an API for mod developers to:

• Create new cursors.
• Map elements with cursor type functions.
  • or declare the cursor type within the element itself.
• Directly change the cursor, bypassing the element-based system.

Can be an optional dependency. See a simple implementation here.

Visit the Minecraft Cursor Wiki for more details: https://fishstiz.github.io/minecraft-cursor-wiki/java-api/introduction

🔗 Mod Compatibility

Mods that shift the sizes and positions of certain GUIs may lead to unexpected cursor switching. Adaptive cursor can be disabled on affected GUIs from More Cursor Options.

The list of registered vanilla widgets with an associated cursor are found here. More on the source code.

To check if an element is detected, the Element Inspector can be toggled from More Cursor Options. More info on how an element is detected (and how to make it detectable) on the wiki.

Fabric Only Compatibility Features

Note that some mods are unknowingly conflicting with Minecraft Cursor due to the libraries they are embedding/depending on (most notably with ImGui). These features work around that:

• When another mod sets a custom cursor through GLFW, the adaptive cursor will be disabled to let it do its thing.
• Standard system cursors from GLFW will be remapped to their Minecraft Cursor equivalents.

This is not supported by Forge and NeoForge, and even if they were, the early loading screen will break these features.

Likewise, Fabric mods that initialize GLFW early, such as some early loading screen mods, will also disable these features.

---

^{NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.}