BetterMouseCursor
Custom cursor framework that also fixes the controller cursor flicker. Pick your cursor from a dropdown of your own PNGs, with live-configurable size and hotspot.
By Coruscnium
CHANGELOG
Changelog
1.3.1 (2026-10-23)
Changed
- Rebuilt for the 2026-10-22 Mycopunk update (Unity 6, Steam build 26120128). Game references refreshed and all Harmony/reflection targets re-verified against the new Assembly-CSharp.
- Removed the OnUnpairedDeviceUsed warp-grace patch: the game now enforces a 50 ms warp window itself (Rumble.warpedCursorTime replaced the one-frame warpedCursorFrame test).
1.3.0
- Per-cursor size and hotspot.
CursorSize,HotspotXandHotspotYnow belong to the cursor selected inCursorFile. Switch cursors and each one comes back exactly as you left it — no more re-dialling the hotspot every time you swap - A newly added image starts at the defaults (32 px, hotspot 0,0)
- Deleting an image also deletes its saved settings
- Settings are stored in
BepInEx/config/BetterMouseCursor/PerCursorSettings.ini, next to the images, so they travel with a shared cursor set. Delete a section from that file to reset one cursor to defaults - Your existing size and hotspot are kept and become the settings for whichever cursor you currently have selected
1.2.0
CursorFileis now a dropdown instead of a text field. The mod scansBepInEx/config/BetterMouseCursor/for.png,.jpgand.jpegimages and lists them as options, withDefault(the built-in arrow) first- File extensions are hidden in the list —
sad.pngshows up assad - The list updates live: add or remove images while the game is running and they appear in / disappear from the dropdown without a restart — even with the ModSettingsMenu window already open. Overwriting the selected image reloads its art immediately
- Existing
CursorFilevalues are migrated automatically to the matching dropdown entry - Absolute paths are no longer accepted — copy the image into
BepInEx/config/BetterMouseCursor/and pick it from the list instead - Requires ModSettingsMenu 2.0.3+, the first version whose dropdowns render correctly (2.0.0–2.0.2 drew them behind other rows)
1.1.0
CursorSizerange expanded to 8–512 px (custom high-resolution PNGs render pixel-crisp at large sizes; the built-in 64px arrow will look soft past ~128)HotspotX/HotspotYrange expanded to ±2048 source-image pixels — the click point can sit far outside the image for irregular cursor art
1.0.0
- Initial release
- Fixes the vanilla controller cursor flicker (the game's cursor is rendered as an OS hardware cursor and warped every frame the stick is deflected; the cursor is now drawn in-engine instead, which cannot flicker)
- Uniform cursor for mouse and controller — same art, same size, same hotspot
- Built-in clean arrow cursor, or drop your own PNG into
BepInEx/config/BetterMouseCursor/and setCursorFile - Configurable cursor size (8–128 px)
- Pixel-accurate hotspot configuration (source-image pixels, scales with cursor size)
- Smoother controller cursor: sub-pixel movement accumulation and zero-lag rendering
- Prevents warp-generated mouse events from flapping the detected input device
- Live hot-reload: edit via ModSettingsMenu (F10) or the
.cfgdirectly — changes apply instantly, no restart