You are viewing a potentially older version of this package. View all versions.
Coruscnium-BetterMouseCursor-1.3.1 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.

Date uploaded 3 weeks ago
Version 1.3.1
Download link Coruscnium-BetterMouseCursor-1.3.1.zip
Downloads 135
Dependency string Coruscnium-BetterMouseCursor-1.3.1

This mod requires the following mods to function

BepInEx-BepInExPack_Mycopunk-5.4.2403 icon
BepInEx-BepInExPack_Mycopunk

BepInEx pack for Mycopunk. Preconfigured and ready to use.

Preferred version: 5.4.2403
Sparroh-ModSettingsMenu-2.1.1 icon
Sparroh-ModSettingsMenu

In-game mod config editor plus click-and-drag HUD reposition mode for compatible mods.

Preferred version: 2.1.1

README

BetterMouseCursor

A custom cursor framework for Mycopunk that also fixes the controller cursor flicker.

Replaces the game's cursor with a clean, uniform cursor for both mouse and controller — the built-in arrow by default, or any PNG you provide. Size and click-point (hotspot) are fully configurable and hot-reload in-game.

The Flicker Fix

Vanilla Mycopunk flickers the cursor when you move it with a controller stick. The game's cursor is custom art, but under the hood it's rendered as an OS hardware cursor — and driving it with a stick means warping that hardware cursor every single frame. Re-drawing a hardware cursor mid-warp, every frame, is something the OS never guarantees will look smooth; the result is flicker that no game-logic fix can touch (the game's internal state is perfectly clean while it happens — verified frame by frame).

This mod draws the cursor in-engine instead (the hardware cursor is hidden entirely), so it renders in the same frame as the rest of the UI and cannot flicker. Cursor movement, clicking, and menu navigation are untouched — the game's own pointer logic still runs.

Bonus smoothness fixes for controller:

  • Sub-pixel movement is accumulated across frames instead of being truncated by the OS every frame — slow, precise stick movement no longer stutters or loses speed
  • The drawn cursor tracks the pointer with zero frame lag
  • Warp-generated mouse events no longer flap the detected input device mid-stick

Custom Cursors

  1. Drop an image into BepInEx/config/BetterMouseCursor/ (created on first launch). PNG and JPG are supported; square images with transparency look best (e.g. 64×64 or 256×256).
  2. Press F10 in-game (ModSettingsMenu) and pick it from the CursorFile dropdown — every image in that folder is listed, with the file extension hidden, so sad.png shows up as sad. Default is the built-in arrow.
  3. It applies instantly.

The list is live: add or delete images while the game is running and the dropdown updates on the spot, no restart. Overwriting the image you're using reloads it immediately too — handy while you're drawing one.

Invalid or missing files log a warning and fall back to the built-in arrow — your cursor never breaks.

Per-Cursor Settings

CursorSize, HotspotX and HotspotY apply to the cursor you currently have selected. Each cursor remembers its own, so a 256px crosshair and a 32px arrow can live side by side and you can swap between them freely — no re-dialling the hotspot every time.

  • A newly added image starts at the defaults (32 px, hotspot 0,0)
  • Deleting an image deletes its saved settings too
  • Everything lives in BepInEx/config/BetterMouseCursor/PerCursorSettings.ini, next to the images, so settings travel with a shared cursor set. Delete a section from that file to reset that one cursor

Configuration

BepInEx/config/coruscnium.bettermousecursor.cfg — all settings apply live:

Setting Default Description
CursorFile Default Dropdown of the images in BepInEx/config/BetterMouseCursor/ (.png/.jpg, extension hidden). Default = built-in arrow
CursorSize 32 Size on screen in pixels (8–512), for the selected cursor
HotspotX 0 Click point X for the selected cursor, in source-image pixels from the image's top-left (−2048 to 2048 — values outside the image are fine for irregular art). For a centered crosshair in a 256px image, use 128
HotspotY 0 Click point Y, same convention. Scales with CursorSize automatically

Installation

  1. Install BepInExPack_Mycopunk
  2. Install ModSettingsMenu for the in-game F10 config editor
  3. Place BetterMouseCursor.dll in BepInEx/plugins/ (or install via r2modman)
  4. Launch the game

Client-side only — safe in multiplayer lobbies.

Credits

  • Built-in arrow: Vimix Cursors by vinceliuice, licensed under GPL v3
  • Sparroh — ModSettingsMenu, which powers the in-game config UI

License

This mod (and the bundled cursor art) is licensed under GPL v3 — see LICENSE.

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