Coruscnium-BetterMouseCursor icon

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.

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, HotspotX and HotspotY now belong to the cursor selected in CursorFile. 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

  • CursorFile is now a dropdown instead of a text field. The mod scans BepInEx/config/BetterMouseCursor/ for .png, .jpg and .jpeg images and lists them as options, with Default (the built-in arrow) first
  • File extensions are hidden in the list — sad.png shows up as sad
  • 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 CursorFile values 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

  • CursorSize range 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/HotspotY range 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 set CursorFile
  • 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 .cfg directly — changes apply instantly, no restart