BetterMouseCursor

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

• Drop a PNG into BepInEx/config/BetterMouseCursor/ (created on first launch).

Square images with transparency look best (e.g. 64×64 or 256×256).

• Set CursorFile to the filename — press F10 in-game (ModSettingsMenu) or edit

the.cfg in a text editor. Absolute paths work too.

• It applies instantly. Set CursorFile back to empty for the built-in arrow.

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

cursor never breaks.

Configuration

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

| Setting | Default | Description |

|---------|---------|-------------|

| CursorFile | (empty) | PNG filename in BepInEx/config/BetterMouseCursor, or an absolute path. Empty = built-in arrow |

| CursorSize | 32 | Cursor size on screen, in pixels (8–512) |

| HotspotX | 0 | Click point X 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

• Install BepInExPack_Mycopunk
• Install ModSettingsMenu for the in-game F10 config editor
• Place BetterMouseCursor.dll in BepInEx/plugins/ (or install via r2modman)
• 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.