Back to mods
Custom Cursor project artwork

Modrinth · Minecraft mod

Custom Cursor

Replace your mouse cursor in Minecraft with anything you want. A diamond sword, a rainbow arrow, a heart… or your own image!

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Custom Cursor release should I use?

Updated last month
Latest stable file 1.0.0
Game version 1.8.9
Loader Forge

Custom Cursor 1.0.0 targets 1.8.9 with Forge. It must be installed on the client. Do not install it on the dedicated server. No extra mods listed for this file.

Where it goes

Is Custom Cursor required on the client, server, or both?

It must be installed on the client. Do not install it on the dedicated server.

Client Required
Dedicated server Not supported
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This file is marked client-only.

What else does Custom Cursor 1.0.0 need?

1.0.0. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Custom Cursor without breaking your instance.

Built for Custom Cursor 1.0.0. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.0.0. It targets 1.8.9 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    It must be installed on the client. Do not install it on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.0.0. It opens that exact file at the source.

About this project

What does Custom Cursor add?

Custom Cursor

Replace your mouse cursor in Minecraft with anything you want.
A diamond sword, a rainbow arrow, a heart… or your own image!


Features

  • 11 built-in pixel-art cursors:
    diamond sword, arrows (white, black, red, blue, green, gold, rainbow), crosshair and heart
  • Your own cursors: drop any PNG image into the mod's folder, click Reload, done
  • Adjustable size from 16 to 128 pixels
  • Click point of your choice: automatic, top-left or center (perfect for a crosshair)
  • Instant preview: the cursor changes as soon as you click a tile
  • Works in every menu: title screen, inventories, chests, options…

How to use

Open the cursor settings:

  • with the Cursor... button in the top-left corner of the Options menu
  • or with the K key in game (can be changed in Controls)

Adding your own cursor

  1. Click Open folder in the cursor settings
  2. Put your .png image in it (a transparent background works best)
  3. Click Reload and select your image

FAQ

My cursor disappears while I play?
That's normal: Minecraft hides the mouse while you control the camera. Your cursor shows up as soon as you open a menu or an inventory.

Does it work on servers?
Yes. The mod is client-side only: nothing to install on the server, and it changes nothing for other players.

Where are my settings saved?
In config/customcursor.json, and your images in config/customcursor/.


100% client-side. Works alongside other mods and resource packs.

Project description from Modrinth.

Pick your setup

Custom Cursor by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

35 available setups

Showing the newest 12 of 26 game versions. Older files are in the list below.

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Custom Cursor versions and loaders

9 of 9 releases match

Looking for an older file? The official Modrinth project page is in Resources.