Mods Other

Minecraft Cursor [1.20.1, 1.21.1+]

• • 3/10/25 10:47 am • 1 logs
  • 7k views • 5 today
  • save_alt 545 downloads
Game Version
Minecraft 1.20.1
Progress
100% complete
  • 15
  • 10
  • 2
fishstiz
Lvl 29 • Expert Miner
7
Replaces the boring old default system cursor with Minecraft-themed cursors.

📌 Requirements

  • Fabric/Forge/Neoforge 1.20.1 or 1.21.1+
  • When on Fabric: Fabric API

✨ Adaptive Cursor


Minecraft Cursor [1.20.1, 1.21.1+] Minecraft Mod Minecraft Cursor [1.20.1, 1.21.1+] Minecraft Mod Minecraft Cursor [1.20.1, 1.21.1+] Minecraft Mod
  • The cursor adapts to native or derived Minecraft elements and certain other actions.
  • Toggle from the Adaptive Cursor options or toggle each cursor manually.

🔧 Configure Cursors

  • Configure from Mod Menu (if installed on Fabric)
  • Configure from Options > Controls > Mouse Settings... > Cursor Settings...
  • Each cursor can be toggled on or off, with the default cursor used when disabled.



🎨 Resource Pack Support

Create your own theme with customized and animated cursor designs, and configure cursor settings with resource packs.

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

🚀 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 the Adaptive 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, Inspect Element can be toggled from the Debug 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.

1 Update Logs

Forge & Neoforge Support : by fishstiz 03/10/2025 10:47:23 amMarch 10, 2025 @ 2:47 pm UTC

  • Minecraft Cursor now supports Forge 1.20.1 & Neoforge 1.21.1+
  • Dropped support for 1.21, use 1.21.1 instead

More like this

  Have something to say?

Kai-Dusk
• 03/13/2025 5:18 pm
They/Them • Level 46 : Master Artist Dog
i honestly never expected someone do a mod for mouses but still something pretty cool. :D
1
SouthDakotaGirl
• 03/13/2025 1:53 pm
• Level 53 : Grandmaster Procrastinator Vampire
I didn't even know this was possible. This is really cool!
1

Welcome